Dépanner la livraison du webhook

Le test fonctionne mais pas la véritable collection

Le tableau de bord envoie une enveloppe webhook.test signée. Le service de collecte actuel envoie X-Webhook-Secret et un corps différent, sans les en-têtes HMAC. Un destinataire qui n’accepte que le format tableau de bord rejettera les demandes de recouvrement.

Inspectez les en-têtes et le corps réels de la demande dans l’historique des demandes privées de votre destinataire. Configurez l'authentification et le mappage de champs appropriés pour chaque format pris en charge. Les champs de collecte peuvent se trouver au niveau supérieur ou à l'intérieur d'un objet de témoignage. Ne publiez pas de champs clients privés pendant le débogage.

Aucune demande ne parvient à votre destinataire

1. Vérifiez que l'URL du Webhook a été enregistrée dans le bon espace et que le forfait du propriétaire inclut des webhooks.
2. Utilisez un point de terminaison public HTTPS qui accepte POST. Vérifiez les règles de pare-feu, les exigences de connexion et l'orthographe de l'URL.
3. Choisissez Envoyer un événement de test et inspectez l’historique du récepteur. Une demande livrée avec une étape ultérieure du flux de travail ayant échoué est un problème différent de l'absence de demande arrivant.
4. Renvoyez rapidement une réponse 2xx. L'expéditeur du tableau de bord signé expire après 10 secondes et effectue jusqu'à trois tentatives au total. Les demandes de collecte n’utilisent actuellement pas cette même boucle de nouvelle tentative.

L'authentification échoue

Pour les événements signés, vérifiez les octets bruts de la requête avant d'analyser JSON, utilisez HMAC SHA-256, vérifiez le secret actuel et validez l'horodatage. Une rotation du secret ou une horloge de serveur incorrecte peut interrompre la vérification.

Pour les demandes de collecte, validez X-Webhook-Secret par rapport au secret configuré actuellement. N'essayez pas de trouver Socialjuice-Signature sur ce format, et ne désactivez jamais l'authentification pour faire fonctionner une automatisation.

Travail répété ou manquant

Dédupliquer les demandes signées avec Socialjuice-Delivery ou l'identifiant de l'enveloppe. Les demandes de collecte nécessitent un identifiant de témoignage stable, tel que uuid, le cas échéant. Confirmez que l'automatisation ne s'exécute pas une fois pour le test de connexion et une autre fois pour une véritable soumission.

Aucun des deux modes de livraison ne constitue une file d’attente illimitée ni une garantie de livraison éventuelle. Après avoir corrigé le récepteur, envoyez un autre test du tableau de bord et vérifiez le format approprié séparément. Les avis importés et autres chemins de création peuvent ne pas émettre le même événement ; inspecter l’itinéraire spécifique plutôt que de supposer une couverture universelle.

Demander de l'aide concernant les preuves expurgées

Envoyez à l'assistance l'heure approximative, l'espace concerné, le format de livraison, l'état de la réponse et un message d'erreur rédigé. Incluez un identifiant de livraison pour les événements signés, si disponible. N'incluez jamais le secret de signature, la valeur X-Webhook-Secret, les jetons d'accès ou les coordonnées privées du client.