Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Fehlerbehebung bei Webhook- und Connected-Content-Anfragen

Verwenden Sie diese Seite zur Fehlerbehebung häufiger Fehlercodes bei Webhooks und Connected-Content. Informationen zur Einrichtung finden Sie unter Einen Webhook erstellen und Einen API-Aufruf durchführen.

Hier starten: Symptom zuordnen

Ordnen Sie Ihr Symptom in der Tabelle zu, um zum entsprechenden Abschnitt zu navigieren.

Symptom	Gehe zu
`4XX`-Client-Fehler im Nachrichten-Aktivitätsprotokoll	4XX-Fehler
`5XX`-Server-Fehler oder Timeout	5XX-Fehler
`598 Host Unhealthy` oder kurzzeitig angehaltene Anfragen	Erkennung fehlerhafter Hosts
Connected-Content wird in der Vorschau oder beim Senden leer dargestellt	Connected-Content gibt keinen Antworttext zurück
Automatisierte Fehler-E-Mail von Braze	Automatisierte E-Mails und Einträge im Nachrichten-Aktivitätsprotokoll
Webhook-Fehlerereignisse in Currents benötigt	Zusätzliche Fehler-Insights in Braze-Currents

Standardmäßiger Untersuchungspfad

Verwenden Sie diesen Workflow, wenn eine Webhook- oder Connected-Content-Anfrage fehlschlägt oder nicht korrekt gerendert wird. Beginnen Sie bei Schritt 1.

Öffnen Sie das Nachrichten-Aktivitätsprotokoll und notieren Sie den Fehlercode, den Zeitstempel und die Endpunkt-URL.
Überprüfen Sie bei 4XX-Fehlern die Anfrage-Syntax, Authentifizierungs-Header, den URL-Pfad und die HTTP-Methode anhand der Endpunkt-Dokumentation.
Überprüfen Sie bei 5XX-Fehlern den Zustand des Endpunkts, Rate-Limits und ob Braze den Host als fehlerhaft markiert hat.
Zeigen Sie bei Connected-Content eine Vorschau der Nachricht für eine Testnutzer:in an und stellen Sie sicher, dass Liquid nicht zu leeren oder JSON-brechenden Werten aufgelöst wird.
Falls eine Erkennung fehlerhafter Hosts beteiligt sein könnte, lesen Sie den Abschnitt Erkennung fehlerhafter Hosts, bevor Sie den Braze-Support kontaktieren.

4XX-Fehler {#4xx-errors}

4XX-Fehler weisen darauf hin, dass ein Problem mit der an den Endpunkt gesendeten Anfrage vorliegt. Diese Fehler werden in der Regel durch fehlerhafte Anfragen verursacht, einschließlich fehlerhafter Parameter, fehlender Authentifizierungs-Header oder falscher URLs. Beachten Sie, dass diese Fehler auch für den Berichts-Builder gelten.

In der folgenden Tabelle finden Sie Details zu den Fehlercodes und Schritte zur Behebung:

Fehlercode	Bedeutung	Schritte zur Behebung
400 Bad Request	Die Anfrage enthält eine ungültige Syntax.	Überprüfen Sie den Anfrage-Payload auf Syntaxfehler. Stellen Sie sicher, dass alle erforderlichen Felder enthalten und korrekt formatiert sind. Wenn Sie einen JSON-Payload senden, validieren Sie die JSON-Struktur. Wenn Sie Liquid verwenden, um Personalisierungs-Tags in der Webhook-Anfrage einzufügen, überprüfen Sie, dass Liquid nicht zu einem leeren Wert aufgelöst wird oder JSON-brechende Zeichen erzeugt (z. B. nicht-escapte Anführungszeichen). Zeigen Sie eine Vorschau der Nachricht für eine:n Testnutzer:in an, um zu bestätigen, dass die gerenderte Ausgabe gültig ist.
401 Unauthorized	Die Anfrage erfordert eine Nutzer:innen-Authentifizierung.	Überprüfen Sie, ob die korrekten Zugangsdaten (z. B. API-Schlüssel oder Token) in den Anfrage-Headern enthalten sind. Stellen Sie sicher, dass Sie über die erforderlichen Nutzer:innen-Berechtigungen verfügen, um auf den Endpunkt zuzugreifen.
403 Forbidden	Der Endpunkt versteht die Anfrage, verweigert jedoch die Autorisierung.	Überprüfen Sie, ob der API-Schlüssel oder das Token über die erforderlichen Berechtigungen verfügt. Stellen Sie sicher, dass Sie über die erforderlichen Nutzer:innen-Berechtigungen verfügen, um auf den Endpunkt zuzugreifen. Wenn Anfragen konsistent `403` zurückgeben und die Authentifizierung korrekt erscheint, blockiert möglicherweise Ihr Server, API-Gateway oder Ihre WAF die ausgehenden IP-Adressen von Braze. Setzen Sie die IPs für Ihren Braze-Cluster auf die Allowlist. Für Webhooks siehe IP-Allowlisting. Für Connected-Content siehe Connected-Content-IP-Allowlisting.
404 Not Found	Der Endpunkt kann die angeforderte Ressource nicht finden.	Überprüfen Sie die Endpunkt-URL auf Tippfehler oder falsche Pfade. Stellen Sie sicher, dass die Ressource, auf die Sie zugreifen möchten, existiert.
405 Method Not Allowed	Die Anfragemethode ist dem Endpunkt bekannt, wird aber von der Zielressource nicht unterstützt.	Überprüfen Sie die in der Anfrage verwendete HTTP-Methode (DELETE, GET, POST, PUT). Stellen Sie sicher, dass der Endpunkt die von Ihnen verwendete Methode unterstützt.
408 Request Timeout	Der Endpunkt hat bei der Verarbeitung der Anfrage eine Zeitüberschreitung erreicht.	Überprüfen Sie die in der Anfrage verwendete HTTP-Methode (DELETE, GET, POST, PUT). Stellen Sie sicher, dass der Endpunkt die von Ihnen verwendete Methode unterstützt.
409 Conflict	Die Anfrage ist aufgrund eines Konflikts mit dem aktuellen Zustand der Ressource unvollständig.	Überprüfen Sie die in der Anfrage verwendete HTTP-Methode (DELETE, GET, POST, PUT). Stellen Sie sicher, dass der Endpunkt die von Ihnen verwendete Methode unterstützt.
429 Too Many Requests	Es wurden zu viele Anfragen in einem bestimmten Zeitraum gesendet.	Senken Sie das Rate-Limit Ihrer Campaign oder Ihres Canvas-Schritts.

5XX-Fehler {#5xx-errors}

5XX-Fehler weisen darauf hin, dass ein Problem mit dem Endpunkt vorliegt. Diese Fehler werden in der Regel durch serverseitige Probleme verursacht.

Fehlercode	Bedeutung
500 Internal Server Error	Der Endpunkt ist auf eine unerwartete Bedingung gestoßen, die ihn daran gehindert hat, die Anfrage abzuschließen.
502 Bad Gateway	Der Endpunkt hat eine ungültige Antwort vom Upstream-Server erhalten.
503 Service Unavailable	Der Endpunkt kann die Anfrage derzeit aufgrund einer vorübergehenden Überlastung oder Wartung nicht bearbeiten.
504 Gateway Timeout	Der Endpunkt hat keine rechtzeitige Antwort vom Upstream-Server erhalten.
529 Host Overloaded	Der Endpunkt-Host ist überlastet und konnte nicht antworten.
598 Host Unhealthy	Braze hat die Antwort simuliert, da der Endpunkt-Host vorübergehend als fehlerhaft markiert ist. Weitere Informationen finden Sie unter Erkennung fehlerhafter Hosts.
599 Connection Error	Bei Braze ist ein Netzwerk-Verbindungs-Timeout-Fehler aufgetreten, während versucht wurde, eine Verbindung zum Endpunkt herzustellen. Das bedeutet, dass der Endpunkt möglicherweise instabil oder nicht erreichbar ist.

5XX-Fehler beheben

Hier sind Tipps zur Fehlerbehebung bei häufigen 5XX-Fehlern:

Überprüfen Sie die Fehlermeldung auf spezifische Details, die im Nachrichten-Aktivitätsprotokoll verfügbar sind. Gehen Sie für Webhooks zum Abschnitt Performance im Zeitverlauf auf der Braze-Startseite und wählen Sie die Statistiken für Webhooks aus. Dort finden Sie den Zeitstempel, der angibt, wann die Fehler aufgetreten sind.
Stellen Sie sicher, dass Sie nicht zu viele Anfragen senden, die den Endpunkt überlasten. Sie können in Stapeln senden oder die Rate-Limits anpassen, um zu prüfen, ob dies die Fehler reduziert.

Erkennung fehlerhafter Hosts

Braze-Webhooks und Connected-Content verwenden einen Mechanismus zur Erkennung fehlerhafter Hosts, der erkennt, wenn der Ziel-Host eine hohe Rate an erheblicher Verlangsamung oder Überlastung aufweist, die zu Zeitüberschreitungen, zu vielen Anfragen oder anderen Ergebnissen führt, die Braze daran hindern, erfolgreich mit dem Ziel-Endpunkt zu kommunizieren. Er dient als Schutzmaßnahme, um unnötige Last zu reduzieren, die den Ziel-Host belasten könnte. Er dient auch dazu, die Braze-Infrastruktur zu stabilisieren und schnelle Messaging-Geschwindigkeiten aufrechtzuerhalten.

Die Erkennungsschwellenwerte unterscheiden sich zwischen Webhooks und Connected-Content:

Für Webhooks: Wenn die Anzahl der Fehler 3.000 in einem beliebigen gleitenden Zeitfenster von einer Minute überschreitet (pro eindeutiger Kombination aus Hostname und App-Gruppe—nicht pro Endpunkt-Pfad), stoppt Braze vorübergehend Anfragen an den Ziel-Host für eine Minute.
Für Connected-Content: Wenn die Anzahl der Fehler 3.000 überschreitet UND die Fehlerrate 90 % in einem beliebigen gleitenden Zeitfenster von einer Minute übersteigt (pro eindeutiger Kombination aus Hostname und App-Gruppe—nicht pro Endpunkt-Pfad), stoppt Braze vorübergehend Anfragen an den Ziel-Host für eine Minute.

Wenn Anfragen gestoppt werden, simuliert Braze Antworten mit einem 598-Fehlercode, um den schlechten Zustand anzuzeigen. Nach einer Minute nimmt Braze die Anfragen mit voller Geschwindigkeit wieder auf, wenn der Host als gesund erkannt wird. Wenn der Host weiterhin fehlerhaft ist, wartet Braze eine weitere Minute, bevor es erneut versucht.

Die folgenden Fehlercodes tragen zur Fehlerzählung des Detektors für fehlerhafte Hosts bei: 408, 429, 502, 503, 504, 529.

Für Webhooks wiederholt Braze automatisch HTTP-Anfragen, die vom Detektor für fehlerhafte Hosts gestoppt wurden. Diese automatische Wiederholung verwendet exponentielles Backoff und wiederholt nur wenige Male, bevor sie fehlschlägt. Weitere Informationen zu Webhook-Fehlern finden Sie unter Fehler, Wiederholungslogik und Zeitüberschreitungen.

Für Connected-Content fährt Braze, wenn Anfragen an den Ziel-Host vom Detektor für fehlerhafte Hosts gestoppt werden, fort, Nachrichten zu rendern und Ihrer Liquid-Logik zu folgen, als hätte es einen Fehler-Antwortcode erhalten. Wenn Sie sicherstellen möchten, dass diese Connected-Content-Anfragen wiederholt werden, wenn sie vom Detektor für fehlerhafte Hosts gestoppt werden, verwenden Sie die Option :retry. Weitere Informationen zur Option :retry finden Sie unter Connected-Content-Wiederholungen.

Wenn Sie glauben, dass die Erkennung fehlerhafter Hosts Probleme verursacht, kontaktieren Sie den Braze-Support.

Connected-Content gibt keinen Antworttext zurück

Symptom: Ein Connected-Content-Aufruf wird in Ihrer Nachrichtenvorschau oder beim Senden leer gerendert.

Wenn ein Connected-Content-Aufruf in Ihrer Nachrichtenvorschau oder beim Senden leer gerendert wird, prüfen Sie Folgendes:

Geschützte Leerzeichen in der URL: Braze entfernt geschützte Leerzeichen (  oder Unicode U+00A0) aus Connected-Content-URLs, bevor die Anfrage gesendet wird. Wenn Ihre URL aus einem Dokument oder Dashboard-Feld kopiert wurde, das geschützte Leerzeichen zwischen Zeichen eingefügt hat, kann die Anfrage fehlschlagen oder keinen verwendbaren Antworttext zurückgeben. Geben Sie die URL im Klartext erneut ein oder entfernen Sie versteckte Leerzeichen und zeigen Sie dann erneut die Vorschau an.
Weiterleitungsantworten (3xx): Connected-Content folgt keinen Weiterleitungen. Nur 2xx-Antworten werden als erfolgreich behandelt, sodass ein 301 oder 302 leer gerendert werden kann, selbst wenn dieselbe URL in Postman funktioniert. Verwenden Sie die endgültige Ziel-URL oder konfigurieren Sie den Endpunkt so, dass er eine 2xx-Antwort (typischerweise 200) an der von Braze aufgerufenen URL zurückgibt. Siehe Warum schlägt Connected-Content fehl, wenn mein Endpunkt eine Weiterleitung zurückgibt?.
HTTP-Fehler und leere Antworttexte: Bei Statuscodes außerhalb des 2xx-Bereichs oder blockierten Hosts kann Connected-Content einen leeren String rendern. Siehe Einen API-Aufruf durchführen und überprüfen Sie Fehler im Nachrichten-Aktivitätsprotokoll.

Automatisierte E-Mails und Einträge im Nachrichten-Aktivitätsprotokoll

Einrichtung automatisierter E-Mails

Wenn in einem Workspace innerhalb von 24 Stunden mehr als 100.000 Webhook- oder Connected-Content-Endpunkt-Fehler (einschließlich Wiederholungen) auftreten, sendet Braze Ihnen eine E-Mail mit den folgenden Informationen zur Behebung der Fehler.

Name des Workspace
Ein Link zum Canvas oder zur Campaign
Endpunkt-URL
Fehlercode
Zeitpunkt, zu dem der Fehler zuletzt beobachtet wurde
Links zum Nachrichten-Aktivitätsprotokoll und zur zugehörigen Dokumentation

Hinweis

Sie können den Fehlerschwellenwert pro Workspace konfigurieren. Um diesen Schwellenwert anzupassen, kontaktieren Sie den Braze-Support.

Die Endpunkt-Fehler sind:

4XX: 400, 401, 403, 404, 405, 408, 409, 429
5XX: 500, 502, 503, 504, 598, 599

Diese E-Mails werden nur einmal pro Tag auf Workspace-Ebene gesendet. Wenn sich keine Nutzer:innen für diese E-Mails anmelden, benachrichtigt Braze alle Unternehmensadministratoren.

Um sich für den Empfang dieser E-Mails anzumelden, gehen Sie wie folgt vor:

Gehen Sie zu Einstellungen > Admin-Einstellungen > Präferenzen für Benachrichtigungen.
Wählen Sie Connected Content Errors und Webhook Errors im Abschnitt Canvas & Campaigns aus.

Einträge im Nachrichten-Aktivitätsprotokoll

Wenn ein Fehler auftritt, gibt es mindestens einen Eintrag im Nachrichten-Aktivitätsprotokoll, der damit zusammenhängt. Wenn die Anfrage wiederholt wird und schließlich erfolgreich ist, sind diese Details in Currents und der Snowflake-Datenfreigabe verfügbar. Beachten Sie, dass selbst wenn eine Anfrage nach einer Wiederholung schließlich erfolgreich ist, die Fehler dennoch die automatisierte E-Mail auslösen können.

Zusätzliche Fehler-Insights in Braze-Currents

Um die Transparenz bei Webhook-bezogenen Problemen zu erhöhen, streamt Braze detaillierte Webhook-Fehlerereignisse an Currents und die Snowflake-Datenfreigabe. Diese Ereignisse umfassen fehlgeschlagene Webhook-Anfragen (wie HTTP-4xx- oder 5xx-Antworten) und bieten mehr Beobachtbarkeit darüber, wie Webhook-Probleme die Nachrichtenzustellung beeinflussen können. Beachten Sie, dass Fehlerereignisse sowohl terminale Fehler als auch Fehler umfassen, die wiederholt werden.

Hinweis

Connected-Content-Anfragen sind in diesen Webhook-Fehlerereignissen nicht enthalten.

Weitere Informationen finden Sie im Glossar der Nachrichten-Engagement-Ereignisse.

New Stuff!