Artigos sobre: Programadores e API
Este artigo também está disponível em:

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

fname

nome

João ou codificado em base64 (Sm9v)

lname

apelido

apelido ou codificado em base64 (RG9l)

email

endereço de e-mail

Texto simples ou codificado em base64 (am9vLmRvZUBleGFtcGxlLmNvbQ==)

phone

número de telefone

Texto simples ou codificado em base64 (KzMzMTAxMDEwMTAx)


🔗 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:


  1. Primeiro codificar em URL o valor original (e.g. João Doe → Joao%20Doe)
  2. Depois codificar em Base64 esse resultado (Joao%20Doe → Sm9vJTIwRG9l)
  3. Passá-lo na query string
  4. 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 email só 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_uid para identificar uma sessão de utilizador, agora suportamos fname, lname, e email para 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

Esse artigo foi útil?

Partilhe o seu feedback

Cancelar

Obrigado!