Quando usar
- Você quer que uma automação, resposta rápida ou macro preencha sozinha o nome do cliente, o e-mail ou o número do protocolo
- Você inseriu uma variável e ela chegou vazia na conversa
- Você está montando uma mensagem automática e quer saber o que dá para preencher automaticamente
Sobre este artigo
O Cloud Chat substitui variáveis dentro das mensagens que saem para o cliente — respostas do agente, respostas rápidas, macros, mensagens de automação e mensagens automáticas da caixa de entrada. A substituição acontece no momento do envio.
Basta digitar duas chaves no campo de texto para abrir a lista de variáveis disponíveis.
Variáveis da conversa
| Variável | O que preenche |
|---|---|
conversation.display_id |
Número do protocolo exibido ao cliente |
conversation.id |
Identificador interno da conversa |
conversation.custom_attribute.chave |
Valor de um campo personalizado de conversa |
Variáveis do contato
| Variável | O que preenche |
|---|---|
contact.name |
Nome completo |
contact.first_name |
Primeiro nome |
contact.last_name |
Sobrenome (vazio quando o contato só tem um nome) |
contact.email |
E-mail do contato |
contact.phone_number |
Telefone do contato |
contact.id |
Identificador do contato |
contact.custom_attribute.chave |
Valor de um campo personalizado de contato |
Variáveis do agente, da caixa e da conta
| Variável | O que preenche |
|---|---|
agent.name |
Nome do agente que está enviando |
agent.first_name / agent.last_name |
Primeiro nome e sobrenome do agente |
inbox.name |
Nome da caixa de entrada |
account.name |
Nome da conta |
Regras que evitam dor de cabeça
Variável sem valor vira texto vazio. Se o contato não tem e-mail cadastrado, a variável de e-mail some da mensagem e o cliente recebe a frase pela metade. Para evitar isso, defina um valor padrão usando o filtro default na própria variável.
Só funciona em mensagem que sai. Mensagens recebidas do cliente nunca são processadas — se o cliente digitar o nome de uma variável, o texto fica literal.
- Nome do campo personalizado é a chave, não o rótulo. Use a chave exata cadastrada em Configurações, sem espaços nem acentos.
- Trecho entre crases não é processado. Para mostrar a variável como exemplo, sem que ela seja substituída, coloque entre crases.
- Chave quebrada não é substituída. Se faltar uma das chaves de fechamento, o Cloud Chat deixa o texto como está em vez de tentar adivinhar.
Como toda mensagem que sai passa por essa substituição, não dá para ensinar a sintaxe de uma variável dentro de uma mensagem — o Cloud Chat troca o exemplo pelo valor real antes de enviar. Para explicar variáveis a alguém, aponte este artigo em vez de escrever o exemplo na conversa.
Observações
- As variáveis desta lista valem para as mensagens do Cloud Chat. Dentro de um Fluxo Controlado a lista é outra — veja o artigo sobre variáveis enviadas para fluxos.