Passar para o conteúdo principal

Webhooks: mande respostas para suas outras ferramentas em tempo real

Conecte o Survio ao Slack, ao seu CRM, helpdesk ou planilhas — cada resposta gera uma ação automática. Guia prático, passo a passo.

Webhooks permitem que o Survio envie automaticamente uma resposta da pesquisa para qualquer ferramenta que sua equipe já usa, no exato momento em que alguém responde. Nada de exportar, copiar e colar ou ficar esperando. No instante em que uma resposta chega, o Survio já dispara para o endereço que você escolher.

👋 Você não precisa ser da área técnica para usar isso. Se não tiver certeza de onde começar, abra a página de Webhooks e clique em Obter configuração de especialista — conte para a gente o que gostaria que acontecesse, e nossa equipe vai configurar, testar e entregar um webhook funcionando para você. Não precisa de código. Ou conecte-se com nosso time técnico por e-mail: techsupport@survio.com

Aqui está a ideia inteira em uma imagem: uma resposta chega, e o Survio a entrega para todas as ferramentas conectadas ao mesmo tempo, em tempo real.

Uma resposta é entregue para toda ferramenta conectada ao mesmo tempo — CRM, helpdesk, canal da equipe, dashboard

O que você pode fazer com um webhook?

Um webhook é apenas um endereço de entrega. Assim que você conecta um, toda nova resposta de pesquisa é enviada para lá automaticamente. O que acontece em seguida depende da ferramenta que recebe. Alguns dos fluxos mais comuns:

  • Salvar clientes insatisfeitos: uma nota baixa alerta instantaneamente sua equipe e marca o contato no seu CRM — assim você pode entrar em contato e resolver antes que a pessoa deixe uma avaliação ruim em público.

  • Não perca nenhum lead: uma resposta “Quero uma demonstração” aparece em seu CRM (HubSpot, Salesforce, Pipedrive...) no momento em que é enviada — sem digitar nada manualmente.

  • Proteja sua marca: uma resposta 1 estrela manda alerta para sua equipe no Slack, Teams ou e-mail em poucos segundos, então nada passa batido.

  • Atenda reclamações automaticamente: feedback negativo já vira ticket de suporte no seu sistema de atendimento ao cliente.

  • Mantenha seus relatórios ao vivo: cada resposta vai direto para uma planilha, data warehouse ou dashboard de BI que você configurou — assim seus próprios relatórios ficam atualizados sem exportação manual. O Survio envia os dados; o dashboard é aquele que você constrói ou integra do seu lado.

Veja alguns desses fluxos do início ao fim — da chegada da resposta, o que a ferramenta faz, até a ação que a equipe toma:

Satisfação do cliente

Resgate de detratores: NPS 3/10 → webhook → ticket no helpdesk → sua equipe → contato em até 1 hora → cliente salvo

Loop do promotor: NPS 10/10 → webhook → ferramenta de avaliações → convite automático por e-mail → um novo review público

Loop do CRM: resposta → webhook → contato no CRM atualizado → registro sinalizado → representante recebe tarefa de follow-up

Feedback de colaboradores

Loop de RH: resposta eNPS → webhook → registro atualizado na plataforma de RH → gestor notificado → agendamento de 1:1

Roteamento de idioma: o langCode da resposta direciona para a equipe regional correspondente


Como adicionar um webhook

Webhooks são um recurso Premium. Se não vir a opção abaixo, talvez precise fazer upgrade do seu plano antes.

Para conectar um webhook você precisa de uma coisa: uma URL de endpoint. Simplesmente é o endereço web que sua outra ferramenta espera receber dados. Você não a cria — a ferramenta no destino (Slack, Zapier, Make, n8n, seu CRM ou sistema próprio) gera para você, e você cola no Survio. Não sabe onde pegar? É pra isso que serve o Obter configuração de especialista.

Passo 1 — Abrir a página de Webhooks

Abra sua pesquisa, vá em Coletar respostas e selecione Webhooks em “Automatizações & Integrações” no menu lateral à esquerda.

Página de Webhooks do Survio, estado vazio, com o botão Adicionar um webhook

Passo 2 — Clicar em “Adicionar um webhook”

Clique no botão + Adicionar um webhook no canto superior direito. Vai abrir uma janela pedindo a URL de endpoint — o endereço da ferramenta ou plataforma de automação (ex: Zapier, Make, n8n ou seu servidor próprio) para onde o Survio deve enviar os dados de resposta.

Janela adicionar webhook com campo de URL vazio

Passo 3 — Colar sua URL do webhook

Cole a URL fornecida pela sua ferramenta no campo URL do webhook.

A URL deve começar com https:// — links somente http:// não são aceitos, e a URL não pode conter usuário ou senha.

Campo da URL do webhook preenchido com um exemplo de endpoint

Passo 4 — (Opcional) Adicionar cabeçalhos HTTP

Algumas ferramentas precisam de uma chave de autenticação ou token junto com cada envio. Clique em + Adicionar cabeçalho, depois informe o nome do cabeçalho (por exemplo X-Api-Key) e o valor. Você pode adicionar até 20 cabeçalhos por webhook. Após salvar, os valores ficam ocultos e não podem ser visualizados novamente — só substituídos.

Não tem certeza se precisa disso? A maioria das pessoas não precisa. Só adicione cabeçalho se sua ferramenta pedir uma chave de API ou token para autenticar — por exemplo, um cabeçalho chamado X-Api-Key com um valor secreto fornecido pela ferramenta. Se ficar em dúvida, pode deixar em branco, ou pergunte para quem gerencia essa ferramenta.

Seção de headers HTTP com nome e valor preenchidos

Passo 5 — Salvar

Clique em Salvar webhook. Seu novo webhook aparece na lista “Seus webhooks”, já ativado por padrão. A partir de agora, toda nova resposta a esta pesquisa é enviada automaticamente para essa URL.

Webhook salvo aparecendo na lista, ativado

Como gerenciar seus webhooks

Ativar ou pausar um webhook

Use o controle ao lado de um webhook para pausá-lo ou retomá-lo a qualquer momento. Isso não exclui nada — apenas interrompe (ou reativa) as entregas. Pausar e retomar não reenviam nada que chegou enquanto estava desativado.

Webhook desativado na lista

Editar um webhook

Clique em Editar para mudar a URL ou atualizar cabeçalhos. Os valores já salvos são mostrados como pontos por segurança — para mudar, digite um novo valor.

Janela editar webhook com valor de cabeçalho oculto

Excluir um webhook

Clique no ícone de lixeira ao lado de um webhook para remover.

Excluir um webhook é definitivo. Não temos como restaurar um webhook excluído, nem reenviar respostas recebidas enquanto estava removido ou pausado — essas entregas não podem ser recuperadas. Confira que nada importante depende dessa conexão antes de excluir.

Confirmação de exclusão de webhook

Quais dados um webhook envia?

Toda vez que alguém responde sua pesquisa, o Survio envia uma solicitação HTTPS POST para a URL do webhook com um corpo JSON contendo:

  • O tipo de evento (atualmente, sempre uma nova resposta de pesquisa)

  • O ID da pesquisa a que a resposta pertence

  • A resposta completa: um ID de resposta único, data e horário de envio, e-mail do respondente (se coletado), canal de resposta (ex: link direto, e-mail, QR code, pop-up), idioma da resposta, quaisquer parâmetros de URL personalizados (como UTM), e a resposta para cada pergunta

Essa é a mesma estrutura de dados usada em toda a API do Survio, então se sua ferramenta já entende respostas do Survio, ela também entende os webhooks. Veja como é uma entrega, com exemplo de dados:

Exemplo de payload JSON de webhook mostrando eventType, surveyId e a resposta completa dentro de data

Quantos webhooks posso adicionar?

O número de webhooks por pesquisa depende do seu plano:

Plano

Webhooks por pesquisa

Free

Não disponível

Mini

1

Standard

3

Pro Business / Enterprise / Custom

10

Tanto webhooks ativos quanto pausados contam para esse limite — pausar um não libera o slot, apenas excluir remove da contagem.

As entregas dos webhooks também descontam da cota de respostas do seu plano. Se você ficar sem respostas no período, as entregas pausam automaticamente e são retomadas no próximo ciclo de cobrança — mas suas respostas continuam salvas no Survio de qualquer forma.

Respondeu à sua pergunta?