adsquiz

Webhook

Configurar a integração Webhook no AdsQuiz

Um webhook é uma tecnologia que envia dados automaticamente de um sistema para outro no momento em que ocorre um determinado evento. Dito de forma simples, é uma forma de levar dados do ponto A ao ponto B sem trabalho manual. No AdsQuiz, o webhook é acionado sempre que um utilizador envia um pedido no quiz e envia automaticamente todos os dados para o serviço que indicar.

Um webhook é uma ferramenta universal que pode ligar-se a qualquer serviço que aceite dados através de um URL. Se o serviço de que precisa não estiver na lista padrão de integrações diretas do AdsQuiz, um webhook resolve o problema.

O que é enviado pelo webhook

Sempre que chega um lead, o webhook envia automaticamente:

  • o nome do utilizador
  • o número de telefone
  • o e-mail
  • as respostas a todas as perguntas do quiz
  • as etiquetas UTM para acompanhar a origem do tráfego

O método de envio é POST.

📌 Exemplo: enviar notificações de novos leads para o Slack via webhook

Vejamos a configuração com um exemplo concreto – enviar automaticamente notificações de novos pedidos do quiz para um canal do Slack. É útil se a sua equipa comercial usa o Slack e quer receber de imediato mensagens sobre novos leads sem verificar o CRM ou o e-mail. Da mesma forma, pode configurar o envio para qualquer outro serviço que suporte Incoming Webhooks.

⚙️ Passo 1. Abra as configurações de integração no AdsQuiz

Aceda a: Configurações do quiz → Integrações → Webhook.

No campo da integração tem de colar o URL do webhook que vai obter no Slack.

⚙️ Passo 2. Crie um Incoming Webhook no Slack

Abra a sua conta Slack e aceda às definições do espaço de trabalho. Encontre a secção de aplicações e abra «Incoming Webhooks». Se a aplicação ainda não estiver ligada, adicione-a ao espaço de trabalho.

Depois de ligada, clique em «Add New Webhook to Workspace». Escolha o canal para as notificações de novos leads – por exemplo #new-requests ou #quiz-leads.

💡 Dica: Crie no Slack um canal só para as notificações do quiz – por exemplo #leads-quiz. Assim os gestores veem os novos pedidos de imediato, sem os misturar com outras mensagens.

Depois de confirmar, o Slack gera um URL de webhook único – copie-o.

⚙️ Passo 3. Cole o URL do webhook no AdsQuiz

Volte às configurações de integração no AdsQuiz e cole o URL do webhook no campo. Clique em «Guardar» e ative a integração.

⚙️ Passo 4. Verifique a ligação

Nas configurações de integração do AdsQuiz, clique em «Testar» – o sistema reenvia para o Slack um dos últimos 10 pedidos sem ter de fazer o quiz novamente. Depois, aceda ao canal do Slack que escolheu ao configurar o webhook e confirme que apareceu uma mensagem com os dados do lead.

Se a mensagem chegou corretamente, a integração funciona e todos os novos pedidos do quiz serão enviados automaticamente para o Slack.

💡 Importante: os envios de teste com o botão «Testar» não gastam o seu saldo de leads – use esta função para verificar e depurar a integração sem limites.

⚙️ Passo 5. Configure o formato da mensagem (se necessário)

Por predefinição, o Slack recebe os dados num formato padrão. Se quiser uma mensagem mais prática e legível – por exemplo, com o nome e o telefone a negrito ou com emojis –, pode fazê-lo nas definições do Incoming Webhook no Slack com o Block Kit Builder.

💡 Dica: Mesmo uma formatação básica facilita muito o trabalho dos gestores. Por exemplo, adicione o título «Novo pedido do quiz» e coloque os dados de contacto num bloco separado – assim a mensagem lê-se num segundo.

❓ Perguntas frequentes

Um webhook pode enviar dados para vários serviços ao mesmo tempo?
Não – um URL de webhook leva a um só serviço. Se precisar de enviar dados para vários serviços ao mesmo tempo, use um serviço intermediário como o Make ou o Zapier. Saiba mais: Configuração do Make

Que dados são enviados pelo webhook?
O webhook envia todos os dados que o utilizador deixou no quiz – nome, telefone, e-mail, respostas a todas as perguntas e etiquetas UTM. O método de envio é POST.

Preciso de conhecimentos técnicos para configurar um webhook?
A configuração básica – colar o URL e guardar – não exige conhecimentos técnicos. 

É seguro enviar dados de leads por webhook?
Sim. Os dados são enviados pelo protocolo seguro HTTPS. Recomendamos não partilhar o URL do webhook com terceiros e renová-lo se suspeitar que foi comprometido.