Ir para conteúdo principal

Webhooks: envie respostas para as suas outras ferramentas em tempo real

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

Os webhooks permitem que o Survio envie uma resposta de inquérito para qualquer ferramenta que a sua equipa já utiliza — no momento em que alguém a submete. Sem exportações, sem copiar e colar, sem esperar. Assim que uma resposta chega, o Survio envia-a diretamente para o URL que escolher.

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

O que pode fazer com um webhook?

Um webhook é apenas um endereço de entrega. Assim que ligar um, cada nova resposta ao inquérito é enviada automaticamente para lá, em tempo real. O que acontece a seguir depende da ferramenta de destino. Exemplos comuns:

  • Retenção: uma pontuação baixa cria um alerta e uma tarefa no seu CRM, para que alguém possa entrar em contacto no mesmo dia.

  • Crescimento: um lead do seu formulário "Solicitar demonstração" aparece instantaneamente no HubSpot, Salesforce ou em qualquer CRM.

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

  • Suporte: feedback negativo transforma-se automaticamente num ticket no Zendesk ou tarefa no Jira.

  • Análise: cada resposta é enviada para o Google Sheets ou Power BI, assim o seu painel está sempre atualizado.

Webhooks em ação — exemplos de uso apresentados no Survio: Retenção, Crescimento, Proteção da marca, Suporte, Análise

Não tem ninguém para construir isto do seu lado? Use o botão "Obter configuração por especialista" na página de Webhooks — basta dizer à equipa da Survio o que deseja acionar e eles vão configurar, testar e entregar-lhe um webhook funcional. Não é necessário código.

Como adicionar um webhook

Passo 1 — Abra a página de Webhooks

Abra o seu inquérito, aceda a Recolher respostas, depois selecione Webhooks em "Automatizações & Integrações" na barra lateral esquerda.

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

Passo 2 — Clique em "Adicionar webhook"

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

Janela Adicionar webhook com campo Webhook URL vazio

Passo 3 — Cole o URL do Webhook

Cole o URL fornecido pela sua ferramenta no campo Webhook URL. Tem de começar por https:// — endereços http:// não são aceites e o URL não pode conter nome de utilizador ou palavra-passe.

Campo Webhook URL preenchido com endpoint de exemplo

Passo 4 — (opcional) Adicionar cabeçalhos HTTP

Algumas ferramentas necessitam de uma chave de autenticação ou token com cada pedido. Clique em + Adicionar cabeçalho, depois insira o nome do cabeçalho (por exemplo X-Api-Key) e o respetivo valor. Pode adicionar até 20 cabeçalhos por webhook. Depois de guardar, os valores dos cabeçalhos ficam mascarados e não podem ser vistos novamente — só podem ser substituídos.

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

Passo 5 — Salvar

Clique em Salvar webhook. O novo webhook aparece na lista "Os seus webhooks", ativado por padrão. A partir desse momento, cada nova resposta a este inquérito será enviada para esse URL automaticamente.

Webhook guardado a aparecer na lista, ativado

Gerir os seus webhooks

Ligar ou desligar um webhook

Use o alternador ao lado do webhook para o pausar ou retomar a qualquer altura. Isso não elimina nada — só interrompe (ou retoma) as entregas. Note que pausar e retomar não reenvia nada que tenha chegado enquanto estava desligado.

Webhook desligado na lista

Editar um webhook

Clique em Editar para alterar o URL ou atualizar cabeçalhos. Os valores existentes dos cabeçalhos aparecem como pontos por segurança — terá de voltar a inserir um valor se o quiser alterar.

Janela Editar webhook com valor do cabeçalho ocultado

Eliminar um webhook

Clique no ícone do caixote do lixo ao lado do webhook para o remover. O Survio irá pedir confirmação — eliminar um webhook é permanente e interrompe imediatamente tudo o que está ligado a ele, portanto assegure-se de que nada importante ainda depende dessa ligação.

Janela de confirmação de eliminação do webhook

Que dados envia um webhook?

Sempre que alguém submeter o seu inquérito, o Survio envia um pedido HTTPS POST ao URL do webhook com um corpo JSON contendo:

  • O tipo de evento (atualmente, é sempre uma nova resposta a inquérito)

  • O ID do inquérito ao qual a resposta pertence

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

Esta é a mesma estrutura de dados usada em toda a API do Survio, portanto se a sua ferramenta já compreende respostas do Survio, também irá compreender os envios dos webhooks.

Quantos webhooks posso adicionar?

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

Plano

Webhooks por inquérito

Free

Indisponível

Mini

1

Standard

3

Pro / Business / Enterprise / Custom

10

Tanto os webhooks ativos como os pausados contam para este limite — desligar não liberta o espaço, só eliminar. As entregas de webhooks também descontam do limite de respostas do seu plano; se ficar sem respostas no período, as entregas param automaticamente e recomeçam no ciclo de faturação seguinte (as respostas continuam a ser registadas no Survio de qualquer forma).

Isto respondeu à sua pergunta?