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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
