Webhooks de saída: avisando seus sistemas do que acontece aqui

Webhooks de saída são o jeito de levar dados do Autopilot para fora: cada vez que um evento acontece, o Autopilot faz um POST com JSON para a URL que você indicar. É assim que você alimenta um CRM, um data warehouse ou qualquer automação externa — inclusive ferramentas tipo Zapier ou Make, que aceitam webhooks de entrada (não há integração nativa com elas, mas webhook resolve).

Eventos disponíveis hoje

• message.received — mensagem recebida de um contato
• message.sent — mensagem enviada pela sua operação
• contact.created — contato criado
• contact.updated — contato atualizado

Transparência: a tela também lista conversation.created e conversation.closed, mas esses dois ainda não são disparados pelo sistema. Se o seu caso depende deles, fale com o suporte antes de construir em cima.

Configurando

• 1. Vá em Automação → aba Webhooks e clique para criar.
• 2. Informe nome, URL de destino e selecione os eventos. Pode adicionar headers customizados (ex.: um token que seu sistema exige).
• 3. O Autopilot gera um secret automaticamente — guarde o final exibido; ele assina cada entrega.
• 4. Webhooks nascem em modo teste (não recebem eventos reais). Use o botão de enviar teste para validar seu endpoint e depois desative o modo teste.
• 5. Acompanhe as entregas na aba de logs do webhook, com histórico, taxa de sucesso e tempo médio de resposta.

Formato e segurança

Cada entrega é um POST JSON no formato { "event": "...", "data": {...}, "timestamp": "..." }, com dois headers importantes: X-Webhook-Event (nome do evento) e X-Webhook-Signature (HMAC-SHA256 do corpo, assinado com o secret). Valide a assinatura no seu servidor para garantir que a chamada veio mesmo do Autopilot. Se precisar trocar o secret, use "Regenerar secret" — e atualize seu sistema na hora.

Dica de operador: responda 200 rápido e processe depois. Se seu endpoint ficar falhando em sequência, o circuit breaker desativa o webhook automaticamente para proteger a fila — e você reativa com um clique no reset, na tela do webhook.

Problemas comuns

• Não estou recebendo nada: 90% das vezes o webhook ainda está em modo teste. Desative o modo teste.
• Webhook desativou sozinho: falhas consecutivas acionaram o circuit breaker. Corrija o endpoint e use o reset.
• Entrega falhou e perdi o dado: entregas com falha ficam no log e podem ser reenviadas individualmente (replay).
• Assinatura não bate: calcule o HMAC-SHA256 sobre o corpo JSON exatamente como recebido, usando o secret completo.