Solucionar problemas de entrega de webhook

O teste funciona, mas a coleção real não

O painel envia um envelope webhook.test assinado. O serviço de coleta atual envia X-Webhook-Secret e um corpo diferente, sem os cabeçalhos HMAC. Um receptor que aceita apenas o formato dashboard rejeitará solicitações de coleta.

Inspecione os cabeçalhos e o corpo da solicitação real no histórico de solicitações privadas do seu destinatário. Configure a autenticação apropriada e o mapeamento de campos para cada formato compatível. Os campos de coleta podem estar no nível superior ou dentro de um objeto de depoimento. Não publique campos privados do cliente durante a depuração.

Nenhuma solicitação chega ao seu destinatário

1. Verifique se o URL do Webhook foi salvo no espaço correto e se o plano do proprietário inclui webhooks.
2. Use um endpoint HTTPS público que aceite POST. Verifique as regras de firewall, os requisitos de login e a ortografia do URL.
3. Escolha Enviar evento de teste e inspecione o histórico do receptor. Uma solicitação entregue com uma etapa de fluxo de trabalho posterior com falha é um problema diferente de nenhuma solicitação chegando.
4. Retorne uma resposta 2xx imediatamente. O remetente do painel assinado expira após 10 segundos e faz até três tentativas no total. Atualmente, as solicitações de coleta não usam o mesmo loop de nova tentativa.

A autenticação falha

Para eventos assinados, verifique os bytes brutos da solicitação antes de analisar JSON, use HMAC SHA-256, verifique o segredo atual e valide o carimbo de data/hora. Um segredo girado ou um relógio de servidor incorreto podem interromper a verificação.

Para solicitações de coleta, valide X-Webhook-Secret em relação ao segredo configurado atualmente. Não tente encontrar Socialjuice-Signature neste formato e nunca desative a autenticação para fazer uma automação funcionar.

Trabalho repetido ou ausente

Desduplicar solicitações assinadas com Socialjuice-Delivery ou o ID do envelope. As solicitações de coleta precisam de um identificador de depoimento estável, como uuid, quando disponível. Confirme se a automação não está em execução uma vez para o teste de conexão e novamente para um envio real.

Nenhum dos caminhos de entrega é uma fila ilimitada ou uma garantia de entrega eventual. Após corrigir o receptor, envie outro teste do dashboard e verifique separadamente o formato adequado. Resenhas importadas e outros caminhos de criação não podem emitir o mesmo evento; inspecionar a rota específica em vez de assumir uma cobertura universal.

Peça ajuda com evidências editadas

Envie ao suporte o horário aproximado, o espaço afetado, o formato de entrega, o status da resposta e uma mensagem de erro editada. Inclua um ID de entrega para eventos assinados, se disponível. Nunca inclua o segredo de assinatura, o valor X-Webhook-Secret, tokens de acesso ou detalhes de contato privado do cliente.