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:** ```text O número do seu atendimento é: conversation.id ``` **Resultado esperado:** ```text O número do seu atendimento é: 45872 ``` ### Variáveis do contato #### `contact.id` Retorna o identificador numérico do contato cadastrado na plataforma. **Exemplo:** ```text Identificação do contato: contact.id ``` #### `contact.name` Retorna o nome completo do contato. **Exemplo:** ```text Olá, contact.name! Seja bem-vindo ao nosso atendimento. ``` **Resultado esperado:** ```text Olá, João da Silva! Seja bem-vindo ao nosso atendimento. ``` #### `contact.first_name` Retorna apenas o primeiro nome do contato. **Exemplo:** ```text Olá, contact.first_name! Como podemos ajudar? ``` **Resultado esperado:** ```text Olá, João! Como podemos ajudar? ``` #### `contact.last_name` Retorna o sobrenome do contato. **Exemplo:** ```text Sobrenome do contato: contact.last_name ``` **Resultado esperado:** ```text Sobrenome do contato: Silva ``` #### `contact.phone_number` Retorna o número de telefone cadastrado para o contato. **Exemplo:** ```text Telefone informado: contact.phone_number ``` **Resultado esperado:** ```text Telefone informado: +55 79 99999-9999 ``` ### Variáveis do agente #### `agent.name` Retorna o nome completo do agente responsável pelo atendimento. **Exemplo:** ```text Olá! Meu nome é agent.name e vou continuar o seu atendimento. ``` **Resultado esperado:** ```text Olá! Meu nome é Maria Santos e vou continuar o seu atendimento. ``` #### `agent.first_name` Retorna apenas o primeiro nome do agente. **Exemplo:** ```text Meu nome é agent.first_name. Como posso ajudar? ``` **Resultado esperado:** ```text Meu nome é Maria. Como posso ajudar? ``` #### `agent.last_name` Retorna o sobrenome do agente responsável pela conversa. **Exemplo:** ```text Agente responsável: agent.last_name ``` **Resultado esperado:** ```text Agente responsável: Santos ``` #### `agent.phone_number` Retorna o número de telefone cadastrado para o agente. **Exemplo:** ```text Telefone do agente: agent.phone_number ``` ## Exemplo de mensagem personalizada Você pode combinar várias variáveis em uma única mensagem: ```text 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: ```text 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 ```text 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.