Messages webhook

Les messages webhook affichent un journal de toutes les notifications webhook sortantes que X4fleet envoie aux systèmes cibles connectés lors de certains événements. La page s'adresse aux dispatcheurs et aux administrateurs et sert à la surveillance de la communication d'interface : vous pouvez consulter le statut d'envoi, examiner les messages individuels en détail, les adapter et les renvoyer si nécessaire, les exporter ou les supprimer.

1. Navigation

Les messages webhook sont accessibles via le menu principal dans la section Surveillance › Messages webhook.

Remarque : L'accès est disponible pour les utilisateurs ayant le rôle Dispatcheur et Administrateur.

2. Tableau récapitulatif

La vue d'ensemble affiche tous les messages webhook envoyés dans un tableau triable chargé page par page. Chaque ligne représente un message webhook.

Colonnes par défaut

Tri

Un clic sur un en-tête de colonne trie la liste par ordre croissant ou décroissant selon cette colonne.

Sélection multiple

Les cases à cocher au début de chaque ligne permettent de marquer plusieurs messages simultanément. Les actions de la barre d'outils «Renvoyer» et «Supprimer» s'appliquent à tous les messages marqués.

3. Plage de dates

Le filtre de plage de dates permet de restreindre la liste à une période (de/à). Seuls les messages dont l'horodatage se situe dans la période sélectionnée sont affichés.

La dernière plage de dates sélectionnée est enregistrée et automatiquement réappliquée lors de la prochaine ouverture de la page.

Remarque : Sur cette page, seule une période unique et bornée (de/à) est possible ; les variantes étendues («avant»/«après») ne sont pas disponibles ici.

4. Zone de groupe

Les messages affichés sont restreints au groupe actuellement actif et à ses sous-groupes. L'option «Groupe actuel uniquement» permet de limiter l'affichage aux messages du groupe actif ; si elle est désactivée, les messages des sous-groupes sont également inclus.

Si le groupe actif est changé via le commutateur de groupe global, le tableau se recharge automatiquement.

Remarque : Pour les groupes de sous-traitants, l'option «Groupe actuel uniquement» ne s'applique pas.

5. Filtres de colonne et recherche rapide

Une ligne de filtre est disponible sous les en-têtes de colonne. Une valeur de recherche peut être saisie par colonne ; la liste se restreint en conséquence.

• Pour les colonnes Statut, Déclencheur tournée et Déclencheur envoi, le filtre est proposé sous forme de liste de sélection avec les valeurs disponibles respectives.
• La colonne Horodatage ne peut pas être filtrée via la ligne de filtre ; pour la restriction temporelle, utilisez la plage de dates (voir Section 3).

De plus, la recherche rapide parcourt la liste affichée sur plusieurs colonnes. Le bouton «Réinitialiser les filtres» supprime à nouveau tous les filtres actifs.

6. Renvoyer des messages (sélection)

Si l'envoi d'un message webhook échoue ou qu'un message doit être redélivré, les messages marqués peuvent être renvoyés directement depuis la barre d'outils.

1. Marquer un ou plusieurs messages dans la liste.
2. Cliquer sur le bouton «Renvoyer» dans la barre d'outils.
3. Les messages sélectionnés sont renvoyés à leur URL cible respective.

Après un envoi réussi, un message de confirmation apparaît.

Remarque : Le bouton n'est actif que tant qu'au moins un message est marqué.

7. Vue détaillée : afficher, modifier, renvoyer

La vue détaillée permet de consulter intégralement, d'adapter et de renvoyer un message webhook individuel. Elle s'ouvre dans une large fenêtre.

La vue détaillée contient :

• Journal / erreurs : Une zone dépliable avec les entrées de journal relatives à la livraison du message. Les éventuels messages d'erreur y sont visibles.
• Message brut : Le contenu complet du message sous forme d'éditeur JSON structuré.
• Données utiles (payload) : Les données utiles transmises sous forme d'un second éditeur JSON structuré.

Les deux éditeurs JSON sont affichés dans une vue de formulaire dépliée et peuvent être modifiés.

Modifier et renvoyer

1. Ouvrir la vue détaillée du message souhaité.
2. Si nécessaire, adapter le contenu du message brut ou des données utiles dans les éditeurs JSON.
3. Cliquer sur le bouton «Envoyer» – le message est renvoyé à l'URL cible avec le contenu actuellement affiché (éventuellement modifié).

Remarque : Les contenus de messages volumineux sont chargés à la demande depuis le stockage lors de l'affichage. Pour des données utiles très volumineuses, l'ouverture de la vue détaillée peut donc prendre un moment.

8. Supprimer des messages

Les messages webhook qui ne sont plus nécessaires peuvent être supprimés directement depuis la vue d'ensemble.

1. Marquer un ou plusieurs messages.
2. Cliquer sur le bouton «Supprimer» dans la barre d'outils.
3. Confirmer la boîte de dialogue de confirmation.

Les messages marqués sont définitivement supprimés du journal.

Attention : La suppression est irréversible. Les messages supprimés ne peuvent pas être restaurés.

9. Export

Les messages webhook peuvent être exportés.

• Le bouton d'export dans la barre d'outils exporte le contenu du tableau actuellement affiché.
• De plus, des exports séparés pour les messages webhook liés aux envois et liés aux tournées sont disponibles.

Lors de l'export, les données utiles associées sont fusionnées. Les sous-envois non pertinents peuvent être exclus selon les paramètres webhook.

Remarque : L'accès aux exports est sécurisé par groupe ; seuls les messages des groupes pour lesquels vous êtes autorisé sont exportés.

10. Disposition du tableau et modèles

Les paramètres de colonnes et de disposition des messages webhook sont enregistrés automatiquement par utilisateur et sont conservés après la déconnexion.

• Sélection de colonnes / disposition : Les fonctions de disposition de la barre d'outils permettent d'afficher et de masquer des colonnes ainsi que d'adapter l'agencement du tableau.
• Modèles : Les modèles enregistrés peuvent être appliqués à la vue actuelle via les boutons correspondants de la barre d'outils, afin de passer rapidement d'une configuration de colonnes et de filtres à une autre.

11. Récapitulatif : actions disponibles