API webhook WhatsApp pra qualquer gateway
Gateway que você usa não está na lista de integrações nativas? GeekZap aceita qualquer webhook via mapping customizável. Configure os campos JSON e funciona.
Webhook universal por usuário
URL única por usuário (formato `app.geekzap.geekacademy.site/api/webhook/in?token=XXX`). Aceita qualquer payload JSON via POST.
Mapping customizável via UI
Configure quais campos JSON apontam pra phone, email, produto, valor, pix_code, checkout_url. Interface sem código. Salva por mapping.
Eventos canônicos do GeekZap
Mapeia evento do seu gateway pra canônico GeekZap: pix_pending, purchase_approved, purchase_refused, refund, chargeback, subscription_cancel, cart_abandoned.
Webhook test playground
Cola payload exemplo na UI → vê extraído em tempo real → ajusta mapping até bater. Sem precisar disparar webhook real.
Suporta payload array OU object
Gateway envia `data: {...}` ou `data: [{...}]`? GeekZap tenta ambas estruturas via fallback paths.
HMAC signature opcional
Webhook seguro: assina HMAC SHA256 com secret. GeekZap valida antes de processar.
Retry automático
Falha temporária? GeekZap retorna 5xx, gateway retenta. Sem perder evento.
Logs completos pra debug
Cada webhook recebido fica registrado: payload, parse, dispatch, jobs criados. Debug sem mistério.
Perguntas frequentes
Qual formato JSON aceito?
Qualquer formato. Você configura o mapping pra extrair os campos.
Como sei se webhook chegou?
Painel mostra cada evento recebido em tempo real com status.
Posso usar gateway próprio?
Sim. Qualquer sistema que envie webhook HTTP POST funciona.
Tem rate limit?
Sim. 100 req/s por usuário. Suficiente pra qualquer volume real.
Como testo antes de produção?
Webhook test playground na UI. Cola payload exemplo e vê extraído.