Webhooks de entrada e saída: integrando com seus sistemas

Webhook é como o Autopilot conversa com o resto da sua operação sem ninguém no meio: seu CRM, sua plataforma de pagamento, sua planilha automatizada. São duas direções — saída (o Autopilot avisa seu sistema) e entrada (seu sistema avisa o Autopilot). As duas ficam em Automação: abas Webhooks e Entrada.

Webhooks de saída: o Autopilot te avisa

Você cadastra uma URL do seu sistema e escolhe quais eventos ela recebe:

• message.received / message.sent — mensagem recebida ou enviada
• contact.created / contact.updated — contato criado ou atualizado
• conversation.created / conversation.closed — conversa aberta ou fechada

A URL precisa ser HTTPS — sem exceção, é dado de cliente trafegando. Dá para adicionar headers personalizados (até 20), útil para mandar um token de autenticação que seu sistema valida do outro lado. Todo webhook nasce em modo teste: valide o recebimento antes de ativar de verdade.

Webhooks de entrada: seu sistema avisa o Autopilot

O caminho inverso: o Autopilot gera uma URL exclusiva, seu sistema faz um POST nela (compra aprovada, formulário preenchido, carrinho abandonado) e você configura o que acontece:

• Identificação do contato — você aponta em qual campo do JSON está o telefone, o e-mail e o nome (ex.: data.customer.phone); o Autopilot encontra o contato ou cria um novo
• Mapeamento de campos — leve valores do JSON para campos do contato (ex.: valor da compra → campo personalizado); até 50 mapeamentos
• Ações — dispare um fluxo, adicione ou remova tag, inscreva numa sequência; até 20 ações por webhook

Exemplo clássico: plataforma de pagamento manda o POST de compra aprovada → o Autopilot acha o contato pelo telefone, marca a tag "cliente", remove "carrinho-abandonado" e inscreve na sequência de onboarding. Zero trabalho manual.

Dica de operador: use o modo teste como bancada. No webhook de entrada, cada requisição fica registrada no log com status (na fila, processando, sucesso ou falha) — mande um POST de teste do seu sistema, abra o log e confira se o telefone foi extraído do caminho certo do JSON antes de ligar as ações. Caminho de JSON errado é o erro número 1 de integração.

Problemas comuns

• Webhook de saída recusado no cadastro — a URL precisa começar com https://
• Webhook de entrada não cria o contato — o caminho do telefone (phonePath) não bate com a estrutura real do JSON que seu sistema envia; confira o payload no log
• Eventos chegando duplicados no seu sistema — verifique se não há dois webhooks de saída ativos apontando para a mesma URL com os mesmos eventos
• Ação de sequência não rodou — a sequência apontada precisa estar ativa e com etapas configuradas