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.

<!-- iara-context-media:automacoes-macros-respostas-prontas-frame-003 -->
**Na tela:** Use respostas prontas para validar como variáveis aparecem em mensagens reutilizáveis.

![variáveis em respostas prontas.](https://app.digi2b.com/storage/file/n1jjoagdov8r1nqr50qkbyu50l1h)

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.