What is a Webhook and why do I need it?

A Webhook is an HTTP notification that SurveyNinja sends to your server when a survey is submitted. You receive all response data as JSON.

Do I need a developer to set up a Webhook?

On the SurveyNinja side, no — just enter the URL. The receiving server must handle POST requests with JSON. Use Zapier if you have no backend.

What data does the Webhook request contain?

JSON with response ID, date/time, all answers by question name, contact details, UTM parameters, IP address, and user agent.

What happens if my server is unavailable?

SurveyNinja retries the request with increasing intervals on 5xx errors. Data is not lost.

Can I configure multiple Webhooks for one survey?

Yes. Add multiple URLs — each receives the full payload independently, letting you send to CRM, database, and chatbot simultaneously.

How do I secure my Webhook endpoint?

Add a secret token via custom authorization headers in SurveyNinja settings. Accept connections over HTTPS only.

How does a Webhook differ from Zapier?

Webhook sends data directly to your server. Zapier accepts the Webhook and routes it to other services visually — no server required.

Are incomplete responses sent via Webhook?

No. Webhooks fire only on Submit. Partial responses are not transmitted.

Integração

SurveyNinja Webhooks — Conecte Qualquer Sistema Instantaneamente

Envie respostas de pesquisas diretamente ao seu servidor, CRM, banco de dados ou script personalizado como JSON via HTTP POST. Sem intermediários — dados em tempo real a cada envio.

Conectar gratuitamente Ver planos

Tempo realentrega

JSONpayload

Qualquersistema

O Que Você Pode Fazer com Webhooks

Sincronização com CRM

Uma nova resposta de pesquisa cria ou atualiza automaticamente um contato no seu CRM com todos os campos mapeados

Armazenamento em Banco de Dados

Armazene respostas diretamente no seu próprio banco de dados — controle total sobre estrutura e retenção de dados

Alertas por Mensagens

Envie notificações instantâneas pelo Telegram, WhatsApp ou Discord à equipe responsável a cada nova resposta

Gatilhos de Código Personalizado

Acione suas próprias funções serverless, AWS Lambda ou qualquer script backend com o payload completo da resposta

Alertas Baseados em Pontuação

Detecte pontuações baixas de NPS ou CSAT e acione fluxos de escalonamento — entre em contato com o cliente antes que ele vá embora

Cadeias Multi-sistema

Configure múltiplos Webhooks para uma pesquisa — envie dados ao CRM, banco de dados e chatbot simultaneamente

Formato e Confiabilidade do Webhook

Payload JSON

Cada resposta enviada como JSON estruturado: ID da resposta, data/hora, todas as respostas por nome de pergunta, dados de contato e parâmetros UTM

HTTP POST

Requisição HTTP POST padrão ao seu endpoint. Funciona com qualquer servidor, framework ou função serverless que aceite requisições POST

Entrega Instantânea

O Webhook é acionado em segundos após o respondente clicar em Enviar — sem polling ou atrasos

Cabeçalhos Personalizados

Adicione tokens de autorização secretos como cabeçalhos personalizados para proteger seu endpoint e verificar que as requisições vêm do SurveyNinja

HTTPS Obrigatório

Seu endpoint deve usar HTTPS. Isso garante que os dados sejam criptografados em trânsito e que sua integração seja segura

Tentativas Automáticas

Se o seu servidor retornar erro 5xx, o SurveyNinja tenta novamente automaticamente com intervalos crescentes — nenhum dado é perdido

Configure em 3 Passos

Crie sua Pesquisa

Crie uma pesquisa no SurveyNinja — projete perguntas, configure a lógica e personalize a aparência

Começar gratuitamente

Adicione a URL do Webhook

Em configurações da pesquisa → Integrações → Webhooks. Cole a URL do seu endpoint e adicione cabeçalhos de autorização opcionais

Receba e Processe

Envie uma resposta de teste — seu servidor recebe o payload JSON. Processe os dados conforme o necessário para o seu sistema

FAQ — Webhooks

O que é um Webhook e por que preciso dele?

Um Webhook é uma notificação HTTP que o SurveyNinja envia ao seu servidor quando uma pesquisa é enviada. Você recebe todos os dados da resposta como JSON — sem polling ou exportação manual.

Preciso de um desenvolvedor para configurar um Webhook?

No lado do SurveyNinja, não — basta inserir a URL. O servidor receptor deve processar requisições POST com JSON. Use o Zapier se não tiver backend.

Quais dados a requisição do Webhook contém?

JSON com ID da resposta, data/hora, todas as respostas por nome de pergunta, dados de contato, parâmetros UTM, endereço IP e agente do usuário.

O que acontece se meu servidor estiver indisponível?

O SurveyNinja tenta novamente a requisição com intervalos crescentes em erros 5xx. Os dados não são perdidos.

Posso configurar múltiplos Webhooks para uma pesquisa?

Sim. Adicione múltiplas URLs — cada uma recebe o payload completo de forma independente, permitindo enviar ao CRM, banco de dados e chatbot simultaneamente.

Como protejo meu endpoint de Webhook?

Adicione um token secreto via cabeçalhos de autorização personalizados nas configurações do SurveyNinja. Aceite conexões apenas por HTTPS.

Como um Webhook difere do Zapier?

O Webhook envia dados diretamente ao seu servidor. O Zapier aceita o Webhook e o roteia para outros serviços visualmente — sem necessidade de servidor.

Respostas incompletas são enviadas via Webhook?

Não. Webhooks são acionados apenas no envio. Respostas parciais não são transmitidas.