Intégrations

Demandes d'intégration

Consulter le journal des échanges avec les services externes (paiements, webhooks reçus) et relancer une demande en échec.

Demandes d'intégration

Une Demande d'Intégration est une trace d'un échange entre votre site et un service externe. Les applications de Dokos en créent une, par exemple, pour un paiement en ligne ou pour un webhook reçu d'une passerelle de paiement. Vous ne créez pas ces documents vous-même : vous les consultez pour comprendre un échec.

Ne confondez pas avec le Webhook, qui envoie des données depuis votre site vers un autre service.

Consulter les demandes

  1. Ouvrez la recherche (Ctrl+K) et saisissez Demande d'Intégration.
  2. Filtrez la liste sur le Statut ou le Service (par exemple le nom de la passerelle de paiement).
  3. Ouvrez une demande pour lire son contenu.

Champs

ChampContenu
ServiceService externe concerné.
StatutEn file d'attente, Autorisé, Terminé, Annulé, Échec ou Non géré.
Description de la demandeType d'échange, par exemple Webhook.
S'agit-il d'une demande à distance ?Coché quand la demande vient du service externe (webhook reçu).
ID de la demandeIdentifiant donné par le service externe.
URLAdresse appelée.
Données de la requête / En-têtes de requêtesContenu envoyé ou reçu, au format JSON.
Résultat / En-têtes de réponseRéponse du service.
ErreurMessage d'erreur. Si c'est une trace Python, elle s'affiche en rouge en haut du formulaire.
Type de document de référence / Nom du document de référenceDocument Dokos lié, par exemple une demande de paiement.
Type de document du service, ID du document du service, Statut du serviceRéférences de l'objet chez le service externe.

Actions sur une demande

Le menu Actions du formulaire propose :

  • Changer le statut à 'Terminé' : marque une demande comme traitée, quand vous l'avez réglée à la main.
  • Réessayer de traiter le webhook : relance le traitement d'un webhook reçu qui n'est pas terminé.
  • Réinitialiser ce webhook : pour un webhook terminé, remet le statut à En file d'attente et efface la référence et l'erreur.

Les deux actions sur les webhooks ne s'affichent que pour une Description de la demande Webhook ou Subscription Notification.

Conservation

Les demandes d'intégration sont supprimées après 90 jours par défaut. Vous pouvez changer ce délai dans les Paramètres des journaux.

Le nombre de demandes en Échec s'affiche dans les notifications des utilisateurs qui ont accès à ce document.

Exemple

Exemple fictif. Un client a payé en ligne, mais sa demande de paiement n'est pas marquée comme payée.

  1. Ouvrez la liste Demande d'Intégration et filtrez sur le Statut Échec.
  2. Ouvrez la demande dont le Nom du document de référence est la demande de paiement du client.
  3. Lisez le champ Erreur, corrigez la cause (par exemple une clé d'API expirée).
  4. Cliquez sur Actions > Réessayer de traiter le webhook.