Notifications Webhook

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

La page est organisée selon les groupes suivants :

Documents
Variants
Médias
Liaisons
Classifications
Processus

Quable PIM Événements

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

Entité	Type d'événement	Déclencheurs
Classifications	`classification.create`
	`classification.update`
	`classification.delete`

Documents	`document.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

Liaisons	`link.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édia	`media.create`
	`media.update`	`document.update` sur chaque document lié
	`media.delete`	`document.update` sur chaque document précédemment lié

Valeurs prédéfinies	`value.create`
	`value.update`	`document.update` sur chaque document utilisant cette valeur
	`value.delete`	`document.update` sur chaque document utilisant précédemment cette valeur

Variants	`variant.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.
Processus	`bulk_edit.finish`
	`import.finish`
	`export.finish`

S'abonner à des événements

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

Tout d'abord, donnez un code pour votre configuration.

Sur la droite, cliquez sur l'interrupteur coulissant pour changer son statut en Actif.

Saisissez ensuite l'URL du point d'accès approprié pour recevoir la ou les notifications.
Remarque : l'URL saisie doit être un point de terminaison HTTPS.

Enfin, vous pouvez utiliser le champ de texte En-tête d'autorisation.
Vous pouvez spécifier une valeur qui sera insérée dans l'en-tête d'autorisation lorsque des appels sont effectués depuis Quable vers l'URL que vous venez de spécifier.
La valeur de ce champ n'est pas utilisée par Quable mais transmise à votre système. Cela peut vous permettre de passer une clé ou un jeton que votre système vérifiera à des fins de sécurité…

Une fois que vous avez saisi toutes les informations pour le(s) abonnement(s), cliquez sur le bouton Enregistrer pour sauvegarder 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.

Désactivation automatique

Multiples tentatives et gestion d'erreur

Chaque notification peut être relancée jusqu'à trois fois par notre service.
Au bout de trois tentatives infructueuses, la notification est considérée en erreur.
Les causes de notification infructueuse sont multiples :

Notre service ne reçoit pas de réponse positive (Une réponse HTTP en 2xx)
Notre service ne reçoit pas de réponse dans les 5 secondes

Désactivation

La règle de désactivation se base sur un comptage du nombre d'erreurs, de la façon suivante :

Sur les 7 derniers jours, pour 1 profil de notification webhook, si nous rencontrons plus de 50 erreurs et que le nombre d'erreurs est supérieur au nombre de succès, alors la configuration est désactivée.

Ainsi, si hier, 50000 notifications ont été faites avec succès, mais que ce jour, 100 notifications ont été considérées en erreur, la configuration du webhook ne sera pas désactivée.

Lors de la désactivation, un email est envoyé aux administrateurs.