Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Résolution des problèmes de requêtes webhook et de contenu connecté

Utilisez cette page pour résoudre les codes d’erreur courants liés aux webhooks et au contenu connecté. Pour la configuration, consultez Créer un webhook et Effectuer un appel API.

Commencez ici : identifiez votre symptôme

Identifiez votre symptôme dans le tableau pour accéder à la section correspondante.

Symptôme	Accéder à
Erreur client `4XX` dans le journal d’activité des messages	Erreurs 4XX
Erreur serveur `5XX` ou délai d’expiration	Erreurs 5XX
`598 Host Unhealthy` ou requêtes brièvement interrompues	Détection d’hôte non sain
Le contenu connecté s’affiche vide dans la prévisualisation ou l’envoi	Le contenu connecté ne renvoie aucun corps de réponse
E-mail d’erreur automatisé de Braze	E-mails automatisés et entrées du journal d’activité des messages
Besoin d’événements d’échec de webhook dans Currents	Informations supplémentaires sur les échecs dans Braze Currents

Parcours d’investigation standard

Utilisez ce workflow lorsqu’une requête webhook ou de contenu connecté échoue ou s’affiche incorrectement. Commencez à l’étape 1.

Ouvrez le Journal d’activité des messages et notez le code d’erreur, l’horodatage et l’URL de l’endpoint.
Pour les erreurs 4XX, vérifiez la syntaxe de la requête, les en-têtes d’authentification, le chemin de l’URL et la méthode HTTP par rapport à la documentation de l’endpoint.
Pour les erreurs 5XX, vérifiez l’état de l’endpoint, les limites de débit et si Braze a marqué l’hôte comme non sain.
Pour le contenu connecté, prévisualisez le message pour un utilisateur test et confirmez que le Liquid ne produit pas de valeurs vides ou de caractères qui cassent le JSON.
Si la détection d’hôte non sain peut être en cause, consultez Détection d’hôte non sain avant de contacter l’assistance Braze.

Erreurs 4XX {#4xx-errors} {#4xx-errors}

Les erreurs 4XX indiquent un problème avec la requête envoyée à l’endpoint. Ces erreurs sont généralement causées par des requêtes erronées, notamment des paramètres mal formés, des en-têtes d’authentification manquants ou des URL incorrectes. Notez que ces erreurs s’appliquent également au générateur de rapports.

Consultez le tableau suivant pour les détails des codes d’erreur et les étapes de résolution :

Code d'erreur	Signification	Étapes de résolution
400 Bad Request	La syntaxe de la requête est invalide.	Vérifiez le payload de la requête pour détecter d'éventuelles erreurs de syntaxe. Confirmez que tous les champs requis sont inclus et correctement formatés. Si vous envoyez un payload JSON, validez la structure JSON. Si vous utilisez Liquid pour intégrer des balises de personnalisation dans la requête webhook, vérifiez que le Liquid ne produit pas une valeur vide ou des caractères qui cassent le JSON (comme des guillemets non échappés). Prévisualisez le message pour un utilisateur test afin de confirmer que le rendu est valide.
401 Unauthorized	La requête nécessite une authentification de l'utilisateur.	Vérifiez que les identifiants d'authentification corrects (tels que les clés API ou les jetons) sont inclus dans les en-têtes de la requête. Confirmez que vous disposez des autorisations utilisateur nécessaires pour accéder à l'endpoint.
403 Forbidden	L'endpoint comprend la requête mais refuse de l'autoriser.	Vérifiez si la clé API ou le jeton dispose des autorisations requises. Confirmez que vous disposez des autorisations utilisateur nécessaires pour accéder à l'endpoint. Si les requêtes renvoient systématiquement `403` et que l'authentification semble correcte, votre serveur, passerelle API ou WAF bloque peut-être les adresses IP sortantes de Braze. Ajoutez les adresses IP de votre cluster Braze à la liste d'autorisation. Pour les webhooks, consultez Liste d'autorisation IP. Pour le contenu connecté, consultez Liste d'autorisation IP du contenu connecté.
404 Not Found	L'endpoint ne trouve pas la ressource demandée.	Vérifiez l'URL de l'endpoint pour détecter d'éventuelles fautes de frappe ou des chemins incorrects. Confirmez que la ressource à laquelle vous essayez d'accéder existe.
405 Method Not Allowed	La méthode de requête est connue de l'endpoint mais n'est pas prise en charge par la ressource cible.	Vérifiez la méthode HTTP (DELETE, GET, POST, PUT) utilisée dans la requête. Confirmez que l'endpoint prend en charge la méthode que vous utilisez.
408 Request Timeout	L'endpoint a expiré lors du traitement de la requête.	Vérifiez la méthode HTTP (DELETE, GET, POST, PUT) utilisée dans la requête. Confirmez que l'endpoint prend en charge la méthode que vous utilisez.
409 Conflict	La requête est incomplète en raison d'un conflit avec l'état actuel de la ressource.	Vérifiez la méthode HTTP (DELETE, GET, POST, PUT) utilisée dans la requête. Confirmez que l'endpoint prend en charge la méthode que vous utilisez.
429 Too Many Requests	Trop de requêtes ont été envoyées dans un laps de temps donné.	Réduisez la limite de débit de votre campagne ou de votre étape Canvas.

Erreurs 5XX {#5xx-errors} {#5xx-errors}

Les erreurs 5XX indiquent un problème au niveau de l’endpoint. Ces erreurs sont généralement causées par des problèmes côté serveur.

Code d’erreur	Signification
500 Internal Server Error	L’endpoint a rencontré une condition inattendue qui l’a empêché de traiter la requête.
502 Bad Gateway	L’endpoint a reçu une réponse invalide du serveur en amont.
503 Service Unavailable	L’endpoint est actuellement incapable de traiter la requête en raison d’une surcharge temporaire ou d’une maintenance.
504 Gateway Timeout	L’endpoint n’a pas reçu de réponse dans les délais du serveur en amont.
529 Host Overloaded	L’hôte de l’endpoint est surchargé et n’a pas pu répondre.
598 Host Unhealthy	Braze a simulé la réponse car l’hôte de l’endpoint est temporairement marqué comme non sain. Pour plus d’informations, consultez Détection d’hôte non sain.
599 Connection Error	Braze a rencontré une erreur de délai de connexion réseau en essayant d’établir une connexion avec l’endpoint, ce qui signifie que l’endpoint peut être instable ou hors service.

Résolution des erreurs 5XX

Voici des conseils pour résoudre les erreurs 5XX courantes :

Consultez le message d’erreur pour obtenir des détails spécifiques disponibles dans le Journal d’activité des messages. Pour les webhooks, accédez à la section Performance Over Time sur la page d’accueil de Braze et sélectionnez les statistiques pour les webhooks. Vous pourrez y trouver l’horodatage indiquant quand les erreurs se sont produites.
Assurez-vous de ne pas envoyer trop de requêtes qui surchargent l’endpoint. Vous pouvez envoyer par lots ou ajuster la limite de débit pour vérifier si cela réduit les erreurs.

Détection d’hôte non sain

Les webhooks et le contenu connecté de Braze utilisent un mécanisme de détection d’hôte non sain pour détecter lorsque l’hôte cible connaît un taux élevé de lenteurs significatives ou de surcharges entraînant des délais d’expiration, un trop grand nombre de requêtes ou d’autres résultats empêchant Braze de communiquer avec l’endpoint cible. Ce mécanisme agit comme une protection pour réduire la charge inutile qui peut causer des difficultés à l’hôte cible. Il sert également à stabiliser l’infrastructure de Braze et à maintenir des vitesses d’envoi de messages rapides.

Les seuils de détection diffèrent entre les webhooks et le contenu connecté :

Pour les webhooks : si le nombre d’échecs dépasse 3 000 dans une fenêtre glissante d’une minute (par combinaison unique de nom d’hôte et de groupe d’applications—pas par chemin d’endpoint), Braze interrompt temporairement les requêtes vers l’hôte cible pendant une minute.
Pour le contenu connecté : si le nombre d’échecs dépasse 3 000 ET que le taux d’erreur dépasse 90 % dans une fenêtre glissante d’une minute (par combinaison unique de nom d’hôte et de groupe d’applications—pas par chemin d’endpoint), Braze interrompt temporairement les requêtes vers l’hôte cible pendant une minute.

Lorsque les requêtes sont interrompues, Braze simule des réponses avec un code d’erreur 598 pour indiquer le mauvais état de santé. Après une minute, Braze reprend les requêtes à pleine vitesse si l’hôte est considéré comme sain. Si l’hôte est toujours non sain, Braze attend une minute supplémentaire avant de réessayer.

Les codes d’erreur suivants contribuent au compteur d’échecs du détecteur d’hôte non sain : 408, 429, 502, 503, 504, 529.

Pour les webhooks, Braze réessaie automatiquement les requêtes HTTP qui ont été interrompues par le détecteur d’hôte non sain. Cette nouvelle tentative automatique utilise des délais exponentiels et ne réessaie que quelques fois avant d’échouer. Pour plus d’informations sur les erreurs de webhook, consultez Erreurs, logique de nouvelle tentative et délais d’expiration.

Pour le contenu connecté, si les requêtes vers l’hôte cible sont interrompues par le détecteur d’hôte non sain, Braze continue de rendre les messages et de suivre votre logique Liquid comme s’il avait reçu un code de réponse d’erreur. Si vous souhaitez vous assurer que ces requêtes de contenu connecté sont réessayées lorsqu’elles sont interrompues par le détecteur d’hôte non sain, utilisez l’option :retry. Pour plus d’informations sur l’option :retry, consultez Nouvelles tentatives de contenu connecté.

Si vous pensez que la détection d’hôte non sain cause des problèmes, contactez l’assistance Braze.

Le contenu connecté ne renvoie aucun corps de réponse

Symptôme : un appel de contenu connecté s’affiche vide dans la prévisualisation ou l’envoi de votre message.

Si un appel de contenu connecté s’affiche vide dans la prévisualisation ou l’envoi de votre message, vérifiez les points suivants :

Espaces insécables dans l’URL : Braze supprime les espaces insécables (  ou Unicode U+00A0) des URL de contenu connecté avant d’effectuer la requête. Si votre URL a été copiée depuis un document ou un champ du tableau de bord qui a inséré des espaces insécables entre les caractères, la requête peut échouer ou ne renvoyer aucun corps exploitable. Retapez l’URL en texte brut ou supprimez les espaces masqués, puis prévisualisez à nouveau.
Erreurs HTTP et corps vides : pour les codes de statut supérieurs à 300 ou les hôtes bloqués, le contenu connecté peut renvoyer une chaîne vide. Consultez Effectuer un appel API et examinez les échecs dans le Journal d’activité des messages.

E-mails automatisés et entrées du journal d’activité des messages

Configuration des e-mails automatisés

Si vous rencontrez plus de 100 000 erreurs d’endpoint webhook ou de contenu connecté (y compris les nouvelles tentatives) dans un espace de travail sur une période de 24 heures, Braze vous envoie un e-mail contenant les informations suivantes pour résoudre les erreurs.

Nom de l’espace de travail
Un lien vers le Canvas ou la campagne
URL de l’endpoint
Code d’erreur
Heure de la dernière observation de l’erreur
Liens vers le journal d’activité des messages et la documentation associée

Remarque

Vous pouvez configurer le seuil d’erreur par espace de travail. Pour ajuster ce seuil, contactez l’assistance Braze.

Les erreurs d’endpoint sont :

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

Ces e-mails ne sont envoyés qu’une fois par jour au niveau de l’espace de travail. Si aucun utilisateur ne s’inscrit pour recevoir ces e-mails, Braze notifie tous les administrateurs de la société.

Pour vous inscrire afin de recevoir ces e-mails, procédez comme suit :

Accédez à Paramètres > Paramètres d’administration > Préférences de notification.
Sélectionnez Connected Content Errors et Webhook Errors dans la section Canvas & Campaigns.

Entrées du journal d’activité des messages

En cas d’échec, il y a au moins une entrée dans le Journal d’activité des messages qui y est liée. Si la requête est réessayée et finit par réussir, ces détails sont disponibles dans Currents et le partage de données Snowflake. Notez que même si une requête finit par réussir après une nouvelle tentative, les erreurs peuvent toujours déclencher l’e-mail automatisé.

Informations supplémentaires sur les échecs dans Braze Currents

Pour accroître la transparence sur les problèmes liés aux webhooks, Braze diffuse des événements détaillés d’échec de webhook vers Currents et le partage de données Snowflake. Ces événements incluent les requêtes webhook échouées (telles que les réponses HTTP 4xx ou 5xx), offrant une meilleure observabilité sur la manière dont les problèmes de webhook peuvent affecter la distribution des messages. Notez que les événements d’échec incluent à la fois les erreurs terminales et les erreurs en cours de nouvelle tentative.

Remarque

Les requêtes de contenu connecté ne sont pas incluses dans ces événements d’échec de webhook.

Pour plus d’informations, consultez le Glossaire des événements d’engagement liés aux messages.

New Stuff!