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, Devzapp 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 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 e selecione a ferramenta que deseja fazer a integração. Nesse caso, o Z-API;
3. 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!