As variáveis permitem personalizar automaticamente mensagens, respostas, modelos e automações com informações da conversa, do contato ou do agente responsável pelo atendimento.
Ao utilizar uma variável, o sistema substitui o código pelo valor correspondente no momento do envio da mensagem.
Por exemplo, ao inserir a variável:
contact.first_name
O sistema poderá substituir automaticamente pelo primeiro nome do contato:
Olá, João! Como podemos ajudar?
Variáveis disponíveis
Variáveis da conversa
conversation.id
Retorna o identificador numérico da conversa.
Exemplo de uso:
O número do seu atendimento é: conversation.id
Resultado esperado:
O número do seu atendimento é: 45872
Variáveis do contato
contact.id
Retorna o identificador numérico do contato cadastrado na plataforma.
Exemplo:
Identificação do contato: contact.id
contact.name
Retorna o nome completo do contato.
Exemplo:
Olá, contact.name! Seja bem-vindo ao nosso atendimento.
Resultado esperado:
Olá, João da Silva! Seja bem-vindo ao nosso atendimento.
contact.first_name
Retorna apenas o primeiro nome do contato.
Exemplo:
Olá, contact.first_name! Como podemos ajudar?
Resultado esperado:
Olá, João! Como podemos ajudar?
contact.last_name
Retorna o sobrenome do contato.
Exemplo:
Sobrenome do contato: contact.last_name
Resultado esperado:
Sobrenome do contato: Silva
contact.phone_number
Retorna o número de telefone cadastrado para o contato.
Exemplo:
Telefone informado: contact.phone_number
Resultado esperado:
Telefone informado: +55 79 99999-9999
Variáveis do agente
agent.name
Retorna o nome completo do agente responsável pelo atendimento.
Exemplo:
Olá! Meu nome é agent.name e vou continuar o seu atendimento.
Resultado esperado:
Olá! Meu nome é Maria Santos e vou continuar o seu atendimento.
agent.first_name
Retorna apenas o primeiro nome do agente.
Exemplo:
Meu nome é agent.first_name. Como posso ajudar?
Resultado esperado:
Meu nome é Maria. Como posso ajudar?
agent.last_name
Retorna o sobrenome do agente responsável pela conversa.
Exemplo:
Agente responsável: agent.last_name
Resultado esperado:
Agente responsável: Santos
agent.phone_number
Retorna o número de telefone cadastrado para o agente.
Exemplo:
Telefone do agente: agent.phone_number
Exemplo de mensagem personalizada
Você pode combinar várias variáveis em uma única mensagem:
Olá, contact.first_name!
Meu nome é agent.first_name e sou responsável pelo seu atendimento.
O número da sua conversa é conversation.id.
Caso necessário, entraremos em contato pelo número contact.phone_number.
O sistema substituirá automaticamente as variáveis pelos dados correspondentes:
Olá, João!
Meu nome é Maria e sou responsável pelo seu atendimento.
O número da sua conversa é 45872.
Caso necessário, entraremos em contato pelo número +55 79 99999-9999.
Lista completa de variáveis
conversation.id
contact.id
contact.name
contact.first_name
contact.last_name
contact.phone_number
agent.name
agent.first_name
agent.last_name
agent.phone_number
Boas práticas
Utilize variáveis para tornar as mensagens mais personalizadas e melhorar a experiência do cliente.
Antes de publicar um modelo, verifique se os dados utilizados pela variável estão preenchidos corretamente no cadastro do contato ou do agente.
Evite alterar o nome das variáveis. Elas devem ser utilizadas exatamente como aparecem na documentação.
Também é recomendado testar a mensagem antes de utilizá-la em campanhas, respostas automáticas ou fluxos de atendimento.
Atenção
Caso uma informação não esteja cadastrada na plataforma, a variável poderá ficar vazia ou não ser substituída corretamente.
Por exemplo, se o contato não possuir telefone cadastrado, a variável contact.phone_number poderá não apresentar nenhum valor.
Sempre revise os cadastros e faça um teste antes de utilizar o modelo em produção.