Lorsque les livraisons de webhook échouent, il est important que les bonnes personnes soient informées afin qu'elles puissent résoudre rapidement le problème. Vous pouvez désormais configurer un Contact technique dédié pour votre entreprise, garantissant que les notifications liées à l'API sont envoyées à l'équipe responsable de la maintenance de vos intégrations.
Vue d'ensemble
Le Contact technique permet à votre entreprise de définir l'adresse e-mail qui doit recevoir les e-mails de notification API, tels que les échecs de livraison de webhook.
Auparavant, ces notifications étaient envoyées à un destinataire inféré, tel que l'e-mail du partenaire, le propriétaire de l'application OAuth, ou la personne qui a créé l'abonnement webhook. Dans de nombreux cas, ces destinataires n'étaient plus responsables de l'intégration, ce qui a entraîné des problèmes non détectés.
En configurant un Contact technique, vous pouvez vous assurer que les notifications API atteignent l'équipe appropriée et aider à réduire les temps d'arrêt causés par des échecs de webhook non remarqués.
Si aucun Contact technique n'est configuré, le processus de notification continue de fonctionner comme auparavant.
Comment utiliser
- Dans votre barre latérale, allez dans Paramètres
- Ouvrez Configuration avancée
- Sélectionnez Notifications API
- Dans le champ Contact technique, entrez l'adresse e-mail qui doit recevoir les notifications API
- Cliquez sur Enregistrer
Pour supprimer le Contact technique, effacez le champ Contact technique. Une fois supprimé, les notifications suivront le flux de destinataires par défaut.
Si vous ne pouvez pas enregistrer l'adresse e-mail du Contact technique, l'adresse e-mail peut ne pas être dans un format valide. Vérifiez que vous avez entré une adresse e-mail valide et essayez d'enregistrer à nouveau.
Comment les notifications sont envoyées
Lorsqu'une livraison de webhook échoue, Factorial notifie les destinataires dans l'ordre suivant :
- E-mail du partenaire
- Contact technique de l'entreprise (s'il est configuré)
- Propriétaire de l'application OAuth
- Auteur de l'abonnement webhook
- Administrateurs de l'entreprise
Si aucun Contact technique n'a été configuré, cette étape est ignorée et le flux de notifications restant continue sans changement.
Lorsqu'une livraison de webhook atteint son état d'échec final après que toutes les tentatives de réessai ont été épuisées, les administrateurs de l'entreprise continuent de recevoir la notification en tant que dernier recours.
Conseils et meilleures pratiques
- Configurez une adresse e-mail d'équipe partagée (par exemple, la boîte de réception de votre équipe d'ingénierie ou informatique) plutôt qu'une adresse e-mail d'un individu
- Examinez régulièrement le Contact technique configuré pour vous assurer qu'il reste à jour
- Utilisez une boîte aux lettres surveillée afin que les échecs de webhook puissent être traités le plus rapidement possible
FAQ
-
La configuration d'un Contact technique est-elle obligatoire ?
Non. Si vous ne configurez pas de Contact technique, Factorial continue d'utiliser le flux de notification existant sans aucun changement.
-
Qui doit être configuré en tant que Contact technique ?
Nous recommandons d'utiliser une boîte aux lettres partagée surveillée appartenant à l'équipe responsable de la maintenance de vos intégrations API, plutôt qu'une adresse e-mail d'un employé individuel.
-
Ce changement affecte-t-il les abonnements webhook existants ?
Oui. Une fois qu'un Contact technique est configuré, il fait partie de la cascade des destinataires de notification pour les échecs de livraison de webhook. Aucun changement aux abonnements webhook existants n'est nécessaire.
-
Que se passe-t-il si je supprime le Contact technique ?
Le Contact technique est supprimé du flux de notification, et les notifications d'échec de webhook suivent la même cascade de destinataires utilisée avant l'introduction de cette fonctionnalité.