Comment utiliser le service Webhook de systeme.io

Dans cet article, nous allons découvrir comment configurer et utiliser les webhooks dans systeme.io pour optimiser votre activit.

Qu’est-ce qu’un Webhook ?

Les webhooks sont un outil puissant pour automatiser l'envoi des informations entre diverses applications/plateformes, permettant aux utilisateurs de recevoir des notifications en temps réel sur des événements spécifiques. Ils facilitent l'intégration de systeme.io avec d'autres services. Lorsqu'un événement prédéfini se produit, comme une nouvelle commande ou l'ajout d'un abonné, systeme.io envoie automatiquement des données à une URL spécifique. Cela permet d'intégrer votre business avec d'autres outils, d'automatiser des tâches et d'améliorer l'expérience client. Notre service de webhooks offre des fonctionnalités spécifiques, permettant aux développeurs de recevoir des notifications en temps réel de manière transparente et efficace.

Si vous souhaitez en savoir plus sur son fonctionnement, vous pouvez consulter notre documentation.

Configuration des Webhooks dans systeme.io :

Pour configurer un webhook dans votre compte systeme.io, suivez ces étapes simples :

Au niveau de votre compte systeme.io, dirigez-vous vers votre "Photo de profil" et cliquez sur "Paramètres" (1).

Ensuite, cliquez sur "Webhooks" (2), puis sur "Créer" pour commencer à créer un webhook (3).

Saisissez un nom et une URL de Webhook sur laquelle seront envoyées les données. Puis introduisez la clé secrète de votre Webhook.

Le bouton « Actif » permet d'activer ou de désactiver le webhook.

Note : vous devez fournir l'URL du point de terminaison du serveur pour recevoir les requêtes du webhook, nécessitant un point de terminaison HTTPS sécurisé capable de gérer ces requêtes. Il est fortement recommandé d'utiliser HTTPS pour assurer la sécurité et le chiffrement des données.

Par la suite, vous devez sélectionner les événements spécifiques qui déclencheront ce Webhook sur systeme.io, et enfin cliquer sur "Sauvegarder" pour enregistrer la création de votre webhook (4).

Une fois que vous avez complété ces étapes, votre Webhook sera opérationnel, vous permettant ainsi de recevoir des mises à jour en temps réel sur les événements sélectionnés dans votre compte systeme.io.

Types d'événements pris en charge pour vos Webhooks :

Contact créé : Se déclenche lorsqu'un nouveau contact est créé dans votre compte systeme.io.
Tag ajouté à un contact : Se déclenche lorsqu'un tag est ajouté à un contact existant dans votre liste de contacts.
Tag retiré d'un contact : Se déclenche lorsqu'un tag est supprimé d'un contact existant.
Opt-In : Se déclenche lorsqu'un contact s'inscrit via un formulaire d'opt-in.
Nouvelle vente : Se déclenche lorsqu'un client effectue un achat (fonctionne aussi bien avec les tunnels de vente qu'avec les pages créateurs).
Vente annulée : Se déclenche lorsqu'un abonnement est résilié ou qu'un paiement est remboursé (fonctionne aussi bien avec les tunnels de vente qu'avec les pages créateurs).

Vous pouvez ensuite gérer vos webhooks en consultant leurs journaux, en les supprimant ou en les modifiant selon vos besoins.

Consulter les journaux de vos webhooks

Pour surveiller l'activité de vos webhooks ou résoudre les problèmes liés aux livraisons ayant échoué, vous pouvez facilement consulter les journaux détaillés de vos webhooks.

Pour consulter les journaux, cliquez sur les trois points situé à côté du webhook que vous souhaitez vérifier, puis sélectionnez "Voir le journal" (1).

Deux types de journaux sont disponibles :

Journal des messages (2) :

Celui-ci affiche la liste des événements qui ont déclenché le webhook ainsi que les données envoyées. Vous pouvez notamment consulter :

la date et l'heure de l'événement ;
le type d'événement déclenché ;
l'identifiant unique de l'événement ;
les données transmises dans le webhook.

Vous pouvez cliquer sur l'icône « Détails » pour obtenir plus d'informations sur chaque message.

Journal de livraison (3) :

Cela vous permet de suivre l'état de la livraison de chaque webhook vers votre serveur. Vous pouvez y consulter :

le statut de la livraison ;
la date et l'heure ;
l'identifiant de la livraison ;
le code de réponse renvoyé par votre serveur.

Astuce : vous pouvez cliquer sur le bouton "Copier le journal" situé dans le coin supérieur droit de l'une ou l'autre section pour copier rapidement les données, ce qui s'avère très utile lors du dépannage avec les développeurs.

Que se passe-t-il en cas d'échec de la livraison d'un webhook ?

Les notifications par webhook sont traitées en arrière-plan. Si votre serveur de destination est temporairement indisponible, ne répond pas dans les délais ou renvoie une erreur, systeme.io ne supprime pas immédiatement le webhook.

Dans ce cas, systeme.io tente automatiquement de renvoyer le webhook plusieurs fois :

Une première tentative est effectuée peu après le déclenchement de l'événement.
Si la livraison échoue, le système effectuera jusqu'à 12 tentatives de relance.
L'intervalle entre les tentatives augmente progressivement, avec un délai d'attente maximal d'environ 24 heures entre chaque tentative. Cela signifie que le système continuera d'essayer d'envoyer votre webhook pendant plusieurs jours jusqu'à ce qu'il y parvienne.

En utilisant efficacement les webhooks dans systeme.io, vous pouvez automatiser vos processus, améliorer votre productivité et intégrer facilement systeme.io avec d'autres applications et services.