Notifications Webhook

La page Notifications Webhook vous permet de vous abonner à des endpoints d'API pour écouter des événements spécifiques et recevoir des notifications à leur sujet.

2844

La page est organisée selon les groupes suivants :

  • Document
  • Classification
  • Média
  • Variant
  • Liaisons
  • Valeur

Quable PIM Événements

Pour chaque groupe, les événements suivants sont disponibles :

EntitéType d'événementDéclencheurs
Classificationsclassification.create
classification.update
classification.delete
Documentsdocument.create
document.update
document.delete
  • link.delete sur chaque liaison déclarée sur l'élément supprimé

  • document.update sur chaque document précédemment lié à l'élément précédent
Liaisonslink.create
  • document.update sur chaque document lié, le cas échéant.

  • media.update sur chaque document lié, le cas échéant.
link.update
  • document.update sur chaque document lié, le cas échéant.

  • media.update sur chaque document lié, le cas échéant.
link.delete
  • document.update sur chaque document lié, le cas échéant.

  • media.update sur chaque document lié, le cas échéant.
Médiamedia.create
media.update
  • document.update sur chaque document lié
media.delete
  • document.update sur chaque document précédemment lié
Valeurs prédéfiniesvalue.create
value.update
  • document.update sur chaque document utilisant cette valeur
value.delete
  • document.update sur chaque document utilisant précédemment cette valeur
Variantsvariant.create
variant.update
  • document.update sur le document parent, le cas échéant.
variant.delete
  • document.update sur le document parent, le cas échéant.

S'abonner à des événements

Pour lancer la réception de notifications par webhook, vous devez vous abonner aux événements d'un groupe .

2184

Sur la droite, cliquez sur le slide d'un événement pour changer son statut en Actif.

👍

Par défaut, tous les événements sont Inactif

Puis, dans la zone de texte située à gauche, saisissez l'URL du endpoint approprié pour recevoir la ou les notifications. Note : L'URL saisie doit être un endpoint HTTPS.

Enfin, dans la zone de texte En-tête d'autorisation, saisissez les informations nécessaires (généralement un jeton de porteur) pour accéder au endpoint spécifié pour l'événement. Remarque : Cette étape n'est pas obligatoire.

Une fois que vous avez saisi toutes les informations relatives à l'abonnement ou aux abonnements, cliquez sur le bouton Sauvegarder pour enregistrer vos modifications.

Désactiver les notifications

A tout moment, vous pouvez désactiver une notification par webhook en cliquant sur le slide switch d'un événement pour changer son statut en Inactif.

142

❗️

Si l'appel d'un webhook échoue trois fois de suite, il est automatiquement désactivé et vous recevrez un courriel pour vous en informer.