Configurar e validar um webhook

O resultado esperado é um endpoint HTTPS que valida assinatura, responde rápido, deduplica eventos e processa o payload fora da requisição.

Pré-requisitos

• Endpoint HTTPS acessível no ambiente de homologação.
• Segredo criado e guardado fora do código.
• Armazenamento para deduplicação do evento.
• Fila ou worker para processamento assíncrono.

Passos

1. Abra a operação PATCH /api/wa/instances/{id}/settings na referência da API.
2. Leia o corpo bruto antes de transformar JSON.
3. Calcule e compare a assinatura conforme o contrato publicado.
4. Quando um segredo estiver configurado, rejeite assinatura ausente ou inválida.
5. Deduplicate pelo identificador disponível ou por um digest estável do evento.
6. Responda 2xx rapidamente e processe em fila.

Validação

Teste assinatura válida, assinatura inválida, evento duplicado, timeout e nova tentativa. Nunca registre segredo ou payload completo de cliente. Se a ativação não estiver disponível para a conta, solicite liberação ao suporte.

Próximo passo: diagnosticar erros.