Como usar variáveis de template

Use este guia quando você precisar configurar, entender ou validar Como usar variáveis de template na IAra.

Antes de começar na IAra

• Confirme que seu usuário tem permissão para acessar a área citada no artigo.
• Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
• Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

Guia detalhado

Com variáveis de modelo, você pode personalizar suas mensagens inserindo conteúdo dinâmico adaptado a cada destinatário. Ao adicionar espaços reservados às suas mensagens, você pode personalizar facilmente suas comunicações com informações como nome do cliente, número do pedido ou outros detalhes.

Na tela: Use respostas prontas para validar como variáveis aparecem em mensagens reutilizáveis.

Por exemplo, se você enviar uma mensagem ``Ei {{ contact.name }}, como posso ajudá-lo?, a IAra escolherá o nome do contato e enviará uma mensagem como Ei John, como posso ajudá-lo?`.

Você também pode utilizar variáveis em respostas predefinidas, macros e automação.

Criando variáveis de modelo

Para usar uma variável, digite duas chaves duplas {{ ao redigir uma nova mensagem ou criar uma resposta automática. As variáveis aparecerão e você poderá selecionar aquela que deseja usar.

As variáveis de modelo disponíveis são:

• conversation.id

  ~ Para a versão numérica do ID da conversa.

• contact.id

  ~ Para a versão numérica do ID de contato.

• [nome do contato](http://nome do contato)

  ~ Para o nome completo do contato.

• contato.first_name

• contato.último_nome

• contato.número_de_telefone

• [nome do agente](http://nome do agente)

• agente.primeiro_nome

• agente.último_nome

• agente.número_de_telefone

E se eu enviar uma variável inexistente?

Se você tentar enviar uma variável indefinida, a IAra mostrará um aviso.

Como adicionar um texto substituto?

Se uma variável definida não puder ser preenchida pelo sistema, um texto substituto poderá ser usado para substituir o valor pretendido. Por exemplo, se a variável contact.first_name não puder ser preenchida, um texto substituto adequado poderá ser 'lá'.

Ao definir um texto substituto, certifique-se de colocá-lo entre aspas simples. Aqui está um exemplo: {{ contact.first_name || 'lá'}}.

Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

Problemas comuns

• Usuário sem permissão para acessar a configuração.
• Nome de tela diferente entre versões ou contas.
• Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
• Falta de teste em conversa realista antes de liberar para a equipe.

Checklist final

• [ ] Configuração revisada por um administrador.
• [ ] Teste realizado com dado ou conversa controlada.
• [ ] Impacto para agentes e gestores entendido.
• [ ] Artigos relacionados revisados para evitar links quebrados.