Ir para conteúdo principal

Webhooks: envie respostas para outras ferramentas em tempo real

Ligue o Survio ao Slack, ao seu CRM, helpdesk ou folhas de cálculo — cada resposta ativa automaticamente uma ação. Guia passo a passo para a configuração.

Os webhooks permitem ao Survio enviar uma resposta ao inquérito diretamente para qualquer ferramenta que a sua equipa já utilize — assim que alguém a submete. Sem exportações, sem cópias, sem esperas. Assim que a resposta é recebida, o Survio envia-a de imediato para o endereço escolhido.

👋 Não é preciso ter conhecimentos técnicos para usar esta funcionalidade. Se não souber por onde começar, basta abrir a página de Webhooks e clicar em Obter configuração especializada — indique o que pretende e a nossa equipa trata de construir, testar e entregar o webhook já a funcionar. Não é necessário programar. Ou, se preferir, contacte diretamente a nossa equipa técnica por e-mail: techsupport@survio.com

Resumindo: assim que chega uma resposta, o Survio entrega-a instantaneamente em todas as ferramentas ligadas — tudo de uma só vez, em tempo real.

Uma resposta é entregue a todas as ferramentas ligadas ao mesmo tempo — CRM, helpdesk, canal da equipa, painel de controlo

O que pode fazer com um webhook?

Um webhook é simplesmente um endereço de entrega. Depois de ligar um, todas as novas respostas ao inquérito serão enviadas automaticamente para lá. O que acontece depois depende da ferramenta que recebe esses dados. Veja algumas aplicações comuns:

  • Reverter clientes insatisfeitos: uma avaliação negativa alerta a equipa na hora e marca o contacto no CRM — assim é possível agir antes que o cliente manifeste publicamente o descontentamento.

  • Não perder novas oportunidades: um pedido de demonstração vai direto para o CRM (HubSpot, Salesforce, Pipedrive…) assim que é submetido — sem intervenção manual.

  • Proteger a reputação: uma resposta com 1 estrela gera um alerta no Slack, Teams ou por e-mail em segundos, para que nenhuma situação passe despercebida.

  • Gerir reclamações automaticamente: o feedback negativo transforma-se num ticket na Plataforma de suporte.

  • Relatórios sempre atualizados: cada resposta é recebida de imediato numa folha de cálculo, Data warehouse ou Painel de controlo que tiver configurado — os seus relatórios mantêm-se sempre em dia, sem necessidade de exportações manuais. O Survio envia os dados; o painel de controlo deve ser criado ou ligado pelo próprio utilizador.

Veja abaixo exemplos completos de configuração — desde a chegada da resposta, ao que a ferramenta faz com ela, até à ação da equipa:

Satisfação do cliente

Circuito de resgate de detratores: NPS 3/10 → webhook → ticket de helpdesk → equipa → contacto em menos de uma hora → cliente recuperado

Circuito de promotor: NPS 10/10 → webhook → ferramenta de avaliações → convite automático por e-mail → nova avaliação pública

Circuito CRM: resposta → webhook → contacto no CRM atualizado → registo sinalizado → representante comercial recebe tarefa de acompanhamento

Satisfação dos colaboradores

Circuito RH: resposta eNPS → webhook → registo na plataforma RH atualizado → gestor notificado → agendamento de reunião individual

Roteamento por idioma: o langCode da resposta envia-a para a equipa regional correspondente


Como adicionar um webhook

Os webhooks são uma funcionalidade Premium. Se não encontrar a opção descrita abaixo, pode ser necessário fazer upgrade do seu plano.

Para ligar um webhook, só precisa de uma coisa: o URL do endpoint. Trata-se simplesmente do endereço web que a outra ferramenta utiliza para receber os dados. Não é necessário criá-lo manualmente — a ferramenta de destino (Slack, Zapier, Make, n8n, o seu CRM, ou o seu próprio sistema) gera-o para si, e depois só precisa de colar no Survio. Se não souber onde obter, utilize exatamente a opção Obter configuração especializada.

Passo 1 — Abrir a página de Webhooks

Abra o inquérito, aceda a Recolher respostas e selecione Webhooks em “Automatizações & Integrações” no menu à esquerda.

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

Passo 2 — Clicar em “Adicionar um webhook”

Clique em + Adicionar um webhook no canto superior direito. Abre-se uma janela que irá pedir o URL do endpoint — o endereço da ferramenta ou da plataforma de automação (por exemplo, Zapier, Make, n8n ou o seu próprio servidor) para onde o Survio enviará os dados da resposta.

Janela de Adicionar um webhook com o campo URL do Webhook vazio

Passo 3 — Colar o URL do webhook

Cole o URL fornecido pela ferramenta no campo URL do Webhook.

O URL deve começar por https:// — as ligações http:// não são aceites, e o URL não pode conter nome de utilizador ou palavra-passe.

Campo URL do Webhook preenchido com exemplo de endpoint

Passo 4 — (Opcional) Adicionar cabeçalhos HTTP

Algumas ferramentas exigem uma chave de autenticação ou token enviado com cada pedido. Clique em + Adicionar cabeçalho, preencha o nome do cabeçalho (por exemplo, X-Api-Key) e o respetivo valor. Pode adicionar até 20 cabeçalhos por webhook. Ao guardar, os valores ficam ocultos por segurança — só podem ser substituídos.

Não tem a certeza se precisa desta opção? A maioria dos utilizadores não precisa. Só adicione um cabeçalho se a ferramenta de destino pedir explicitamente uma chave API ou token para autenticação — por exemplo, um cabeçalho chamado X-Api-Key com o valor secreto indicado. Em caso de dúvida, deixe em branco ou confirme com o responsável da ferramenta.

Secção de cabeçalhos HTTP com nome e valor preenchidos

Passo 5 — Salvar

Clique em Salvar webhook. O novo webhook será incluído na lista “Os seus webhooks”, já ativado por padrão. A partir deste momento, todas as novas respostas a este inquérito serão enviadas de forma automática para esse URL.

Webhook salvo a aparecer na lista, ativado

Gerir os seus webhooks

Ativar ou desativar um webhook

Use o alternador junto ao webhook para o pausar ou retomar a qualquer momento. Não elimina nada — apenas interrompe (ou volta a ativar) as entregas. Atenção: pausar e retomar não reenvia respostas que tenham chegado enquanto estava parado.

Webhook desativado na lista

Editar um webhook

Clique em Editar para modificar o URL ou atualizar cabeçalhos. Os valores dos cabeçalhos existentes aparecem sempre ocultos por motivos de segurança — para alterar será preciso inserir um novo valor.

Janela de edição de webhook com valores dos cabeçalhos mascarados

Eliminar um webhook

Clique no ícone de reciclagem (lixo) junto ao webhook para o remover.

Eliminar um webhook é irreversível. Não é possível restaurar um webhook eliminado, nem reenviar respostas recebidas enquanto estiver eliminado ou pausado — essas entregas ficam perdidas. Confirme que já não existe nenhuma dependência dessa ligação antes de eliminar.

Diálogo de confirmação de eliminação de webhook

Que dados envia um webhook?

Sempre que alguém submete o inquérito, o Survio envia um pedido HTTPS POST para o URL do Webhook com um corpo JSON contendo:

  • Tipo de evento (neste momento, é sempre uma nova resposta ao inquérito)

  • ID do inquérito ao qual pertence a resposta

  • A resposta completa: um ID de resposta único, data/hora da submissão, e-mail do respondente (se recolhido), canal por onde chegou a resposta (ex: ligação direta, e-mail, código QR, pop-up), idioma da resposta, parâmetros de URL personalizados (como UTM) e as respostas a cada pergunta

Esta estrutura de dados é a mesma da API do Survio, portanto, se a sua ferramenta já interpreta respostas do Survio, irá compreender também os conteúdos via webhook. Exemplo de envio com dados fictícios:

Exemplo de payload JSON do webhook a mostrar eventType, surveyId e a resposta completa em data

Quantos webhooks posso adicionar?

O número de webhooks por inquérito depende do plano:

Plano

Webhooks por inquérito

Free

Não disponível

Mini

1

Standard

3

Pro Business / Enterprise / Custom

10

Webhooks ativos e pausados contam para o limite — só ao eliminar se liberta uma vaga.

As entregas de webhooks também contam para a quota de respostas do plano. Se esgotar as respostas do período, as entregas ficam pausadas até ao próximo ciclo de faturação — as respostas continuam sempre registadas no Survio.

Isto respondeu à sua pergunta?