Integração com Z-API via Make webhooks

Você sabia que é possível integrar seu formulário do Respondi a uma ferramenta de envio automático de mensagens via WhatsApp, como o Z-API ou Twilio, utilizando webhooks?

Neste artigo, você vai aprender como configurar essa integração usando o Z-API, para enviar mensagens automáticas personalizadas aos respondentes que preencherem seu formulário. As mensagens são enviadas diretamente pelo seu número de WhatsApp conectado ao Z-API. 😉

No exemplo a seguir, utilizaremos a plataforma Make como plataforma de integração

Após a configuração do webhook, siga os passos abaixo ou assista o tutorial em vídeo para iniciar a integração:

Conecte o seu formulário ao Z-API via Make webhooks

1. Clique no ícone "+ Add another module" para adicionar um novo módulo;
2. Busque pela ferramenta que deseja fazer a integração. Nesse caso, o "Z-API";
3. Selecione a opção "Z-API" e escolha a ação que deseja configurar. Neste caso, a ação de "Send a Text Message";

4. Clique em "Add" para conectar a sua conta do Z-API;
5. Se desejar, renomeie o título da conexão em "Connection name";
6. Preencha os campos de Instance ID, Token ID e Client Token com os códigos que podem ser encontradas nos menus de "Instância Web" e "Segurança" do Z-API e clique em "Save";

Após conectar sua conta do Z-API na Make, é importante formatar corretamente os dados antes de configurar o módulo de envio de mensagens.

Formate o campo de Telefone de acordo com os padrões do Z-API

O Z-API exige que o número de telefone siga o formato: DDI + DDD + número, sem espaços, traços ou outros caracteres especiais - por exemplo: 5511999999999 . Como hoje nós enviamos o dado no formato 55 11999999999 , neste caso, será necessário formatá-lo para remover o espaço entre o DDI e o DDD.

Para isso, siga os passos abaixo:

1. Após configurar seu webhook, clique no ícone lilás de "Tools" e selecione a opção de "Set variable";
2. No campo de "Variable name" preencha o título para identificar a variável. Por exemplo, "WhatsApp";
3. No campo de "Variable value", insira o valor do campo de Telefone do formulário e inclua algumas funções para formatação;

• Para formatar o valor de resposta da variável Telefone (55 51 912345678), inclua a função: replace( 1.respondent:answers: Qual é o seu telefone? ; space ; emptystring ) ;

4. Após realizar a formatação, clique em "Save";
5. Por fim, clique em "Run once" e envie um preenchimento completo ao formulário para receber os novos dados formatados;

Com o número de telefone formatado, siga para a etapa de mapeamento dos campos no módulo de envio de mensagem via Z-API.

Faça o mapeamento dos campos no módulo do Z-API

Siga os passos abaixo para mapear os campos do módulo Send a Text Message - Z-API na Make:

1. No campo de "Phone", insira o valor da variável com o número de telefone formatado, criada anteriormente no módulo "Tools" (ex: WhatsApp );
2. No campo de "Message" personalize o texto que deseja enviar via WhatsApp para o seu respondente;

• Você pode utilizar variáveis para tornar a mensagem mais pessoal, por exemplo, incluindo o nome do respondente com: 1.respondent.answers:Qual é o seu nome? para mencionar o nome da pessoa no texto da mensagem;

3. O campo de "Delay Message" define um atraso no envio da mensagem, simulando o tempo de digitação. Você pode escolher um valor entre 1 a 15 segundos;
4. E o campo de "Delay Tiping" adiciona um atraso antes do envio da mensagem para simular o ícone de "digitando..." no WhatsApp. Escolha um valor entre 1 a 15 segundos.

• Se esses campos não forem preenchidos, o valor padrão será 0, ou seja, a mensagem será enviada imediatamente, sem atrasos;

5. Quando finalizar o mapeamento dos campos, clique em "Save" para salvar as alterações;

Confira se a integração foi feita com sucesso:

• Na Make, clique em "Run once" para enviar uma resposta teste;
• Faça o preenchimento completo do formulário que você acabou de integrar;
• Verifique no WhatsApp preenchido na resposta teste se a mensagem chegou de acordo com as configurações realizadas na integração;
• Se o teste deu certo, habilite a função "Scheduling" na Make para ativar a integração!