Por que o meu webhook não está funcionando?

Às vezes a configuração de webhook realizada em seu formulário pode não se comportar conforme o esperado e a solução para resolver isso é mais simples do que você pensa! Neste artigo te damos algumas dicas que você pode seguir para checar se está tudo certo em seu cenário de integração:

- Confira para quando a sua integração está configurada para ativar/executar;

- Verifique se há algum filtro configurado no cenário;

- Preencha todos os campos que deseja integrar no seu envio de testes. Somente campos preenchidos são enviados ao webhook (atenção para as lógicas);

- Confira o mapeamento dos campos de acordo com as perguntas do seu formulário;

Confira para quando a sua integração está configurada para ativar/executar

No Respondi, confira para quando a sua integração está configurada para ativar

Se você recebeu um preenchimento recuperado em sua aba de Respostas, mas este não foi enviado via webhooks, confira se por acaso a sua integração não está ativa para enviar apenas envios completos.

Na aba de "Opções" do seu formulário, acessando a parte de "Configurar integrações", você pode escolher quando deseja ativar as integrações: Ativar somente em respostas completas ou Ativar em respostas completas e recuperadas.

Na plataforma de integração, confira para quando a sua integração está configurada para executar:

Se você recebeu um preenchimento em sua aba de Respostas, mas este não foi enviado via webhooks, verifique na plataforma de integração como o seu cenário está configurado para executar.

Algumas plataformas de integração (como a Make e a n8n, por exemplo), permitem que você defina quando e com que frequência um cenário ativado será executado. Pode ser que a execução esteja programada para intervalos mais espaçados e por isso não está disparando imediatamente.

Verifique se há algum filtro configurado no cenário

Algo muito útil nas plataformas de integrações é que você pode configurar filtros/roteadores em seu cenário para segmentar as respostas dependendo do perfil do respondente ou até mesmo enviar ao seu CRM ou planilha apenas aquelas respostas que considerar "qualificadas".

Porém, ao configurar um desses filtros no cenário, você pode deixar de receber determinados tipos de respostas que não passarão pelos filtros configurados. Ou seja, embora você receba todos os preenchimentos em sua aba de Respostas, serão migradas para o serviço terceiro apenas aqueles que passarem pelo filtro configurado.

Preencha todos os campos que deseja integrar no seu envio de testes

Se estiver com dificuldade de mapear algum campo do seu formulário na plataforma de integração, pode ser que esse campo não esteja sendo enviado via webhooks devido a opções de lógicas que você configurou em perguntas anteriores.

Nesse caso, desative temporariamente as lógicas para realizar o teste com todos os campos do formulário. Após concluir o mapeamento, você pode reabilitar as lógicas. Isso permitirá o mapeamento de todos os campos ativos, sem a interferência das lógicas.

Confira o mapeamento dos campos de acordo com as perguntas do seu formulário

Se algum campo do seu formulário não está sendo enviado na integração, pode ser que a própria plataforma de integração não esteja reconhecendo os dados deste campo específico. Tem alguns cenários bem comuns que podem acontecer:

1. Quando o título da sua pergunta contém um caractere de nova linha (Shift+Enter)

Se o título de uma pergunta sua contém um caractere de nova linha (Shift+Enter), isso o quebra e ele não pode ser mapeado corretamente em plataformas de integração como a Make, e consequentemente, o valor não é enviado para a sua planilha ou CRM. Para solucionar essa questão é bem simples: você precisa que o título da sua pergunta tenha apenas um bloco de texto, sem quebras de linha.

A nossa sugestão é que você separe o texto da pergunta entre título e descrição e refaça o mapeamento com os dados corretos na Make. A outra opção é simplesmente excluir o espaço utilizado no título e manter todo o texto na mesma linha.

Depois de ajustar o título e publicar o formulário, é necessário refazer o envio teste na Make para mapear novamente este campo com a informação atualizada.

2. Quando o título da sua pergunta contém o código de "Mencionar resposta anterior":

Apesar de perguntas com títulos que contém o código de "Mencionar resposta anterior" serem enviadas normalmente via webhooks, algumas ferramentas podem não aceitar esse valor na hora de fazer o mapeamento dos campos. Se estiver utilizando a Make como plataforma de integração, existe uma maneira muito simples de resolver essa questão: utilizar um módulo de Set variable (para formatar um campo), ou o Set multiple variables (para formatar vários campos).

Basta incluir alguns passos extras em seu cenário para conseguir mapear o campo conforme deseja:

1. Clique no ícone lilás de "Tools" e adicione a ação de "Set variable" - posicione-o entre o módulo de webhook e o do serviço terceiro que estiver integrando;
2. No módulo de "Set variable", preencha o campo de "Variable name" com o título que preferir e em "Variable value" adicione o valor da pergunta/resposta do campo que deseja formatar;
3. No módulo do serviço terceiro (em que o mapeamento precisa ser feito), adicione o valor gerado no módulo "Set variable" (em lilás), em vez de o valor direto da reposta do webhook;
4. Salve as alterações em todos os módulos e clique em "Run once" para testar se o cenário foi alterado com sucesso :)

3. Quando o título da sua pergunta contém um caractere de ponto final (".")

Na Pluga, se o título de alguma pergunta sua contém um caractere de ponto final ("."), isso o quebra e ele não pode ser mapeado corretamente, assim, o valor não é enviado para a sua planilha ou CRM. Para solucionar essa questão é bem simples: você precisa remover o caractere de ponto final do título da sua pergunta. A nossa sugestão é que você substitua o ponto final por algum outro caractere, ou simplesmente o exclua do texto.

Depois de ajustar o título e publicar o formulário, é necessário refazer o envio teste na Pluga para mapear novamente este campo com a informação atualizada.

Outros pontos importantes:

• Normalmente um webhook é disparada alguns segundos após o preenchimento, porém, em alguns raros casos pode levar até 15 minutos;
• Lembre-se que o "modo de visualização" (aquele com a barrinha amarela no topo) não dispara webhooks. Você deve fazer um envio real para testar;
• Se os dados estão corretos, mas mesmo assim a sua integração não funciona como deveria, você pode entrar em contato com o suporte do produto ao qual está tentando integrar e compartilhar esse conteúdo com eles. Irá ajudar a descobrir o problema;