O webhook é a forma como plataformas externas enviam dados para a Octa Funnel automaticamente.
Quando um evento acontece na sua plataforma (como uma compra ou geração de PIX), os dados do lead são enviados para a Octa Funnel em tempo real.

O que é um webhook

Um webhook é uma URL que recebe dados automaticamente sempre que um evento ocorre em outro sistema.

Na prática:

  • um lead gera um PIX na sua plataforma de pagamento
  • a plataforma envia os dados (nome, e-mail, telefone, evento) para a URL da Octa Funnel
  • a Octa Funnel recebe, organiza e aciona os fluxos configurados

Tudo acontece automaticamente, sem ação manual.

Como criar uma integração via webhook

Siga o passo a passo:

  1. Acesse Integrações no menu lateral
  2. Encontre a plataforma desejada no grid de integrações
  3. Clique em Configurar
  4. Preencha os campos:
    • Nome da integração — identificação interna
    • Nome do produto — nome do produto ou oferta
    • Tag automática (opcional) — tag aplicada em todos os leads que entrarem
    • Token da plataforma (opcional) — para validação extra de segurança
  5. Clique em Criar integração

O que acontece ao criar

Ao criar a integração, o sistema gera automaticamente:

  • uma URL de webhook exclusiva para essa integração
  • uma pasta dentro de Listas, organizada por evento
  • listas automáticas para cada tipo de evento da plataforma (PIX gerado, compra aprovada, etc.)

Você deve copiar a URL do webhook e configurá-la na plataforma de origem.

URL do webhook

A URL gerada segue o formato:

URL única gerada pra essa integração

Essa URL deve ser cadastrada na plataforma de pagamento ou sistema externo que enviará os dados.

Como os dados são processados

Quando a Octa Funnel recebe um webhook:

  1. Identifica a plataforma — detecta automaticamente de qual plataforma veio o dado
  2. Extrai os dados do lead — nome, e-mail, telefone, produto, valor
  3. Cria ou atualiza o lead — se já existe, atualiza; se é novo, cria
  4. Organiza na lista correta — coloca o lead na lista do evento correspondente
  5. Aplica a tag automática — se configurada
  6. Aciona os fluxos — dispara as automações vinculadas à lista

Eventos recebidos

A Octa Funnel reconhece diversos tipos de eventos, como:

  • compra aprovada — compra aprovada
  • purchase_pending — compra pendente
  • purchase_refused — compra recusada
  • pix_created — PIX gerado
  • billet_created — boleto gerado
  • cart_abandoned — carrinho abandonado
  • checkout_abandoned — checkout abandonado
  • refunded — reembolso
  • chargeback — chargeback
  • subscription_created — assinatura criada
  • subscription_canceled — assinatura cancelada

Cada evento gera uma lista automática dentro da pasta da integração.

Comportamento inteligente

Quando um evento de compra aprovada é recebido:

  • as automações de recuperação daquele lead são encerradas automaticamente
  • isso evita que o lead continue recebendo mensagens de cobrança após já ter pago

Token de segurança

Ao criar a integração, você pode configurar um token da plataforma.

Se configurado, a Octa Funnel valida o token recebido antes de processar o webhook.
Isso garante que apenas a plataforma autorizada possa enviar dados.

Plataformas suportadas

A Octa Funnel possui mais de 145 integrações prontas com plataformas como:

  • PerfectPay, Kiwify, Hotmart, Eduzz, Monetizze
  • Braip, Cakto, Ticto, Hubla, Yampi
  • Shopify, WooCommerce, Nuvemshop
  • MercadoPago, Asaas, PagBank, Pagarme
  • e muitas outras

Cada plataforma possui um parser dedicado que interpreta os dados no formato correto.

Boas práticas

  • sempre teste o webhook após configurar (envie um evento de teste pela plataforma)
  • use nomes descritivos para suas integrações
  • configure tags automáticas para organizar os leads por origem
  • verifique regularmente se os dados estão chegando corretamente

Em resumo

O webhook é a conexão entre sua plataforma e a Octa Funnel.
Uma vez configurado, os leads chegam automaticamente, são organizados em listas e acionam seus fluxos de automação — tudo sem intervenção manual.