Passagem de Informação do Utilizador através de Parâmetros URL
As experiências Drimify agora permitem pré-preencher a informação do utilizador diretamente através da URL usando parâmetros de query string. Isto proporciona uma experiência mais personalizada e simplifica a recolha de dados.
✅ Parâmetros de URL Suportados
Pode passar as seguintes variáveis opcionais na URL:
Parâmetro | Descrição | Valor Exemplo |
|---|---|---|
| nome | João ou codificado em base64 ( |
| apelido | apelido ou codificado em base64 ( |
| endereço de e-mail | Texto simples ou codificado em base64 ( |
| número de telefone | Texto simples ou codificado em base64 ( |
🔗 Exemplos de URLs
Valores codificados em Base64:
https://apps.drimify.com/your-experience-id/?session_uid=ABC123&fname=Sm9v&lname=RG9l&email=am9vLmRvZUBleGFtcGxlLmNvbQ==&phone=KzMzMTAxMDEwMTAx
Valores em texto simples:
https://apps.drimify.com/your-experience-id/?session_uid=ABC123&fname=Joao&lname=Doe&email=joao.doe@example.com&phone=%2033101010101
🔒 Lógica de Codificação e Descodificação
- Pode passar os valores como texto simples ou como cadeias codificadas em Base64.
- O Drimify irá detetar automaticamente valores codificados em Base64 e descodificá-los.
- Seja em Base64 ou texto simples, todos os valores são também descodificados de URL do nosso lado para garantir que personagens especiais como espaços (
%20),@, ou=são corretamente interpretados.
⚠️ Importante para Integrações
Por favor, assegure-se que:
- Se enviar texto simples, este deve ser codificado em URL antes de ser adicionado à URL.
- Se enviar Base64, tem de:
- Primeiro codificar em URL o valor original (e.g. João Doe → Joao%20Doe)
- Depois codificar em Base64 esse resultado (Joao%20Doe → Sm9vJTIwRG9l)
- Passá-lo na query string
- Ao passar valores através de parâmetros de URL, as cadeias codificadas em base64 devem incluir o padding correto (
=). Sem o padding correto, o sistema pode não descodificar o valor corretamente, e será tratado como texto simples.
Porquê?
Isto assegura que os caracteres especiais são preservados corretamente e descodificados adequadamente em todos os casos.
✉️ Validação de E-mail
Para segurança e integridade de dados:
- O parâmetro
emailsó será utilizado se passar a validação de formato de e-mail padrão. - Se o valor não corresponder a um formato válido, será ignorado e não será armazenado.
📞 Validação do Número de Telefone
Para segurança e integridade de dados:
- O número de telefone deve ser fornecido no formato internacional correto, por exemplo: +33101010101.
- O valor só será usado se corresponder a um formato válido conforme o código do país.
- Se o número não respeitar a estrutura obrigatória, será ignorado e não será armazenado.
💡 Casos de Uso
- Assim como suportamos
session_uidpara identificar uma sessão de utilizador, agora suportamosfname,lname, eemailpara pré-preencher dados do utilizador e evitar a exibição de um formulário de recolha de dados. - Isto é ideal ao lançar experiências de campanhas de e-mail ou ferramentas de CRM, onde a informação do participante já é conhecida.
- Rastrear sessões individuais de utilizadores com menos fricção
- Proporcionar uma experiência de utilizador contínua e personalizada
❓Precisa de Ajuda?
Se não tem a certeza de como codificar valores corretamente ou deseja obter orientação na integração com a sua plataforma, sinta-se à vontade para [contactar a nossa equipa de suporte] ou consultar o nosso [guia de integração para desenvolvedores].
Actualizado em: 12/12/2025
Obrigado!
