Nouveauté\u00a0: mise à jour des webhooks
Les webhooks offrent désormais une meilleure configuration, des journaux de livraison, la réexécution des événements et la vérification des signatures. Si vous avez configuré des webhooks avant le 31 août 2026, vos endpoints continuent de fonctionner, mais vous devez les migrer avant le 15 janvier 2027. Vous pouvez suivre les étapes de migration.
Les webhooks vous permettent de recevoir en temps réel des mises à jour 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
- Ouvrez le panneau Webhooks\u00a0:
- Connectez-vous à votre compte Fax.Plus.
- Accédez à la section Integrations sous Paramètres.
- Repérez Webhooks et cliquez sur Manage.
- Ajoutez un endpoint\u00a0:
- Cliquez sur Add Endpoint et saisissez l'URL absolue de votre serveur qui recevra les événements.
- Choisissez les événements à recevoir. Abonnez-vous à tous les événements ou sélectionnez uniquement ceux dont vous avez besoin dans
le catalogue d'événements. -
Facultatif\u00a0: filtrez par numéro de fax. Associez un ou plusieurs de vos numéros de fax pour ne recevoir que les événements concernant
ces numéros.
-
Recevez les mises à jour de statut
- Une fois la configuration terminée, Fax.Plus envoie un webhook à l'URL indiquée chaque fois que le statut d'un fax
change. - Le payload du webhook contient des informations importantes, comme l'ID du fax, le statut, l'horodatage et
les informations sur le destinataire.
Remarque\u00a0: si hook.id est différent de data.id, il s'agit d'une nouvelle tentative d'envoi du fax. Si hook.id est égal à data.id, le fax est envoyé pour la première fois.
- Une fois la configuration terminée, Fax.Plus envoie un webhook à l'URL indiquée chaque fois que le statut d'un fax
- Vérifiez la signature
- Pour chaque endpoint créé, un secret de signature est généré automatiquement. Vous pouvez l'utiliser pour valider chaque requête entrante. En savoir plus sur la vérification des signatures de webhook.
- (Facultatif) Vérifiez les adresses IP d'origine\u00a0:
- Vous pouvez vérifier que les webhooks que vous recevez proviennent bien de notre liste d'adresses IP autorisées\u00a0:
- 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\u00a0:
Dépannage et suivi
- Journaux et observabilité\u00a0: dans le panneau des webhooks, vous pouvez consulter chaque événement et voir s'il a été livré avec succès ou non.
- Nouvelles tentatives\u00a0: en cas d'échec de livraison, les webhooks sont automatiquement renvoyés.
- Réexécution\u00a0: vous pouvez également déclencher manuellement de nouvelles tentatives depuis le panneau, ou rejouer n'importe quel événement passé sur une période de votre choix.