Webhook
Paramètres des webhooks sortants : configurer et tester des points de terminaison pour les événements d'envois et de tournées, ainsi que mettre en place un e-mail d'avertissement en cas d'échec de livraison.
Dans l'onglet Webhooks des paramètres, vous configurez les webhooks sortants. Avec les webhooks, X4fleet signale automatiquement certains événements – comme les changements de statut des envois ou des tournées – à un système externe (par exemple un système ERP ou client). Dès qu'un événement configuré se produit, X4fleet envoie les données associées à l'adresse enregistrée (URL). Cet onglet s'adresse aux administrateurs qui connectent X4fleet à des systèmes tiers.
Remarque : Toutes les modifications de cet onglet sont appliquées avec les autres paramètres via le bouton d'enregistrement des paramètres.
1. Navigation
Vous trouverez l'onglet Webhooks dans les Paramètres, dans la barre d'onglets de la page des paramètres.
Certaines options (par exemple l'application inter-groupes) ne sont visibles que si vous vous trouvez dans le groupe principal.
2. E-mail d'avertissement en cas d'échec de livraison
Afin que vous ne perdiez pas de données sans vous en apercevoir, X4fleet peut envoyer automatiquement un e-mail d'avertissement en cas d'échec d'envoi d'un webhook.
Activer l'e-mail d'avertissement
- Activez la case à cocher «E-mail d'avertissement actif».
- Dans le champ «E-mail d'avertissement», saisissez l'adresse du destinataire à laquelle la notification doit être envoyée.
- Enregistrez les paramètres.
Si l'envoi d'un webhook échoue par la suite, l'adresse enregistrée reçoit un message d'avertissement correspondant.
Appliquer aux sous-groupes
Si vous vous trouvez dans le groupe principal, l'option «Appliquer aux sous-groupes» est également disponible. Lorsqu'elle est activée, la configuration de l'e-mail d'avertissement s'applique aussi aux groupes subordonnés.
Modifier le modèle de l'e-mail d'avertissement
Vous pouvez adapter le contenu de l'e-mail d'avertissement dans plusieurs langues. Via l'éditeur de texte, vous modifiez le modèle dans les langues disponibles. Avec les boutons d'insertion de l'éditeur, vous pouvez insérer des espaces réservés (variables) dans le texte, qui sont automatiquement remplacés par les valeurs respectives lors de l'envoi.
Remarque : Maintenez le modèle dans toutes les langues requises, afin que les destinataires reçoivent le message d'avertissement dans la langue correcte.
3. Points de terminaison de webhook pour les envois et les tournées
Deux listes distinctes sont disponibles dans l'onglet :
- Webhooks d'envois – points de terminaison déclenchés lors d'événements relatifs aux envois.
- Webhooks de tournées – points de terminaison déclenchés lors d'événements relatifs aux tournées.
Dans les deux listes, vous pouvez ajouter, configurer, tester et supprimer autant de points de terminaison que vous le souhaitez.
Ajouter un point de terminaison
- Dans la liste souhaitée (envois ou tournées), cliquez sur le bouton «+».
- Une nouvelle ligne vide est ajoutée à la liste.
- Configurez la ligne comme décrit dans la section 4.
- Enregistrez les paramètres.
Supprimer un point de terminaison
Via l'icône de suppression de la ligne concernée, vous supprimez à nouveau un point de terminaison de la liste. Enregistrez ensuite les paramètres pour que la modification prenne effet.
4. Configuration d'un point de terminaison
Chaque point de terminaison de webhook est configuré via sa propre ligne avec les champs suivants :
| Champ | Description |
|---|---|
| Actif | Active ou désactive le point de terminaison. Seuls les points de terminaison actifs sont déclenchés. |
| Actif pour les sous-groupes | Applique également le point de terminaison aux groupes subordonnés (visible uniquement dans le groupe principal). |
| Mode pull | Bascule entre le fonctionnement push et pull. En mode pull, le champ URL est masqué, car aucun envoi actif vers une adresse cible n'a lieu. |
| URL | L'adresse cible à laquelle X4fleet envoie les données (uniquement lorsque le mode pull est désactivé). |
| Inclure les envois | Inclut les données des envois dans la charge utile transmise. |
| Inclure les points de transport | Inclut les points de transport (points d'enlèvement/de livraison). |
| Exclure les envois partiels non pertinents | Exclut les envois partiels non pertinents issus des divisions. |
| Déclencheur | Sélection multiple des statuts auxquels le webhook est déclenché (statut d'envoi ou statut de tournée). |
| Type de contenu de la requête | Format des données transmises (Content-Type de la requête). |
| Encoder la charge utile en chaîne de caractères | Transmet la charge utile sous forme de chaîne de caractères encodée. |
| Format de date/heure | Définition du format des indications de date et d'heure dans la charge utile. |
| Nom d'utilisateur | Nom de connexion pour l'authentification sur le système cible. |
| Mot de passe | Mot de passe pour l'authentification sur le système cible. |
| Certificat | Certificat pour une connexion sécurisée au système cible. |
Via le champ Déclencheur, vous définissez à quels changements de statut le point de terminaison est appelé. Pour les webhooks d'envois, les statuts d'envoi sont proposés ; pour les webhooks de tournées, les statuts de tournée.
Remarque : Le champ URL n'est affiché que lorsque le mode pull est désactivé. Activez le mode pull si le système cible récupère lui-même les données au lieu de les recevoir de X4fleet.
5. Tester un point de terminaison
Avant d'utiliser un point de terminaison en production, vous pouvez le tester directement depuis la ligne.
- Configurez la ligne avec les valeurs souhaitées (en particulier l'URL et les identifiants de connexion).
- Cliquez sur le bouton «Tester le webhook» de la ligne concernée.
- X4fleet envoie une requête de test à l'adresse configurée et affiche le résultat.
Vous vérifiez ainsi si l'adresse cible est accessible et si l'authentification fonctionne correctement, sans avoir à attendre un événement réel.
6. Enregistrer
Toutes les configurations de cet onglet – les paramètres de l'e-mail d'avertissement ainsi que les points de terminaison des envois et des tournées – sont enregistrées avec les autres paramètres. Les modifications ne prennent effet qu'après l'enregistrement.
Remarque : Les points de terminaison ajoutés ou supprimés ainsi que les valeurs de champ modifiées ne s'appliquent qu'après l'enregistrement des paramètres.