Cette page permet d'activer et de régler l'envoi automatique de notifications (webhook) vers un système destinataire. Lorsqu'une application connectée à DyXit détecte un événement — par exemple, avec l'intégration iopole, l'arrivée d'un e-document (facture reçue) — une notification est envoyée automatiquement au système destinataire, qui peut alors réagir sans interroger Business Central en permanence.

À quoi sert un webhook ?

Sans webhook, un système extérieur devrait vérifier en boucle si un nouvel événement est survenu. Avec un webhook, c'est Business Central qui prévient le système destinataire dès qu'un événement se produit. La notification contient l'identifiant de l'élément concerné ; le système destinataire peut ensuite le récupérer.

Avant de commencer

• Disposer d'un rôle d'administrateur dans Business Central.

• Connaître l'application source concernée (un code court, fourni par votre partenaire, par exemple lié à l'intégration installée).

L'authentification entre Business Central et la plateforme DyXit est assurée automatiquement par l'enregistrement d'application réalisé à l'installation : aucune clé n'est à saisir sur cette page.

Étape 1 — Régler les paramètres d'envoi

Les valeurs par défaut conviennent à la plupart des cas. Elles sont ajustables :

ParamètreSignificationDéfaut

Taille du lotNombre de notifications traitées à chaque passage.50

Tentatives max.Nombre d'essais avant abandon d'une notification.8

Base de temporisation (min)Délai de base entre deux essais.3

Temporisation max. (min)Délai maximal entre deux essais.60

Expiration verrou (min)Délai après lequel une notification bloquée est relancée.15

En cas d'indisponibilité momentanée du système destinataire, Business Central réessaie automatiquement, en espaçant les tentatives, jusqu'à « Tentatives max. ». Au-delà, la notification est mise de côté pour vérification manuelle.

Étape 2 — Activer le webhook

Cochez la case Activé. À partir de ce moment, chaque événement pertinent d'une application source configurée génère automatiquement une notification.

Tant que Activé est décoché, aucune notification n'est créée ni envoyée : c'est le réglage à utiliser pour suspendre temporairement les envois.

Étape 3 — Vérifier la tâche planifiée

L'envoi des notifications est assuré par une tâche planifiée (Job Queue). Recherchez « Job Queue Entries » et assurez-vous qu'une entrée dédiée au service webhook est présente et au statut « Ready » (Prête), avec une récurrence de quelques minutes. Si aucune entrée n'existe, contactez votre partenaire d'installation.

Pour aller plus loin

Pour suivre l'état des notifications envoyées, ouvrez la page Webhook Outbox (suivi des notifications). Pour consulter l'historique technique des échanges avec la plateforme, ouvrez le Journal des requêtes API.