Mensagens e Templates
Por Tayrone Santos
Por Tayrone Santos
Como usar variáveis em mensagens e modelos
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.
Como usar variáveis nas campanhas do WhatsApp
As variáveis permitem personalizar automaticamente as mensagens enviadas em campanhas do WhatsApp. Com elas, é possível incluir informações como nome do contato, número de telefone, agente responsável e identificador da conversa. Em vez de enviar uma mensagem genérica para todos os contatos, a plataforma substitui cada variável pelos dados correspondentes de cada destinatário. Exemplo de personalização Ao configurar uma campanha com a seguinte mensagem: Olá, {{contact.first_name}}! Temos uma condição especial para você. Cada contato receberá a mensagem com seu próprio nome: Olá, João! Temos uma condição especial para você. Como adicionar uma variável na campanha Para configurar uma campanha personalizada: 1. Acesse o menu Campanhas. 2. Selecione a opção WhatsApp. 3. Clique em Criar campanha. 4. Informe o título da campanha. 5. Selecione o canal do WhatsApp que será utilizado. 6. Escolha o modelo de mensagem aprovado. 7. No campo Variáveis, informe a variável que deverá substituir o parâmetro do modelo. 8. Selecione o público da campanha. 9. Defina a data e o horário do envio. 10. Revise as informações e clique em Criar. Ao preencher o campo Variáveis, a visualização do modelo será atualizada para mostrar onde a informação será inserida. Formato correto das variáveis Nas campanhas, as variáveis devem ser informadas entre duas chaves de abertura e duas chaves de fechamento. Exemplo: {{contact.first_name}} Não altere o nome interno da variável. Correto {{contact.first_name}} Incorreto {{nome_do_contato}} {contact.first_name} {{ contact.first_name }} Para evitar erros, utilize a variável exatamente como apresentada nesta documentação. Variáveis disponíveis Variáveis da conversa conversation.id Retorna o identificador numérico da conversa. Na campanha, utilize: {{conversation.id}} Exemplo: O número do seu atendimento é {{conversation.id}}. Variáveis do contato contact.id Retorna o identificador numérico do contato. {{contact.id}} contact.name Retorna o nome completo do contato. {{contact.name}} Exemplo: Olá, {{contact.name}}! contact.first_name Retorna somente o primeiro nome do contato. {{contact.first_name}} Exemplo: Olá, {{contact.first_name}}! Tudo bem? Essa é uma das variáveis mais recomendadas para campanhas, pois deixa a mensagem mais pessoal e natural. contact.last_name Retorna o sobrenome do contato. {{contact.last_name}} contact.phone_number Retorna o número de telefone cadastrado para o contato. {{contact.phone_number}} Exemplo: O número cadastrado em nosso sistema é {{contact.phone_number}}. Variáveis do agente agent.name Retorna o nome completo do agente responsável. {{agent.name}} Exemplo: Meu nome é {{agent.name}} e estou entrando em contato para continuar seu atendimento. agent.first_name Retorna somente o primeiro nome do agente. {{agent.first_name}} agent.last_name Retorna o sobrenome do agente. {{agent.last_name}} agent.phone_number Retorna o número de telefone cadastrado para o agente. {{agent.phone_number}} Exemplo de campanha personalizada Considere o seguinte modelo: Olá, {{contact.first_name}}! Aqui é {{agent.first_name}}, da nossa equipe de atendimento. Estamos entrando em contato para apresentar uma condição especial para você. Caso tenha alguma dúvida, basta responder a esta mensagem. Para um contato chamado João e um agente chamado Maria, o resultado será: Olá, João! Aqui é Maria, da nossa equipe de atendimento. Estamos entrando em contato para apresentar uma condição especial para você. Caso tenha alguma dúvida, basta responder a esta mensagem. Como configurar campanhas com mais de uma variável Quando o modelo possuir mais de um campo dinâmico, preencha cada variável de acordo com a posição apresentada na tela de criação da campanha. Exemplo de modelo: Olá, {{contact.first_name}}! Meu nome é {{agent.first_name}} e vou acompanhar seu atendimento. Nesse caso, utilize: {{contact.first_name}} para o campo correspondente ao nome do contato e: {{agent.first_name}} para o campo correspondente ao nome do agente. Respeite sempre a ordem dos campos exibidos na configuração da campanha. Como selecionar o público da campanha No campo Público, selecione as etiquetas dos contatos que deverão receber a mensagem. Antes de criar a campanha, confirme se: - Os contatos possuem números de telefone válidos; - As etiquetas selecionadas correspondem ao público correto; - Os dados utilizados pelas variáveis estão preenchidos; - O modelo escolhido está aprovado e disponível no canal selecionado. Agendamento da campanha No campo Horário agendado, informe a data e o horário em que a campanha deverá começar. Antes de concluir, revise: - O canal selecionado; - O modelo do WhatsApp; - As variáveis; - O público; - A data e o horário do envio. Após a criação, a campanha será exibida na lista de campanhas do WhatsApp com seu respectivo status. Boas práticas Utilize o primeiro nome do contato Para mensagens promocionais, reativações e lembretes, prefira: {{contact.first_name}} Essa variável geralmente deixa a comunicação mais natural do que o nome completo. Evite depender de informações não preenchidas Uma variável somente poderá ser substituída corretamente quando a informação estiver disponível no cadastro. Por exemplo, se o contato não possuir nome cadastrado, a variável: {{contact.first_name}} poderá não apresentar o resultado esperado. Faça um envio de teste Antes de enviar uma campanha para muitos contatos, crie uma etiqueta de teste e envie a mensagem para um grupo reduzido. Confira se: - As variáveis foram substituídas; - Os nomes foram apresentados corretamente; - A formatação da mensagem foi mantida; - Os botões e links do modelo estão funcionando; - O modelo está associado ao canal correto. Não altere os nomes das variáveis Os nomes técnicos devem ser mantidos exatamente como estão: 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 Problemas comuns A variável apareceu como o na mensagem Verifique se ela foi escrita entre duas chaves: {{contact.first_name}} Também confirme se o nome da variável foi digitado corretamente. O nome do contato não apareceu Confira se o nome está preenchido no cadastro do contato. Também verifique se foi utilizada a variável adequada: {{contact.name}} para o nome completo ou: {{contact.first_name}} para somente o primeiro nome. A informação do agente ficou vazia Confirme se os dados do agente estão cadastrados e se existe um agente relacionado ao cono do envio. Faça um teste antes de utilizar variáveis agent.* em campanhas maiores. A campanha foi criada para o público errado Revise as etiquetas selecionadas no campo Público. A campanha será direcionada aos contatos vinculados às etiquetas escolhidas. Conclusão O uso de variáveis torna as campanhas do WhatsApp mais personalizadas e relevantes para cada contato. Antes de realizar um envio em massa, revise o modelo, confira os cadastros e execute uma campanha de teste. Isso reduz erros e garante que cada destinatário receba a mensagem com as informações corretas.