Nouveau : les webhooks ont été mis à jour
Les webhooks proposent désormais une meilleure configuration, des journaux de livraison, la relecture des événements et la vérification de signature. Si vous avez configuré des webhooks avant le 31 août 2026, vos points de terminaison fonctionnent toujours, mais vous devez les migrer avant octobre 2026. Vous pouvez suivre les étapes de migration.
Les webhooks vous permettent de recevoir des mises à jour en temps réel sur vos fax envoyés et reçus directement depuis Fax.Plus. En configurant des webhooks, vous pouvez automatiser le suivi de vos transmissions de fax et intégrer les mises à jour de statut à vos systèmes existants.
Configuration des webhooks
- Ouvrir le panneau des webhooks :
- Connectez-vous à votre compte Fax.Plus.
- Accédez à la section Integrations dans Paramètres.
- Repérez Webhooks et cliquez sur Manage.
- Ajouter un point de terminaison :
- Cliquez sur Add Endpoint et saisissez l'URL absolue de votre serveur qui recevra les événements.
- Choisissez les événements que vous souhaitez recevoir. Abonnez-vous à tous les événements, ou sélectionnez uniquement ceux dont vous avez besoin dans
le catalogue d'événements. -
Facultatif : filtrez par numéro de fax. Associez un ou plusieurs de vos numéros de fax pour ne recevoir que les événements relatifs à
ces numéros.
-
Recevoir les mises à jour de statut
- Une fois configuré, Fax.Plus envoie un webhook à l'URL indiquée chaque fois que le statut d'un fax
change. - Le contenu du webhook inclut des informations importantes telles que l'identifiant du fax, le statut, l'horodatage et les
informations sur le destinataire.
Remarque : si hook.id est différent de data.id, cela signifie que le webhook est en cours de nouvelle tentative d'envoi pour ce fax. Si hook.id est égal à data.id, cela indique que le fax est envoyé pour la première fois
- Une fois configuré, Fax.Plus envoie un webhook à l'URL indiquée chaque fois que le statut d'un fax
- Vérifier la signature
- Pour chaque point de terminaison créé, une clé secrète de signature est générée automatiquement ; vous pouvez l'utiliser pour valider chaque requête entrante. Pour en savoir plus, consultez la vérification des signatures de webhook.
- (Facultatif) Vérifier les adresses IP d'origine :
- Vous pouvez vérifier que les webhooks que vous recevez proviennent bien de notre liste d'adresses IP autorisées :
- 52.215.16.239
- 54.216.8.72
- 63.33.109.123
- 2a05:d028:17:8000::/56
- Vous pouvez vérifier que les webhooks que vous recevez proviennent bien de notre liste d'adresses IP autorisées :
Dépannage et surveillance
- Journaux et observabilité : dans le panneau des webhooks, vous pouvez consulter chaque événement et vérifier s'il a été livré avec succès ou non.
- Nouvelles tentatives : en cas d'échec de livraison, les webhooks sont automatiquement renvoyés.
- Relecture : vous pouvez également déclencher manuellement de nouvelles tentatives depuis le panneau, ou relire d'anciens événements sur une période donnée.