Usar variáveis em mensagens e automações

Conhecer as listas de variáveis

Acesse CRM > Variáveis. A página separa Variáveis da Plataforma e Variáveis do Typebot para facilitar a consulta das chaves disponíveis em cada contexto.

• Variáveis da Plataforma reúnem valores disponíveis nos recursos internos compatíveis.
• Variáveis do Typebot organizam chaves usadas nas integrações e fluxos correspondentes.
• A presença de uma chave na lista não confirma que ela possua valor em todos os contatos ou atendimentos.
• Consulte a origem e a finalidade antes de reutilizar uma variável existente.

Criar uma variável

1. 1

   Selecione Nova Variável.

2. 2

   Em Chave, use somente letras, números e underscore.

3. 3

   Escolha uma chave clara, como nome_cliente ou numero_pedido.

4. 4

   Preencha Valor com uma informação fictícia durante o teste.

5. 5

   Use Descrição para registrar a finalidade e o local de uso.

6. 6

   Revise e salve o cadastro.

Inserir a variável no conteúdo

Use duas chaves de abertura e duas de fechamento ao redor da chave cadastrada. Por exemplo, {{nome_cliente}} ou {{numero_pedido}}.

• Copie a chave exatamente como foi cadastrada.
• Não adicione espaços dentro das chaves.
• Use a variável somente em campos que aceitem substituição dinâmica.
• Escreva a frase de modo que continue compreensível quando o valor estiver vazio.

Testar a substituição

1. 1

   Crie uma mensagem ou automação exclusiva para teste.

2. 2

   Insira a variável e use um valor fictício fácil de reconhecer.

3. 3

   Execute o fluxo com um contato controlado pela equipe.

4. 4

   Confirme se o valor apareceu no lugar correto e sem exibir as chaves.

5. 5

   Teste também o comportamento quando o valor não estiver disponível.

6. 6

   Corrija a chave ou o conteúdo antes de liberar a automação.

Manter variáveis com segurança

• Documente quais mensagens e automações dependem de cada chave.
• Evite criar uma segunda variável para a mesma finalidade.
• Revise os usos antes de alterar Chave ou Valor.
• Remova dados desnecessários e limite a permissão de edição.
• Repita o teste sempre que a origem do valor ou o fluxo for alterado.