Meu gateway não tem adaptador: conectando via webhook genérico

Antes de tudo, confira a lista: o Autopilot tem adaptador nativo para Payt, Hotmart, Kiwify, Braip, Eduzz, Monetizze, PerfectPay, Greenn, Pepper, Yampi, Shopify e AppMax. Se sua plataforma está aí, use a integração nativa (Recuperação → Integrações) — é o caminho com melhor resultado. Se não está, este artigo explica honestamente as opções.

Opção 1 (recomendada): webhook de entrada genérico

O webhook de entrada (Automação → Webhooks de Entrada) aceita qualquer JSON de qualquer sistema. Ele não alimenta o motor de recuperação com eventos de pagamento tipados, mas permite montar uma recuperação funcional: identificar o contato pelo telefone do payload, salvar campos e disparar um fluxo ou sequência de mensagens.

• 1. Crie o webhook de entrada e copie a URL única gerada.
• 2. Configure seu gateway para enviar os eventos de venda pendente (boleto gerado, PIX criado) para essa URL.
• 3. Use o modo teste para capturar payloads reais e mapear os campos (telefone, nome, valor).
• 4. Configure a ação: disparar um fluxo de cobrança ou inscrever o contato numa sequência.
• 5. Ative e acompanhe pelos logs.

Limitação honesta: por esse caminho você não tem os recursos específicos do módulo de recuperação, como cancelamento automático do funil quando o pagamento é confirmado ou lembretes de vencimento de boleto. É um fluxo de automação genérico, não um funil de recovery completo.

Opção 2: pedir o adaptador nativo

Adaptadores novos são adicionados conforme demanda. Aqui vale ser transparente: existe uma opção "CUSTOM" na tela de integrações de recuperação, mas ela depende de mapeamento manual e hoje não cobre qualquer formato de payload — não recomendamos contar com ela sozinho. O caminho certo é falar com o suporte informando qual gateway você usa. Detalhe útil: se você criar a integração e apontar o gateway para ela, o Autopilot salva os payloads brutos mesmo sem reconhecê-los, e esses payloads reais aceleram muito a construção do adaptador.

Dica de operador: enquanto o adaptador não existe, rode a Opção 1 para não deixar dinheiro na mesa. Quando o adaptador nativo ficar pronto, migre — e desative o webhook genérico para não disparar cobrança em dobro.

Problemas comuns

• "Meu gateway integra com Zapier/Hotmart/planilha, serve?": não existe integração nativa com Zapier, Google Sheets ou intermediários — mas qualquer ferramenta que consiga fazer um POST de JSON consegue chamar o webhook de entrada genérico.
• Gateway envia form-data em vez de JSON: o webhook de entrada espera JSON. Verifique se o gateway tem opção de formato JSON no postback.
• Cliente pagou e continuou recebendo cobrança: no caminho genérico, o cancelamento não é automático — configure também um webhook para o evento de pagamento com uma ação que remova a tag/sequência de cobrança.