> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/topicos/geral/contatos/leads-duvidas-comum/contatos-testador-de-token.md).

# Contatos - Testador de Token

O **Testador de Tokens** é uma ferramenta disponível dentro do **Contato** que permite validar o funcionamento das variáveis (tokens de conversão) antes de utilizá-las em mensagens, e-mails, documentos e automações.

A ferramenta substitui os tokens pelos valores reais cadastrados no sistema, permitindo conferir exatamente como o conteúdo será apresentado ao destinatário.

{% embed url="<https://youtu.be/mjbbS2jtqds>" %}

***

### Acessando o Testador de Tokens

Para utilizar a ferramenta:

1. Acesse o cadastro de um **Contato**.
2. Abra a opção **Testador de Tokens**.
3. Selecione a entidade que deseja utilizar como referência para o teste.
4. Informe o texto contendo os tokens de conversão.
5. Clique em **Testar**.

O sistema exibirá o resultado com todas as variáveis substituídas pelos respectivos valores.

### Entidades disponíveis

Além das informações do próprio **Contato**, é possível vincular o teste às seguintes entidades:

* Contato
* Fatura
* Proposta
* Recorrência
* Parcelamento
* Nota Fiscal
* Oportunidade

Ao selecionar uma dessas entidades, os tokens correspondentes serão preenchidos com as informações do registro vinculado ao contato.

***

### Exemplo

#### Texto informado

```
Olá {contactfield=firstname}!

Sua proposta nº {proposal=id} foi aprovada.

O valor da fatura é de {Fatura.Valor}.

Obrigado pelo contato!
```

#### Resultado

```
Olá João Silva!

Sua proposta nº 10235 foi aprovada.

O valor da fatura é de R$ 1.250,00.

Obrigado pelo contato!
```

***

### Quando utilizar

O Testador de Tokens é recomendado para validar conteúdos antes da utilização em:

* Mensagens de WhatsApp;
* E-mails;
* Documentos;
* Fluxos de automação;
* Campanhas;
* Notificações automáticas.

Dessa forma, é possível identificar possíveis inconsistências antes que a comunicação seja enviada ao cliente.

***

### Boas práticas

* Verifique se os tokens utilizados pertencem à entidade selecionada.
* Confirme que o contato possui registros vinculados (como Propostas, Faturas ou Oportunidades), para que os valores possam ser retornados corretamente.
* Caso alguma variável permaneça em branco, verifique se a informação está cadastrada no registro correspondente.
* Sempre realize um teste antes de publicar mensagens, modelos ou automações.

***

### Conclusão

O **Testador de Tokens** facilita a validação das variáveis de conversão, permitindo visualizar o resultado final antes do envio de comunicações. Com suporte às entidades **Contato, Fatura, Proposta, Recorrência, Parcelamento, Nota Fiscal** e **Oportunidade**, a ferramenta contribui para a criação de mensagens mais precisas, personalizadas e livres de erros.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sprinthub.com/topicos/geral/contatos/leads-duvidas-comum/contatos-testador-de-token.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.