> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.drimify.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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].