Fehlerbehebung bei der Webhook-Übermittlung
Diagnostizieren Sie Unterschiede zwischen Test und Sammlung, Authentifizierungsfehler, Zeitüberschreitungen und doppelte Arbeit.
Aktualisiert
Auf dieser Seite
Der Test funktioniert, die echte Sammlung jedoch nicht
Das Dashboard sendet einen signierten webhook.test-Umschlag. Der aktuelle Erfassungsdienst sendet X-Webhook-Secret und einen anderen Textkörper ohne die HMAC-Header. Ein Empfänger, der nur das Dashboard-Format akzeptiert, lehnt Inkassoanfragen ab.
Überprüfen Sie die tatsächlichen Anforderungsheader und -texte im privaten Anforderungsverlauf Ihres Empfängers. Konfigurieren Sie die entsprechende Authentifizierung und Feldzuordnung für jedes unterstützte Format. Sammlungsfelder können sich auf der obersten Ebene oder innerhalb eines Testimonial-Objekts befinden. Veröffentlichen Sie beim Debuggen keine privaten Kundenfelder.
Keine Anfrage erreicht Ihren Empfänger
- Überprüfen Sie, ob die Webhook-URL im richtigen Bereich gespeichert wurde und ob der Plan des Eigentümers Webhooks enthält.
- Verwenden Sie einen öffentlichen HTTPS-Endpunkt, der POST akzeptiert. Überprüfen Sie die Firewallregeln, Anmeldeanforderungen und die URL-Rechtschreibung.
- Wählen Sie Testereignis senden und überprüfen Sie den Empfängerverlauf. Eine zugestellte Anfrage mit einem fehlgeschlagenen späteren Workflow-Schritt stellt ein anderes Problem dar als wenn keine Anfrage eintrifft.
- Geben Sie umgehend eine 2xx-Antwort zurück. Der signierte Dashboard-Absender läuft nach 10 Sekunden ab und unternimmt insgesamt bis zu drei Versuche. Sammlungsanforderungen verwenden derzeit nicht dieselbe Wiederholungsschleife.
Die Authentifizierung schlägt fehl
Überprüfen Sie bei signierten Ereignissen die rohen Anforderungsbytes, bevor Sie JSON analysieren, verwenden Sie HMAC SHA-256, überprüfen Sie das aktuelle Geheimnis und validieren Sie den Zeitstempel. Ein gedrehtes Geheimnis oder eine falsche Serveruhr können die Verifizierung beeinträchtigen.
Validieren Sie für Sammlungsanforderungen X-Webhook-Secret anhand des aktuell konfigurierten Geheimnisses. Versuchen Sie nicht, Socialjuice-Signature in diesem Format zu finden, und deaktivieren Sie niemals die Authentifizierung, um eine Automatisierung zum Laufen zu bringen.
Wiederholte oder fehlende Arbeiten
Signierte Anfragen mit Socialjuice-Delivery oder der Umschlag-ID deduplizieren. Abholanfragen benötigen eine stabile Testimonial-ID, wie z. B. uuid, sofern verfügbar. Stellen Sie sicher, dass die Automatisierung nicht einmal für den Verbindungstest und dann noch einmal für eine echte Übermittlung ausgeführt wird.
Keiner der Lieferwege ist eine unbegrenzte Warteschlange oder eine Garantie für eine eventuelle Lieferung. Senden Sie nach der Korrektur des Empfängers einen weiteren Dashboard-Test und prüfen Sie das entsprechende Format separat. Importierte Rezensionen und andere Erstellungspfade geben möglicherweise nicht dasselbe Ereignis aus. Überprüfen Sie die spezifische Route, anstatt von einer allgemeinen Abdeckung auszugehen.
Bitten Sie um Hilfe bei redigierten Beweisen
Senden Sie dem Support die ungefähre Zeit, den betroffenen Arbeitsbereich, das Lieferformat, den Antwortstatus und eine redigierte Fehlermeldung. Geben Sie eine Zustellungs-ID für signierte Ereignisse an, sofern verfügbar. Geben Sie niemals das Signaturgeheimnis, den X-Webhook-Secret-Wert, Zugriffstokens oder private Kundenkontaktdaten an.