Les Webhooks: Pour connecter SuperSaaS à d’autres sites

Les webhooks sont des fonctions de rappel définies par l’utilisateur qui informent d’autres applications ou sites web de ce qui se passe sur votre compte SuperSaaS en temps réel.

Quelques exemples d’utilisation d’un webhook:

Quand un nouvel utilisateur se connecte à votre compte SuperSaaS, l’inscrire à une MailChimp liste de diffusion
Quand un nouvel utilisateur se connecte, envoyer un PDF avec vos Conditions générales à son adresse mail
Quand un nouveau rendez-vous est pris, générer une facture sur Quickbooks ou Freshbooks
Quand un nouveau rendez-vous est pris pour un cours précis, le noter sur l’agenda Google de l’enseignant concerné
Quand un rendez-vous approche, envoyer une notification sur Slack ou directement sur votre smartphone
Quand une place se libère pour un utilisateur en liste d’attente, lui envoyer un SMS
Quand un email est envoyé, le rediriger vers un autre serveur

Configurer automatiquement des webhooks en utilisant Zapier.com ou Make

Vous pouvez utiliser Zapier.com ou Make pour créer directement des liens entre des centaines de sites courants et SuperSaaS, sans vous y connaître en programmation. Les deux sites proposent une version d’essai et une formule gratuite pour débuter.

Créer des webhooks à partir des exemples proposés devrait être assez facile, mais vous trouverez ci-dessous plus d’informations pour filtrer spécifiquement certains événements.

Ajouter un nouvel utilisateur à une liste de diffusion MailChimp

Un nouveau rendez-vous est transmis à l’Agenda Google

Un nouveau rendez-vous crée une facture QuickBooks

Un nouveau rendez-vous envoie un email

Déclencheurs disponibles

Vous pouvez surveiller différents types d’événements. Certains d’entre eux peuvent être définis comme “nouveau” ou “modifié”. L’événement “modifié” inclut toutes les modifications et se déclenche donc aussi pour “nouveau” ou “supprimer”. Si vous configurez “Nouvel utilisateur” et “Utilisateur modifié”, alors les deux se déclencheront lorsqu’un nouvel utilisateur s’inscrit. Notez bien que si votre agenda n’exige pas que les utilisateurs se connectent, vous ne verrez jamais un “Nouvel utilisateur”, seulement un “Nouveau rendez-vous”.

Déclencheur	Déclenché par…
Nouvel utilisateur	Se déclenche quand un nouvel utilisateur s’enregistre sur votre compte
Utilisateur modifié	Se déclenche quand l’utilisateur met à jour ses informations ou que l’administrateur le fait pour lui.
Nouveau rendez-vous	Se déclenche quand un utilisateur ou l’administrateur crée un nouveau rendez-vous sur l’agenda concerné.
Rendez-vous modifié	Se déclenche pour tous les changements possibles à un rendez-vous, y compris “Nouveau”, “Supprimer”, “Mise en liste d’attente”, “Paiement reçu”, etc. (voir la liste complète ci-dessous)
Nouveau formulaire indépendant	Se déclenche lorsqu’un formulaire est rempli de manière indépendante. Notez bien qu’il ne se déclenche pas quand un formulaire est envoyé avec un rendez-vous, car c’est le webhook “Rendez-vous” qui se déclenche alors.
Formulaire indépendant modifié	Se déclenche pour tout changement apporté à un formulaire indépendant (les formulaires intégrés déclencheront un “Rendez-vous modifié” ou “Utilisateur modifié”).
Email envoyé	Se déclenche pour tous les emails envoyés depuis votre compte, y compris ceux de récupération de mot de passe, etc. Utile pour envoyer des mails depuis votre propre serveur. Les emails ne seront plus envoyés par nos soins si ce webhook est activé.
Rappel Suivi	Se déclenche pour les messages de rappel ou de suivi. Ceux-ci ne seront plus envoyés par nos soins si ce webhook est activé.

Filtrer les événements

Lorsque vous connectez deux services à l’aide de Zapier ou de Make, vous pouvez filtrer les événements. Voici quelques exemples d’utilisation des filtres :

Envoyez un SMS uniquement lorsque l’utilisateur est mis sur liste d’attente, à l’exclusion des autres modifications de rendez-vous
Informez un enseignant d’une nouvelle réservation seulement si celui-ci enseigne le cours concerné, à l’exclusion des autres réservations de cet agenda
Envoyez une notification à la direction uniquement si le montant d’une réservation dépasse les 100€

Lorsque vous créez un nouveau webhook, Zapier/Make vous demandera un exemple correspondant pour SuperSaaS. L’exemple donne la liste des champs disponibles et de leur contenu. Les champs envoyés par le webhook dépend de ceux qui sont activés sur votre compte et de la présence ou non d’un formulaire. La plupart des déclencheurs incluent des filtres “événement” et “rôle” pour filtrer les événements. Par exemple, vous pouvez filtrer uniquement les déclencheurs qui contiennent la valeur “supprimer” dans le champ “évènement”.

Déclencheur	Valeurs possibles du champ “événement”
Nouvel utilisateur	nouveau
Utilisateur modifié	nouveau, modifier, supprimer
Nouveau rendez-vous	créer
Rendez-vous modifié	créer, modifier, lieu, en_attente, effacer, restaurer, approuver, rétablir
Nouveau formulaire	nouveau
Formulaire modifié	nouveau, modifier, supprimer, restaurer
Rappel / Suivi	rappel, suivi

Champ “Rôle”	Qui a déclenché l’événement…
0	Anonyme	Non connecté
1		Connecté avec un mot de passe partagé
2		Validé par vérification d’adresse IP
3	Utilisateur normal
4	Superutilisateur
5	Administrateur ou Revendeur
7	Système ou passerelle de paiement

Lorsque vous créez ou modifiez un rendez-vous qui requiert un paiement, les champs “état” et “code d’état” vous permettent de cibler des événements spécifiques en utilisant la liste de tous les codes d’état possibles. Par exemple, vous pouvez mettre en place un filtre pour ne déclencher des messages que pour les rendez-vous qui ont été remboursés.

Configurer manuellement des webhooks (plus difficile)

Créer un webhook sans utiliser Zapier ou Make requiert des connaissances de programmation web. Vous pouvez alors configurer les webhooks pour les relier directement à votre propre serveur, ou modifier leur fonction. Vous trouverez plus de détails dans la documentation correspondante.