Base de connaissances GetMyBot

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 :

SensQui commence ?Exemple
Webhook entrantUn autre service notifie GetMyBot et déclenche une réactionUne demande arrive sur le site, le bot prévient le responsable
Requête web sortanteUne réaction appelle un autre service et lit sa réponseLe 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, PUT ou ANY.

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, PATCH ou DELETE, 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