La plupart des automatisations démarrent à partir d'un événement dans votre salon. Deux déclencheurs font exception : Webhook démarre une automatisation lorsqu'un autre système envoie une requête à son URL, par exemple un formulaire sur votre site web. Manuel la démarre lorsque vous cliquez sur Exécuter.
Avant de commencer
- Vous avez besoin du rôle Super administrateur ou Propriétaire.
- Votre salon a besoin d'un abonnement actif.
- Créez une automatisation depuis zéro. Consultez Créer une automatisation depuis zéro.
Démarrer une automatisation depuis un webhook
- 1
Étape 1 sur 4
Choisissez le déclencheur Webhook
Cliquez sur l'étape Démarrer l'automatisation. Cliquez sur le champ Déclencheur, choisissez Autre, puis Webhook.
Vous verrez:La fenêtre affiche une URL du webhook avec un bouton de copie.
- 2
Étape 2 sur 4
Protégez l'URL avec une condition
L'URL du webhook est publique. Toute personne qui la possède peut démarrer l'automatisation : ajoutez donc une Condition que seul votre système peut remplir, par exemple un en-tête secret.
Utilisez l'onglet Générateur, ou écrivez une expression dans l'onglet Expression, comme
{{ $request.headers.authorization === "Bearer your-secret" }}. Les noms d'en-têtes sont en minuscules. L'automatisation ne démarre que si toute la condition est vraie.Cliquez sur Enregistrer, puis sur Enregistrer en haut de l'éditeur. Les modifications du déclencheur ne prennent effet qu'après l'enregistrement de l'automatisation.
- 3
Étape 3 sur 4
Utilisez les données de la requête dans vos étapes
La requête est disponible dans le groupe de variables Requête :
{{ $request.body.phoneNumber }}: un champ du corps de la requête{{ $request.query.source }}: un paramètre de requête, issu de?source=...dans l'URL{{ $request.headers.authorization }}: un en-tête{{ $request.method }}: la méthode HTTP
Par exemple, utilisez
{{ $request.body.emailAddress }}comme destinataire d'une étape Envoyer une notification. - 4
Étape 4 sur 4
Envoyez une requête
Depuis votre autre système, envoyez une requête POST avec un corps JSON ou de formulaire à l'URL du webhook.
Vous verrez:La réponse a le statut 202 et contient un
executionId. Il est vide lorsque la condition n'était pas remplie. L'exécution apparaît dans l'Historique de l'automatisation.
Limites et erreurs du webhook
- Chaque webhook accepte jusqu'à 60 requêtes par minute et 1 000 par heure. Les requêtes au-delà de la limite sont refusées.
- Si l'automatisation est désactivée, la requête est refusée avec un message indiquant que l'automatisation n'est pas active.
- Si l'abonnement de votre salon n'est pas actif, la requête est refusée.
- Les cookies et les en-têtes de session Softalon ne sont pas transmis à l'automatisation.
Démarrer une automatisation manuellement
- 1
Étape 1 sur 2
Choisissez le déclencheur Manuel
Cliquez sur l'étape Démarrer l'automatisation. Cliquez sur le champ Déclencheur, choisissez Autre, puis Manuel. Enregistrez l'étape et l'automatisation.
- 2
Étape 2 sur 2
Exécutez-la
Sur la page Automatisations, ouvrez le menu de la carte de l'automatisation et cliquez sur Exécuter. L'option n'apparaît que pour les automatisations ayant le déclencheur Manuel, et l'automatisation doit être active.
Vous verrez:Un message Workflow démarré. L'exécution apparaît dans l'Historique.
Une exécution manuelle n'a pas d'événement : seules les variables Autre, comme le nom de votre salon, sont disponibles. Les destinataires doivent être des adresses fixes, comme votre propre e-mail.
Questions fréquentes
Non. L'URL du webhook n'accepte que les requêtes POST.