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 s’inscrit sur votre compte SuperSaaS, l’ajouter à une liste de diffusion MailChimp
- Quand un nouvel utilisateur s’inscrit, envoyer un PDF avec vos conditions générales à son adresse e-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, mettre à jour 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 e-mail est envoyé, le rediriger pour l’envoyer via un autre serveur mail
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 avoir besoin de programmer. Les deux proposent une version d’essai et une formule gratuite pour les petits utilisateurs.
Créer des webhooks à partir des exemples proposés devrait être assez simple, mais vous trouverez ci-dessous plus d’informations si vous souhaitez plus de contrôle en filtrant certains événements spécifiques.
→ Nouvel utilisateur vers liste de diffusion MailChimp → Nouveau rendez-vous vers Agenda Google → Nouvelle réservation crée une facture QuickBooks → Nouveau rendez-vous vers filtre e-mailDé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” et “supprimer”. Si vous configurez à la fois “Nouvel utilisateur” et “Utilisateur modifié”, les deux se déclencheront lorsqu’un nouvel utilisateur s’inscrit. Notez que si votre agenda n’exige pas que les utilisateurs s’inscrivent, vous ne verrez jamais un déclencheur “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”, “Placement depuis la liste d’attente”, “Paiement reçu”, etc. (voir la liste complète ci-dessous) |
| Nouveau formulaire indépendant | Se déclenche lorsqu’un formulaire indépendant est rempli. Notez qu’il ne se déclenche pas quand un formulaire est attaché à un rendez-vous ; dans ce cas, c’est le webhook du rendez-vous qui se déclenche. |
| 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é”). |
| E-mail envoyé | Se déclenche pour tous les e-mails envoyés depuis votre compte, y compris ceux de récupération de mot de passe, etc. Utile pour envoyer des mails via votre propre serveur. Les e-mails 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 le webhook correspondant est activé. |
| Achat | Se déclenche quand un utilisateur achète quelque chose dans votre boutique. Se déclenche également si vous créez un achat manuellement. |
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 :
- Envoyer un SMS uniquement lorsqu’un utilisateur est placé depuis la liste d’attente, pas pour chaque modification de rendez-vous
- Informer un enseignant d’une nouvelle réservation uniquement si celui-ci enseigne le cours concerné, en ignorant les autres réservations du même agenda
- Envoyer une notification à la direction uniquement si le montant de la réservation dépasse 100 €
Lorsque vous créez un nouveau webhook, Zapier/Make vous demandera un objet exemple provenant de SuperSaaS. L’objet exemple liste les champs disponibles et un contenu exemple. Les champs envoyés par le webhook dépendent de ceux qui sont activés dans votre compte et de la présence ou non d’un formulaire personnalisé. La plupart des déclencheurs incluent des champs “event” et “role” qui peuvent être utilisés pour filtrer les événements. Par exemple, vous pouvez filtrer uniquement les déclencheurs qui contiennent la valeur “delete” dans le champ “event”.
| Déclencheur | Valeurs possibles du champ “event” |
|---|---|
| Nouvel utilisateur | new |
| Utilisateur modifié | new, change, delete |
| Nouveau rendez-vous | create |
| Rendez-vous modifié | create, edit, place, pending, destroy, restore, approve, revert |
| Nouveau formulaire | new |
| Formulaire modifié | new, change, delete, restore |
| Rappel / Suivi | reminder, follow_up |
| Achat | purchase |
| Champ “role” | 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 inclut un paiement, les champs “status” et “status message” 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 actions que pour les rendez-vous qui ont été remboursés.
Webhooks avec n8n auto-hébergé
Une autre option est d’utiliser les webhooks avec n8n auto-hébergé. Cela nécessite des connaissances techniques significatives et n’est recommandé qu’aux utilisateurs experts de n8n qui maîtrisent des sujets comme la configuration et la sécurisation de serveurs, la configuration de conteneurs et la gestion des ressources applicatives. Pour plus d’informations sur l’utilisation de n8n auto-hébergé, consultez la documentation développeur sur les webhooks.
Configurer manuellement des webhooks (avancé)
Créer un webhook sans utiliser Zapier ou Make requiert des compétences en développement web. Vous pouvez configurer les webhooks pour les envoyer directement à votre propre serveur, ou modifier les données qu’ils contiennent. Vous trouverez plus de détails dans la documentation développeur sur les webhooks.