Pular para o conteúdo
Oráculo

Configurando webhooks do evento

Webhooks sao uma forma do Oraculo avisar outras ferramentas quando algo acontece. Pense assim: quando um lead se cadastra, o Oraculo pode enviar uma mensagem automatica para outra ferramenta dizendo “ei, tem um lead novo aqui”.

Isso e util para integrar com ferramentas de email, CRM, automacao de mensagens, entre outras.

O que e um webhook na pratica?

Imagine que voce quer que, toda vez que um lead se cadastrar, ele receba automaticamente um email de boas-vindas pelo ActiveCampaign. Sem webhook, voce teria que fazer isso manualmente. Com webhook, o Oraculo avisa o ActiveCampaign na hora, e o email sai sozinho.

Um webhook e basicamente uma URL que recebe dados. Quando o evento acontece, o Oraculo envia as informacoes para essa URL.

Os 3 webhooks do evento

Cada evento tem 3 webhooks que voce pode configurar:

1. Webhook de Captacao

Quando dispara: Toda vez que um lead se cadastra no evento.

Exemplos de uso:

  • Adicionar o lead numa lista de email (ActiveCampaign, Mailchimp)
  • Enviar mensagem de boas-vindas por WhatsApp (via Unnichat, N8N)
  • Criar um contato no CRM

2. Webhook de Pesquisa

Quando dispara: Quando um lead completa a pesquisa de qualificacao.

Exemplos de uso:

  • Mover o lead para uma lista segmentada por qualificacao
  • Enviar mensagem personalizada com base nas respostas
  • Atualizar o contato no CRM com as respostas

3. Webhook de Venda

Quando dispara: Quando uma venda do produto principal e confirmada. Vendas de bump ou ingresso nao disparam este webhook.

Exemplos de uso:

  • Enviar mensagem de parabens pela compra
  • Adicionar o cliente numa lista de compradores
  • Atualizar planilha de vendas

Como configurar

Na criacao do evento

No Passo 4 do wizard de criacao, voce encontra os 3 campos:

Screenshot: [Passo 4 do wizard mostrando os 3 campos de webhook]

Basta colar a URL do webhook em cada campo.

Num evento ja criado

  1. Abra o evento
  2. Na aba Detalhes, clique no botao de edicao
  3. Preencha os campos de webhook
  4. Salve

Screenshot: [Dialog de edicao do evento mostrando os campos de webhook]

De onde pegar a URL do webhook?

Depende da ferramenta que voce usa:

N8N

  1. Crie um workflow novo
  2. Adicione um trigger de tipo Webhook
  3. Copie a URL de producao que o N8N gera
  4. Cole no Oraculo

Zapier

  1. Crie um novo Zap
  2. Escolha o trigger Webhooks by Zapier > Catch Hook
  3. Copie a URL que o Zapier gera
  4. Cole no Oraculo

Unnichat / Ferramentas de WhatsApp

  1. Na ferramenta, crie uma automacao com trigger de webhook
  2. Copie a URL gerada
  3. Cole no Oraculo

ActiveCampaign / Mailchimp / RD Station

Essas ferramentas geralmente nao recebem webhooks diretamente. Use o N8N ou Zapier como intermediario:

Oraculo -> webhook -> N8N -> ActiveCampaign

Testando webhooks

Depois de configurar, voce pode testar se o webhook esta funcionando:

  1. Abra o evento
  2. Na aba Detalhes, na secao de webhooks, clique no botao Testar
  3. O sistema envia dados de teste para a URL configurada
  4. Verifique na ferramenta de destino se os dados chegaram

Screenshot: [Secao de webhooks do evento mostrando o botao de teste ao lado de cada webhook]

Se o teste falhar, verifique:

  • A URL esta correta (copiou completa, sem espacos)?
  • O servico de destino esta online?
  • A ferramenta aceita requisicoes POST?

Dicas

  1. Webhooks sao opcionais — se voce nao usa nenhuma ferramenta externa, nao precisa configurar
  2. Comece pelo webhook de captacao — e o mais util e o primeiro a ter dados
  3. Teste sempre antes de ir ao vivo — um webhook errado pode fazer voce perder dados
  4. O webhook de venda so funciona com produto principal — certifique-se de que o papel do produto esta correto (veja Produtos e papeis)
  5. Use N8N para automacoes complexas — ele e gratuito, poderoso e funciona muito bem com o Oraculo