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.