Passar para o conteúdo principal

Webhooks: envie respostas para suas outras ferramentas em tempo real

Conecte o Survio ao Slack, ao seu CRM, helpdesk ou planilhas — cada resposta já dispara uma ação na hora. Veja como configurar, passo a passo.

Com os Webhooks, o Survio envia automaticamente cada resposta da Pesquisa direto para qualquer ferramenta que você já usa — no exato momento em que ela é enviada. Sem exportar, sem copiar e colar, sem enrolação. Assim que uma resposta chega, o Survio manda direto para a URL que você escolher.

Webhooks são um recurso Premium. Se não encontrar a opção abaixo, talvez você precise fazer Upgrade do seu plano antes.

O que dá para fazer com um webhook?

Um webhook nada mais é que um endereço de entrega. Assim que conectar um, cada nova resposta da Pesquisa vai para ele automaticamente, na hora. O que acontece a seguir depende da ferramenta que vai receber. Alguns exemplos clássicos:

  • Retenção: uma nota baixa cria um alerta e uma tarefa no seu CRM, para alguém do time entrar em contato no mesmo dia.

  • Crescimento: um lead do formulário “Peça uma demonstração” cai na hora no HubSpot, Salesforce ou qualquer CRM que você use.

  • Proteção da marca: uma avaliação de 1 estrela gera um alerta no Slack, Teams ou no seu e-mail em segundos.

  • Suporte: feedback negativo vira um chamado no Zendesk ou uma tarefa no Jira automaticamente.

  • Análises: cada resposta vai direto para o Google Sheets ou Power BI, deixando seu Dashboard sempre atualizado.

Webhooks em ação — exemplos de uso mostrados no Survio: Retenção, Crescimento, Marca, Suporte, Análises

Não tem alguém de tecnologia para te ajudar? Use o botão "Solicitar configuração de especialista" na página de Webhooks — conte para o time do Survio o que gostaria de automatizar, eles fazem tudo para você, testam e devolvem o webhook já funcionando. Tudo sem precisar programar nada.

Como adicionar um webhook

Passo 1 — Abrir a página de Webhooks

Abra sua Pesquisa, clique em Coletar respostas e selecione Webhooks em "Automatizações & Integrações" na barra lateral à esquerda.

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

Passo 2 — Clicar em "Adicionar webhook"

Clique no botão + Adicionar webhook no canto superior direito. Uma janela vai abrir pedindo a URL de destino — esse é o endereço da ferramenta ou plataforma de automação (exemplo: Zapier, Make, n8n ou seu próprio servidor) para onde o Survio vai enviar os Dados das respostas.

Janela Adicionar webhook com campo da URL do webhook vazio

Passo 3 — Colar a URL do webhook

Cole a URL fornecida pela sua ferramenta no campo URL do Webhook. Ela precisa começar com https:// — links só com http:// não são aceitos e a URL não pode ter usuário ou senha.

Campo URL do webhook preenchido com um endpoint de exemplo

Passo 4 — (Opcional) Adicionar headers HTTP

Algumas ferramentas pedem uma chave de autenticação ou token em cada requisição. Clique em + Adicionar header e coloque o nome do header (por exemplo X-Api-Key) e o valor. Você pode adicionar até 20 headers para cada webhook. Depois de salvar, os valores ficam protegidos e não aparecem mais — vai precisar digitar de novo se quiser mudar.

Seção de headers HTTP com nomes e valores preenchidos

Passo 5 — Salvar

Clique em Salvar webhook. O novo webhook já aparece na lista "Seus webhooks", ativado por padrão. A partir desse momento, toda nova resposta dessa Pesquisa vai ser enviada automaticamente para essa URL.

Webhook salvo aparecendo na lista, alternado lig.ado

Gerenciando seus webhooks

Ativar ou desativar um webhook

Use o botão de alternância ao lado de um webhook para pausar ou retomar quando quiser. Isso não exclui nada — só interrompe (ou volta a liberar) as entregas. Lembre-se de que pausar ou retomar não reenvia nada que tenha chegado enquanto estava pausado.

Webhook alternado desligado na lista

Editar um webhook

Clique em Editar para alterar a URL ou atualizar os Headers. Os valores atuais dos Headers aparecem como bolinhas por questão de segurança — vai precisar digitar de novo se for trocar.

Janela de edição do webhook com valor do header mascarado

Excluir um webhook

Clique no ícone da lixeira ao lado do webhook para remover. O Survio vai pedir confirmação — excluir é permanente e interrompe tudo o que estava conectado, então confira antes se não tem nada importante dependendo desse webhook.

Diálogo de confirmação de exclusão do webhook

Quais Dados um webhook envia?

Toda vez que alguém envia sua Pesquisa, o Survio faz um POST HTTPS para a URL do seu webhook com um corpo em JSON contendo:

  • O tipo do evento (no momento, sempre quando chega uma nova resposta da Pesquisa)

  • O ID da Pesquisa à qual a resposta está associada

  • A resposta completa: um ID único da resposta, o horário do envio, o e-mail do respondente (caso tenha sido coletado), canal de origem (como link direto, e-mail, QR code, janela pop-up), idioma da resposta, quaisquer Parâmetros de URL personalizados (por exemplo UTMs) e as respostas de cada Pergunta

Essa é a mesma estrutura de Dados usada na API do Survio, então se sua ferramenta já entende respostas do Survio, vai entender os payloads dos Webhooks também.

Quantos webhooks posso adicionar?

A quantidade de webhooks por Pesquisa depende do plano:

Plano

Webhooks por Pesquisa

Free

Não disponível

Mini

1

Standard

3

Pro / Business / Enterprise / Custom

10

Webhooks ativos e pausados contam para esse limite — desativar não libera o espaço, só excluindo. As entregas de Webhooks também entram no limite de respostas do seu plano; se acabar o saldo no período, as entregas dos Webhooks pausam automaticamente e voltam no próximo Ciclo de assinatura (mas suas respostas ficam salvas no Survio de qualquer jeito).

Respondeu à sua pergunta?