Requêtes web et webhooks
Déclencher le bot depuis un site et appeler un autre service depuis une réaction : requêtes entrantes et sortantes.
Sur cette page
Un site peut informer le bot d’une nouvelle demande, et le bot peut lui demander l’état d’une commande. Ce sont deux sens de communication :
| Sens | Qui commence ? | Exemple |
|---|---|---|
| Webhook entrant | Un autre service notifie GetMyBot et déclenche une réaction | Une demande arrive sur le site, le bot prévient le responsable |
| Requête web sortante | Une réaction appelle un autre service et lit sa réponse | Le bot demande le prix ou l’état d’une commande |
Un webhook est une notification automatique d’un service à un autre.
Les deux méthodes utilisent HTTP, le protocole des sites web. Pour des connexions prêtes à l’emploi, voir Intégrations.
Webhook entrant : déclencheur
Le déclencheur Requête web entrante (webhook) lance une réaction à partir d’une requête HTTP extérieure :
- Adresse : activez le déclencheur et enregistrez la réaction. GetMyBot génère alors l’URL du webhook et l’affiche dans ce champ. Vous pouvez la copier, pas la modifier.
- Jeton secret : empêche les tiers de déclencher la réaction avec cette URL.
- Méthode :
POST,GET,PUTouANY.
Les champs reçus vont dans les données temporaires de la réaction (ctx). Si le service envoie order_id, les actions y accèdent par {{ctx.order_id}}. Après la configuration, envoyez une requête de test et vérifiez les champs reçus.
Requête web sortante : action
L’action Requête web effectue une requête HTTP depuis une réaction :
- méthode
GET,HEAD,OPTIONS,POST,PUT,PATCHouDELETE, en-têtes et corps JSON ou texte ; - codes considérés comme un succès, délai d’attente et nombre de nouvelles tentatives ;
- enregistrement de la réponse dans un paramètre utilisateur ou dans
ctx; JSONPath indique le chemin du champ voulu ; - mode asynchrone : le bot continue sans attendre la réponse, que vous pouvez traiter dans une autre réaction en cas de succès ou d’erreur.
Actions proches : Charger une URL pour récupérer le texte d’une page dans ctx, et Requête vers la source / Écriture vers la source pour les connecteurs enregistrés. Voir Sources et clés.
Intégration webhook
Pour envoyer régulièrement des données à un service, configurez l’intégration Webhook avec son URL et une signature HMAC. Le service destinataire pourra ainsi vérifier l’expéditeur. Voir Intégrations.
Sécurité
Protégez les requêtes entrantes par un jeton secret. La plateforme interdit aux requêtes sortantes de joindre les adresses du réseau interne, une protection appelée SSRF. La taille de la réponse est aussi limitée.
Pour aller plus loin
- Déclencheurs : webhook entrant.
- Actions :
Requête webetCharger une URL. - Substitutions et formules : champs reçus dans
ctx.