Passar para o conteúdo principal

Webhooks: envie respostas para suas outras ferramentas em tempo real

Conecte o Survio ao Slack, seu CRM, helpdesk ou planilhas — cada resposta dispara uma ação automaticamente. Guia de configuração passo a passo.

Escrito por Success Team Survio

Com os webhooks, o Survio envia uma resposta da pesquisa direto para qualquer ferramenta que sua equipe já utiliza — no exato momento em que alguém envia. Sem exportar, sem copiar e colar, sem esperar. Assim que a resposta chega, o Survio envia direto para o endereço que você escolher.

👋 Você não precisa ser técnico para usar isso. Se não sabe por onde começar, abra a página de Webhooks e clique em Obter configuração de especialista — conte o que deseja, e nossa equipe monta, testa e entrega um webhook funcionando. Não precisa de código. Ou se conecte com nosso time técnico por e-mail: techsupport@survio.com

Veja a ideia central em uma imagem: uma resposta chega e o Survio entrega para toda ferramenta que você conectou — simultaneamente, em tempo real.

One response is delivered to every connected tool at once — CRM, helpdesk, team channel, dashboard

O que você pode fazer com um webhook?

Um webhook é só um endereço de entrega. Depois de conectar, toda nova resposta da pesquisa é enviada automaticamente para lá. O que acontece depois depende da ferramenta receptora. Exemplos comuns de uso:

  • Salvar clientes insatisfeitos: uma nota baixa alerta sua equipe na hora e marca o contato no seu CRM — assim, você pode agir antes que a pessoa deixe uma avaliação pública negativa.

  • Nunca perca um lead: uma resposta como “Quero uma demonstração” aparece no seu CRM (HubSpot, Salesforce, Pipedrive...) na hora em que é enviada — sem preencher manualmente.

  • Proteja sua marca: uma resposta de 1 estrela faz sua equipe ser alertada automaticamente no Slack, Teams ou e-mail em segundos, assim nada passa despercebido.

  • Trate reclamações automaticamente: feedback negativo vira um chamado no seu sistema de suporte ao cliente.

  • Mantenha seus relatórios em tempo real: cada resposta vai direto para uma planilha, data warehouse ou dashboard de BI que você configurou — assim seus relatórios ficam atualizados sem exportação manual. O Survio envia os dados; o dashboard é você quem monta ou conecta do seu lado.

Confira exemplos do início ao fim — da chegada da resposta, o que a ferramenta faz, até a ação da equipe:

Satisfação do cliente

Detractor rescue loop: NPS 3/10 → webhook → helpdesk ticket → your team → reach out within the hour → customer saved
Promoter loop: NPS 10/10 → webhook → review tool → automatic email invite → a fresh public review
CRM loop: response → webhook → CRM contact updated → record flagged → sales rep gets a follow-up task

Feedback de colaboradores

HR loop: eNPS response → webhook → HR platform record updated → manager notified → a 1:1 is booked
Language routing: the response's langCode sends it to the matching regional team

Como adicionar um webhook

Webhooks são uma funcionalidade Premium. Se não ver a opção descrita abaixo, talvez seja preciso fazer upgrade do seu plano.

Para conectar um webhook, você precisa de uma coisa: a URL do endpoint. É simplesmente o endereço web em que a outra ferramenta vai esperar receber os dados. Você não cria isso — a ferramenta receptora (Slack, Zapier, Make, n8n, seu CRM ou seu próprio sistema) gera para você, e você cola no Survio. Se não souber onde pegar, é para isso que serve o Obter configuração de especialista.

Passo 1 — Abra a página de Webhooks

Abra sua pesquisa, vá até Coletar respostas e então selecione Webhooks em “Automatizações & Integrações” na barra lateral à esquerda.

Survio Webhooks page, empty state, with the Add a webhook button

Passo 2 — Clique em “Adicionar webhook”

Clique no botão + Adicionar webhook no canto superior direito. Será aberta uma janela pedindo a URL do endpoint — ou seja, o endereço da ferramenta ou plataforma de automação (por exemplo, Zapier, Make, n8n ou servidor próprio) para onde o Survio deve enviar os dados da resposta.

Add a webhook window with an empty Webhook URL field

Passo 3 — Cole a URL do seu webhook

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

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

Webhook URL field filled in with an example endpoint

Passo 4 — (opcional) Adicionar cabeçalhos HTTP

Algumas ferramentas precisam de uma chave ou token de autenticação junto com cada requisição. Clique em + Adicionar cabeçalho, então insira o nome do cabeçalho (por exemplo, X-Api-Key) e o valor. É possível adicionar até 20 cabeçalhos por webhook. Depois de salvar, os valores dos cabeçalhos ficam mascarados e não podem ser visualizados novamente — apenas substituídos.

Não sabe se precisa? A maioria não precisa. Só adicione um cabeçalho se sua ferramenta pedir explicitamente uma chave ou token de API para autenticar — por exemplo, um cabeçalho chamado X-Api-Key com um valor secreto que a ferramenta lhe fornece. Se tiver dúvidas, deixe vazio ou pergunte para quem administra a ferramenta.

HTTP headers section with a name and value filled in

Passo 5 — Salvar

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

Saved webhook appearing in the list, toggled ON

Gerenciando seus webhooks

Ativar ou pausar um webhook

Use o botão de alternância ao lado de um webhook para pausar ou retomar sempre que quiser. Nada é excluído — apenas interrompe (ou reinicia) os envios. Pausar e retomar não reenvia nada que chegou enquanto estava desligado.

Webhook toggled OFF in the list

Editar um webhook

Clique em Editar para alterar a URL ou atualizar os cabeçalhos. Os valores dos cabeçalhos aparecem como pontos por segurança — será necessário reinserir o valor se quiser trocar.

Edit webhook window with masked header value

Excluir um webhook

Clique no ícone da lixeira ao lado do webhook para eliminá-lo.

Excluir um webhook é permanente. Não podemos restaurar um webhook eliminado, nem reenviar respostas que chegaram enquanto ele estava excluído ou pausado — essas entregas são perdidas. Certifique-se de que nada importante depende da conexão antes de remover.

Delete webhook confirmation dialog

Quais dados um webhook envia?

Sempre que alguém envia sua pesquisa, o Survio faz uma requisição HTTPS POST para a URL do webhook com um corpo JSON contendo:

  • O tipo de evento (neste momento, 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 hora do envio, canal por onde veio a resposta (exemplo: link direto, e-mail, QR code, pop-up), idioma da resposta, quaisquer parâmetros de URL personalizados (como tags UTM) e a resposta para cada pergunta

Quer o e-mail do respondente? Veja na resposta da pergunta de e-mail ou nos parâmetros de URL personalizados. O campo separado de e-mail fica vazio quando o endereço vem de uma pergunta ou parâmetro de URL.

Essa é a mesma estrutura de dados usada em toda a API do Survio, então se sua ferramenta já entende respostas do Survio, vai entender também o payload do webhook. Veja um exemplo do envio, com dados fictícios:

Example webhook JSON payload showing eventType, surveyId and the full response inside 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 — só excluindo libera um espaço.

Webhooks não consomem suas respostas. O limite do plano serve só para coleta de respostas. A quantidade de webhooks, e para onde os dados vão, não interfere nisso.

Respondeu à sua pergunta?