Webhooks de entrada: disparando automações de fora pra dentro

Webhook de entrada é a porta genérica do Autopilot para o mundo: uma URL única que aceita POST de JSON de qualquer sistema — checkout, formulário, CRM, ERP, ou intermediários como Zapier e Make (não há integração nativa com eles, mas todos sabem chamar uma URL). Quando o payload chega, o Autopilot identifica o contato, salva os campos que você mapeou e executa as ações configuradas.

O que ele consegue fazer

• Identificar ou criar o contato a partir de um campo do payload (normalmente o telefone).
• Mapear campos do JSON para campos do contato ou campos customizados (via caminho no JSON, ex.: data.customer.email).
• Disparar um fluxo para o contato.
• Adicionar ou remover tag.
• Inscrever o contato em uma sequência.

Passo a passo

• 1. Vá em Automação → aba Webhooks de Entrada e crie um novo, com nome e descrição.
• 2. Copie a URL única gerada, no formato https://api.autopilotbr.com/webhook/inbound/SEU-TOKEN.
• 3. Deixe em modo teste e faça o sistema externo enviar um POST real. Os últimos 10 payloads ficam salvos na aba Payloads para você inspecionar a estrutura exata do JSON.
• 4. Na aba Mapeamento, configure o identificador do contato e os campos a salvar.
• 5. Na aba Ações, escolha o que acontece: fluxo, tag e/ou sequência.
• 6. Desative o modo teste. A partir daí, cada POST é processado de verdade (de forma assíncrona — a resposta HTTP é imediata e o processamento acontece em fila).
• 7. Acompanhe tudo na aba Logs, com status e ações executadas por requisição.

Dica de operador: sempre comece pelo modo teste. Mapear campo às cegas é a principal causa de webhook "que não funciona" — com o payload real capturado na aba Payloads, você copia o caminho exato do campo em vez de adivinhar. E se suspeitar que o token vazou, regenere-o na hora (a URL antiga morre imediatamente).

Problemas comuns

• POST retorna sucesso mas nada acontece: o webhook está em modo teste (só armazena o payload) ou está inativo. Confira na aba Geral.
• Contato não é encontrado/criado: o identificador aponta para um campo que não existe naquele payload, ou o telefone vem em formato inesperado. Valide na aba Payloads.
• Ação de fluxo falha: o fluxo referenciado foi excluído ou está inativo. O log da requisição mostra o resultado de cada ação.
• Payloads duplicados: envios idênticos em sequência são detectados por hash de deduplicação — retentativas do sistema externo não executam as ações duas vezes.