Ajouter un Webhook dans Wedof

Une fois votre endpoint créé, vous pouvez ajouter le Webhook correspondant à Wedof.

Accéder à la création de Webhook

Pour cela, rendez-vous sur votre compte Wedof et ouvrez le menu "Mes applications" :

Activez ensuite l'Application "Webhooks" :

Cliquez sur "Nouveau" pour ouvrir le formulaire de création de Webhook :

Ajouter le Webhook

Voici les champs à remplir pour ajouter le Webhook :

• URL : (obligatoire) URL complète du endpoint.
• Secret : (optionnel) mot de passe connu de Wedof et du endpoint qui sert à générer le code d'authentification de message.
• Ignorer SSL : (optionnel) ignorer les problèmes de certificat SSL (par ex. si votre certificat est auto-signé).
• Événements : (obligatoire) événements qui déclencheront l'appel du endpoint.

Il est également possible de créer un Webhook depuis l'API.

Gestion du Webhook

Les Webhooks peuvent être gérés dans l'interface de Wedof depuis l'Application Webhooks ainsi que depuis l'API.

Activation / désactivation

Depuis la liste des Webhooks, vous pouvez activer / désactiver chaque Webhook. Un Webhook désactivé n'envoie aucune requête au endpoint quand l'événement associé survient.

Par défaut, le Webhook est activé dès sa création.

ATTENTION, pour éviter la surcharge des services, un Webhook peut être désactivé automatiquement par Wedof après un trop grand nombre d'erreurs (par ex. le endpoint est injoignable ou renvoie un code d'erreur HTTP).

Une fois qu'un Webhook est désactivé, les événements associés ne sont plus écoutés et les deliveries ne sont pas sauvegardés, il est donc impossible de les rejouer.

Vous pouvez désactiver un Webhook directement depuis le endpoint en renvoyant le code HTTP 410.

Modification et suppression

Vous pouvez accéder au formulaire de modification depuis la liste des Webhooks. Tous les attributs sont modifiables sauf l'URL, en cas de changement d'URL, il faudra donc en créer un nouveau et désactiver l'ancien.

Un Webhook peut également être supprimé, mais attention, c'est irréversible. Aussi, dans le doute, vous pouvez juste le désactiver.

Deliveries

Chaque envoi de données à votre endpoint au travers d'un Webhook est tracé dans Wedof sous la forme d'un delivery.

La liste des deliveries est disponibles dans le détail du Webhook.

Chaque delivery possède un identifiant unique (envoyé au endpoint dans un en-tête HTTP) et une date.

Il est possible de renvoyer un delivery, par exemple dans le cas où il n'aurait pas été traité correctement.

Attention, en raison du volume important de données que cela représente, les deliveries sont supprimés automatiquement après 15 jours.