Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.raposa.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Visão Geral

Ao conectar a Kiwify com a Raposa, todas as suas vendas, reembolsos e dados de produtos são sincronizados automaticamente. Isso permite que você veja o ROI real de cada campanha e canal de aquisição.
A Raposa recebe os eventos da Kiwify em tempo real e atualiza automaticamente seus dashboards, produtos e métricas de atribuição.

​
Pré-requisitos

  • Conta ativa na Kiwify
  • Pelo menos um produto cadastrado na Kiwify
  • Uma operação criada na Raposa

​
Passo 1 — Gerar a URL do Webhook na Raposa

  1. Acesse a Raposa e vá até Configurações → Integrações ou crie/edite uma Operação
  2. Na seção de Webhooks, clique no card da Kiwify
  3. A Raposa irá gerar automaticamente uma URL única para o seu webhook, no formato:
https://app.raposa.com/api/webhook/kiwify/{seu-id-unico}
  1. Copie essa URL — você vai precisar dela no próximo passo
Essa URL é única para a sua conta e operação. Não compartilhe com terceiros.

​
Passo 2 — Configurar o Webhook na Kiwify

  1. Acesse o painel da Kiwify em dashboard.kiwify.com.br
  2. No menu lateral, vá em Configurações → Webhooks
  3. Clique em “Adicionar Webhook”
  4. Preencha os campos:
    • URL: Cole a URL copiada da Raposa
    • Eventos: Selecione todos os eventos ou, no mínimo:
      • order_approved — Venda aprovada
      • order_refunded — Reembolso
  5. Clique em Salvar
Recomendamos selecionar todos os eventos para que a Raposa tenha a visão completa do ciclo de vida das suas vendas.

​
Passo 3 — Testar a Conexão

  1. Na Kiwify, após salvar o webhook, clique em “Enviar teste” (se disponível)
  2. Na Raposa, volte para a página de integrações e verifique se o status do webhook mudou para Ativo (indicador verde)
  3. Você também pode fazer uma compra de teste na Kiwify para validar o fluxo completo

​
Eventos Suportados

EventoDescriçãoO que a Raposa faz
order_approvedVenda aprovada/pagaRegistra a venda, atualiza receita e contadores do produto
order_createdPedido criadoRegistra o lead/pedido
order_refundedReembolso processadoAtualiza métricas e marca como reembolso
order_completedPedido finalizadoAtualiza status da venda

​
Dados Capturados

A cada evento recebido, a Raposa extrai e armazena:
  • Produto: Nome, ID, valor
  • Cliente: Identificador (para atribuição cross-channel)
  • Valor da venda: Receita bruta
  • Status do pedido: Pago, reembolsado, etc.
  • Data/hora: Timestamp do evento

​
Solução de Problemas

  1. Verifique se a URL está correta (copie novamente da Raposa)
  2. Confirme que o webhook está ativo no painel da Kiwify
  3. Verifique se selecionou os eventos corretos
  1. A Kiwify pode estar enviando um formato inesperado — entre em contato com nosso suporte
  2. Verifique se o produto tem product_id e product_name preenchidos na Kiwify
  1. Aguarde alguns segundos — o processamento é em tempo real mas pode haver um pequeno delay
  2. Verifique se a operação correta está selecionada no painel
  3. Confirme que o webhook está vinculado à operação desejada