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.
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
Feedback de colaboradores
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.
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.
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.
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.
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.
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.
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.
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.
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:
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.
