Webhook (HTTP callback)

O que é um webhook

Um webhook é uma requisição HTTP automática que um serviço envia para uma URL escolhida por você quando um evento acontece. Em pesquisas, o evento costuma ser uma nova resposta, e a requisição leva as respostas para o seu CRM, backend ou ferramenta de automação.

A diferença para uma API é a direção. Com uma API, o seu sistema pede os dados. Com um webhook, os dados chegam sozinhos, então você não precisa verificar de tempos em tempos se há respostas novas.

Como funciona no SurveyNinja

• Webhooks estão disponíveis no plano Básico e superiores. Você adiciona um na aba Integrações da pesquisa.
• Cada resposta concluída chega à sua URL de retorno como requisição POST, PUT, PATCH ou GET com corpo JSON.
• Você pode adicionar cabeçalhos próprios, como um token de autorização, escolher quais perguntas enviar e dar nomes curtos a elas.
• Nos planos que salvam respostas incompletas (Padrão e superiores), o webhook também pode enviá-las a cada 1, 6, 12 ou 24 horas.
• O registro mostra cada envio com a resposta do seu servidor. Ali você manda uma solicitação de teste e reenvia as que falharam.

Configuração e formato da requisição: Webhooks. Se os dados pararem de chegar, veja Por que as respostas não chegam ao Google Sheets, webhooks ou Telegram?

Erros comuns

• Um webhook novo é salvo desativado. Ative o botão ao lado dele, senão nada é enviado.
• A URL precisa ser pública. Endereços locais e internos são recusados.
• O seu servidor deve responder com um código 2xx em até 30 segundos. Devolva o código primeiro e processe os dados depois.
• Depois de 20 falhas seguidas, ou 5 seguidas com resposta 4xx, o SurveyNinja desativa o webhook. Corrija o receptor, ative de novo e reenvie as requisições que falharam pelo registro.