Os webhooks permitem que o Survio envie uma resposta ao Inquérito para qualquer ferramenta que a sua equipa já utilize — assim que alguém o submete. Sem exportações, sem copiar e colar, sem esperar. Assim que uma resposta chega, o Survio encaminha-a diretamente para o endereço escolhido.
👋 Não precisa de conhecimentos técnicos para usar isto. Se não souber por onde começar, abra a página de Webhooks e clique em Obter configuração especializada — diga-nos o que pretende, e a nossa equipa vai criar, testar e entregar-lhe um webhook funcional. Não é necessário qualquer código. Ou ligue-se à nossa equipa técnica por e-mail: techsupport@survio.com
Aqui está o conceito resumido: uma resposta chega e o Survio entrega-a a todas as ferramentas que ligou — tudo de uma vez, em tempo real.
O que pode fazer com um webhook?
Um webhook é apenas um endereço de entrega. Assim que fizer a ligação, cada nova Resposta ao inquérito será enviada automaticamente para lá. O que acontece a seguir depende da ferramenta de destino. Alguns dos cenários mais comuns:
Salvar clientes insatisfeitos: uma classificação baixa alerta de imediato a sua equipa e assinala o contacto no CRM — assim pode entrar em contacto e resolver antes que esta pessoa deixe uma avaliação negativa pública.
Não perder potenciais clientes: uma resposta "Pedir demonstração" entra diretamente no seu CRM (HubSpot, Salesforce, Pipedrive…) assim que for submetida — sem registos manuais.
Proteger a reputação da marca: uma resposta de 1 estrela envia um alerta à equipa no Slack, Teams ou e-mail em segundos, para que nada passe despercebido.
Tratar reclamações automaticamente: feedback negativo gera automaticamente um pedido de suporte no seu sistema de suporte ao cliente.
Manter relatórios atualizados: cada resposta é enviada diretamente para uma folha de cálculo, data warehouse ou Painel de controlo de BI definido por si — assim, os seus relatórios permanecem sempre atualizados, sem exportação manual. O Survio envia os Dados; o painel é criado ou ligado por si.
Veja alguns destes cenários na totalidade — desde a chegada da resposta, ao que a ferramenta faz, até à ação da equipa:
Satisfação do cliente
Feedback de colaboradores
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 primeiro.
Para Ligar um webhook só é necessário um URL de endpoint. Este é simplesmente o endereço web onde a sua outra ferramenta recebe Dados de entrada. Não precisa criá-lo — a ferramenta a receber (Slack, Zapier, Make, n8n, CRM ou o seu próprio sistema) gera-o para si e basta colá-lo no Survio. Se não sabe como obter, é exatamente para isso que serve a opção Obter configuração especializada.
Passo 1 — Abrir a página de webhooks
Abra o seu Inquérito, vá até Recolher respostas, depois selecione Webhooks sob “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 uma janela que solicita o URL do endpoint — o endereço da ferramenta ou plataforma de automatização (por ex., Zapier, Make, n8n ou o seu próprio servidor) para onde o Survio deve enviar Os dados das respostas.
Passo 3 — Cole o URL do webhook
Cole o URL que a sua ferramenta forneceu no campo URL do webhook.
O URL Deve começar por https:// — links apenas com http:// não são aceites e o URL não pode conter um nome de utilizador ou palavra-passe.
Passo 4 — (Opcional) Adicionar cabeçalhos HTTP
Algumas ferramentas requerem uma chave de autenticação ou token a enviar em cada pedido. Clique em + Adicionar cabeçalho, depois insira o nome do cabeçalho (por ex., X-Api-Key) e o respetivo valor. Pode adicionar até 20 cabeçalhos por webhook. Uma vez guardados, os valores dos cabeçalhos ficam ocultos e não podem ser consultados novamente — só podem ser substituídos.
Não tem certeza se precisa disto? Na maioria dos casos não é necessário. Adicione um cabeçalho apenas se a ferramenta de destino pedir especificamente uma chave ou token de API para autenticação — por exemplo, um cabeçalho chamado X-Api-Key com um valor secreto fornecido pela ferramenta. Se não souber, deixe em branco ou pergunte a quem gere essa ferramenta.
Passo 5 — Salvar
Clique em Salvar webhook. O seu novo webhook aparece na lista “Os seus webhooks”, ligado por defeito. A partir deste momento, todas as novas Respostas a este inquérito serão enviadas automaticamente para esse URL.
Gerir os seus webhooks
Ativar ou desativar um webhook
Utilize a alternância ao lado de um webhook para o pausar ou retomar a qualquer momento. Isto não elimina nada — apenas interrompe (ou reinicia) as entregas. Note que pausar e retomar não irá reenviar nada que chegou enquanto estava desligado.
Editar um webhook
Clique em Editar para mudar o URL ou atualizar cabeçalhos. Os valores de cabeçalho existentes aparecem ocultos por questões de segurança — será necessário voltar a introduzir o valor se quiser alterá-lo.
Eliminar um webhook
Clique no ícone da lixeira ao lado de um webhook para o remover.
Eliminar um webhook é permanente. Não é possível restaurar um webhook eliminado nem reenviar respostas que chegaram enquanto foi eliminado ou estava pausado — essas entregas perde-as para sempre. Certifique-se de que nenhuma ligação importante depende desta conexão antes de removê-la.
Que dados envia um webhook?
Sempre que alguém submeter o seu Inquérito, o Survio envia um pedido HTTPS POST para o URL do webhook com um corpo JSON contendo:
O tipo de evento (de momento, é sempre uma nova resposta ao inquérito)
O ID do inquérito ao qual pertence a resposta
A resposta completa: um ID de resposta único, data/hora de submissão, o canal através do qual a resposta foi submetida (por ex., ligação direta, e-mail, código QR, janela pop-up), o idioma da resposta, quaisquer Parâmetros de URL personalizados (como etiquetas UTM) e a resposta a cada pergunta
À procura do e-mail do respondente? Consulte-o na resposta da sua pergunta de e-mail ou nos Parâmetros de URL personalizados. O campo de e-mail separado nos dados fica vazio quando o e-mail vem de uma pergunta de e-mail ou de um parâmetro de URL.
Esta é a mesma estrutura de Dados utilizada em toda a API do Survio, então, se a sua ferramenta já compreende as respostas Survio, também vai reconhecer os conteúdos dos webhooks. Eis um exemplo de entrega de Dados:
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 / Customizado | 10 |
Tanto os webhooks ativos como os pausados contam para este limite — pausar não liberta vaga, só eliminar remove da contagem.
Os webhooks não gastam as suas respostas. O limite do seu plano para respostas aplica-se apenas à recolha de respostas. O número de webhooks e o destino dos Dados não afetam esse limite.