Ce guide vous accompagne pas à pas dans la configuration d’un webhook qui envoie des notifications depuis votre compte SuperSaaS vers un canal Slack de votre choix. C’est utile si vous souhaitez suivre l’activité de réservation sur votre agenda dans Slack, être notifié lorsqu’un rendez-vous est sur le point de commencer, ou si vous ou vos collaborateurs devez préparer une salle avant le début d’un rendez-vous, ou la nettoyer après. Un webhook de SuperSaaS vers Slack vous évite de devoir surveiller manuellement votre agenda SuperSaaS, libère votre boîte mail des notifications et rappels de rendez-vous, et peut aider à communiquer l’activité de votre entreprise directement à vos collaborateurs dans Slack.
Vous commencerez la configuration dans Slack en ajoutant l’option pour les webhooks entrants, puis vous passerez à SuperSaaS pour configurer le déclencheur de webhook et créer votre message de notification.
Configuration initiale dans Slack
- Dans Slack, ajoutez l’application « Incoming WebHooks »
- Sélectionnez le canal Slack sur lequel vous souhaitez recevoir les notifications du webhook
- Copiez l’URL fournie par l’application Incoming WebHooks et passez aux étapes dans SuperSaaS ci-dessous
Vous remarquerez peut-être que l’application « Incoming WebHooks » est une application héritée. Cela signifie qu’elle n’est plus mise à jour, mais qu’elle fonctionne toujours pour les besoins de ce guide. Si vous préférez utiliser la méthode plus récente recommandée par Slack, ignorez les étapes précédentes. Naviguez vers le répertoire d’applications pour créer une nouvelle application dans Slack, puis activez les webhooks entrants. Consultez la documentation détaillée de Slack pour un guide complet sur la marche à suivre. Une fois les webhooks entrants activés, vous pourrez générer une URL. Copiez cette URL et passez aux étapes dans SuperSaaS ci-dessous.
Suite de la configuration dans SuperSaaS
- Dans SuperSaaS, accédez à votre tableau de bord administrateur, cliquez sur Intégrations puis sur Webhooks (ou cliquez simplement sur ce lien pour y accéder directement)
- Sous l’en-tête « Nouveau webhook », sélectionnez une action pour déclencher le webhook, ajoutez votre URL et cliquez sur « Créer le webhook »
- Définissez maintenant le payload sur « custom »
- Slack exige que vous ajoutiez le champ « text » dans votre payload. Ajoutez-le avec le message que vous souhaitez inclure dans votre notification Slack. Si vous souhaitez que le message Slack contienne des données spécifiques sur le rendez-vous ou l’utilisateur, saisissez les options de texte automatique correspondantes affichées sous la zone de texte
- Pour confirmer que votre webhook fonctionne, vous pouvez le tester. N’hésitez pas à utiliser l’exemple ci-dessous
Votre payload personnalisé saisi dans SuperSaaS :
{ "text": "$full_name ($email) a créé un nouveau rendez-vous pour le $start" }
La notification Slack qui en résulte :
“Jean Dupont (jean@jean_email.com) a créé un nouveau rendez-vous pour le 2024-08-30 14:00”
Différents types de déclencheurs
Si vous avez déjà utilisé des webhooks, vous savez probablement qu’il existe souvent différents déclencheurs disponibles. Voici trois déclencheurs que vous pourriez vouloir utiliser pour connecter votre compte SuperSaaS à votre espace de travail Slack.
1. Nouveau rendez-vous
Pour recevoir une notification Slack lorsqu’un nouveau rendez-vous est créé, utilisez le déclencheur « Nouveau rendez-vous ». Cela garantit que la notification est envoyée dès que l’utilisateur a pris rendez-vous.
2. Rendez-vous modifié
Ce déclencheur envoie une notification Slack dès qu’un rendez-vous est modifié ou supprimé.
3. Rappels et suivis
Si vous préférez recevoir un rappel lorsqu’un rendez-vous est sur le point de commencer, choisissez le déclencheur « Rappel ». Plutôt que d’envoyer une notification Slack lors de la prise ou modification d’un rendez-vous, la notification sera déclenchée au moment que vous souhaitez. Vous pouvez configurer les paramètres de rappel sous Configurer > Traitement > « Faut-il envoyer un rappel ou un suivi pour une réservation nouvelle ou modifiée ? » pour préciser le délai avant lequel le webhook doit se déclencher.
Note importante : le webhook de rappel remplace tout rappel par e-mail ou SMS que vous auriez pu configurer précédemment. Cela signifie que si vous receviez auparavant des rappels par e-mail ou SMS directement depuis votre compte SuperSaaS, ils seront remplacés par la notification de rappel Slack. Vous pouvez transformer le suivi en un deuxième rappel en utilisant une valeur négative, qui peut être utilisée à la place.
Options alternatives : Pipedream/Zapier/n8n
En plus de relier directement SuperSaaS et Slack, il est également possible d’utiliser un outil d’intégration comme Pipedream, n8n, Make ou Zapier pour connecter SuperSaaS à Slack. Cela nécessite de créer un compte auprès de l’outil d’intégration de votre choix, et requiert un abonnement payant si vous dépassez leur niveau gratuit.
L’avantage d’utiliser un intermédiaire est une flexibilité accrue, car vous pouvez filtrer vos webhooks. Par exemple : « Notifiez-moi via WhatsApp si un rendez-vous est modifié dans l’heure précédant le début de la réunion, sinon envoyez un e-mail. »
Si vous avez des questions concernant le processus de configuration dans SuperSaaS, n’hésitez pas à contacter notre équipe de support.