Ce que votre Agent IA peut faire pendant une conversation : les Quickchat AI Actions intégrées et les actions personnalisées qui appellent votre propre API, un serveur MCP ou un raccourci comme Google Sheets.
Définissez ce que votre Agent IA peut faire pendant une conversation : depuis les réponses basées sur des données d’API en temps réel, la collecte de prospects et d’insights, jusqu’à l’exécution de tâches personnalisées.
Les Agents Quickchat AI disposent de deux types d’action.
Les Quickchat AI Actions sont intégrées : il suffit de les activer et de les configurer.
- Human Handoff transmet la conversation à une personne.
- Collecte intelligente de données recueille des leads et d’autres données pendant le chat.
Les actions personnalisées sortent de Quickchat AI :
- Les actions API appellent n’importe quel endpoint HTTP. Elles sont décrites sur cette page.
- Les actions MCP connectent un serveur MCP entier d’un coup.
- Google Sheets est un raccourci qui met en place une action de journalisation pour vous en un clic.
Toute action peut lire les données en direct de la conversation via les AI Action Variables, et l’exemple Jira en construit une de bout en bout.
Outils de configuration facultatifs
Section intitulée « Outils de configuration facultatifs »-
Vérifier les conditions d’exécution des Actions. Évaluez des conditions sur les métadonnées d’exemple fournies, sans exécuter d’Action.
-
Vérifier une connexion MCP d’exemple. Initialisez uniquement le point d’accès de la documentation Cloudflare ou de Microsoft Learn et listez ses outils. Aucune connexion à un compte ni exécution d’outil n’est effectuée.
Actions personnalisées
Section intitulée « Actions personnalisées »Les Actions personnalisées permettent à votre IA d’appeler des outils externes pendant la conversation : rechercher dans des systèmes internes, créer des tickets, déclencher des alertes ou récupérer des données récentes qui ne figurent pas dans la Base de connaissances. Retrouvez-les dans Actions & MCPs sous Actions personnalisées.
Cliquez sur + Ajouter une action pour en créer une. Le menu déroulant propose :
- Action API : appelez n’importe quel endpoint REST via HTTP. C’est l’option la plus générale ; utilisez-la pour tout service disposant d’une URL et acceptant du JSON.
- MCP : connectez un serveur MCP externe en un clic et laissez l’IA utiliser les outils qu’il expose. Consultez Actions MCP.
- Action HubSpot : connexion préconfigurée à votre CRM HubSpot. Utilisez-la pour gérer les contacts, les transactions et les tickets, y compris l’ajout de notes privées aux tickets, sans gérer vous-même les tokens API.
- Action Discord : installez des modèles modifiables d’Actions API de support et de modération. Votre propre app Discord est nécessaire. Consultez Actions Discord.
- Google Sheets : lisez et modifiez une feuille de calcul que vous connectez.
- Shopify MCP : connectez une boutique Shopify via le serveur Shopify Storefront MCP pour permettre à l’IA de rechercher dans votre catalogue et vos politiques de boutique, de consulter les détails des produits et de constituer un panier. Une seule action Shopify MCP est autorisée par scénario. Elle ne couvre pas la recherche de commandes ; consultez la note ci-dessous.
Chaque Agent IA peut stocker jusqu’à 15 actions. Les actions actives et inactives sont comptées dans cette limite. Toutes les offres permettent d’activer les actions créées sans limite supplémentaire d’actions actives liée à l’offre. Supprimez une action devenue inutile pour libérer une place ; la désactiver ne libère pas de place.
Le Shopify Storefront MCP s’adresse aux clients et n’expose aucune donnée de commande. Un Agent IA connecté uniquement par ce biais ne peut donc pas rechercher la commande d’un client. Le statut d’une commande provient d’une Action API distincte, Check order status, qui lit l’API Shopify Admin. Elle est configurée automatiquement lorsque vous installez l’app Quickchat depuis le Shopify App Store. Les boutiques connectées en collant une URL n’ont pas d’accès Admin et ne permettent donc pas de rechercher des commandes. Réinstallez l’app depuis l’App Store si vous avez besoin de cette fonctionnalité.
Fonctionnement des Actions personnalisées
Section intitulée « Fonctionnement des Actions personnalisées »- Choisissez un type d’action : Action API, MCP, Action HubSpot, Action Discord, Google Sheets ou Shopify MCP. Configurez la connexion et les instructions dont l’IA a besoin.
- Pendant une conversation, l’IA utilise normalement la description de l’action et les détails disponibles sur les outils ou les paramètres pour décider quand l’exécuter. Une Action API peut aussi s’exécuter automatiquement avant la première réponse ou lorsque les conditions de métadonnées correspondent pour la première fois.
- Quickchat exécute l’appel. Pour une Action choisie par l’IA, ou qui s’exécute avant la première réponse, l’IA peut utiliser la réponse. Une Action déclenchée par les métadonnées s’exécute silencieusement et son résultat n’est pas ajouté au chat.
- Testez ou connectez l’action depuis son éditeur avant de l’utiliser dans des conversations.
Rédigez la description comme une instruction à l’IA. Précisez quand utiliser l’action, ce qu’elle retourne et les garde-fous éventuels (par exemple : « appeler uniquement lorsque l’utilisateur fournit un numéro de commande »).
Créer des brouillons d’Actions à partir d’une description
Section intitulée « Créer des brouillons d’Actions à partir d’une description »- Dans Actions & MCPs, choisissez + Ajouter une action > Action API.
- Décrivez le processus, les moments où l’Agent doit agir, les API à utiliser (ou ajoutez un lien vers leur documentation) et les informations nécessaires à chaque étape. Cliquez sur Générer.
- Quickchat prépare jusqu’à quatre brouillons de nouvelles Actions API, tous inactifs. Le résultat peut recommander des Actions existantes plutôt que de créer des doublons, ou demander davantage de précisions. La génération de brouillons n’exécute pas les Actions.
- Consultez Actions existantes utilisées, les éventuels prérequis et Prochaines étapes. Terminez la configuration, remplacez les valeurs provisoires et vérifiez la requête, les instructions et les conditions d’exécution de chaque Action. Testez chaque Action avant d’activer les brouillons ou toute Action existante inactive nécessaire.
La séquence suggérée décrit le comportement attendu. Elle ne garantit pas l’ordre des Actions choisies par l’IA. Utilisez les données d’entrée requises, les informations enregistrées en mémoire et les conditions d’exécution pour exprimer les dépendances. Après avoir activé les Actions, testez le parcours complet dans une conversation.
Créer une Action API
Section intitulée « Créer une Action API »- Allez dans Actions & MCPs.
- Cliquez sur + Ajouter une action dans Actions personnalisées, choisissez Action API, puis cliquez sur Créer manuellement.
- Renseignez Details :
- Name : clair et descriptif
- Description : quand l’utiliser et quoi inclure dans les paramètres
- Sous Moment d’exécution, choisissez L’IA décide, Avant la première réponse ou Lorsque les métadonnées correspondent.
- Configurez Connection :
- Action Type : méthode HTTP (GET, POST, etc.)
- Action endpoint URL : URL complète
- Headers : ajoutez les en‑têtes requis (
Authorization,content-type: application/json, etc.)
- Définissez les Parameters : pour chaque paramètre, indiquez name, location (query, body ou header) et une description guidant l’IA sur la composition de la valeur. Les valeurs de chemin ne sont pas une location de paramètre ; insérez‑les directement dans l’URL de l’endpoint via le templating
{{placeholder}}. - Test request, vérifiez la réponse, puis cliquez Done.
Chaque champ de valeur (URL, header, body ou query) accepte des marqueurs dynamiques via le bouton + Add AI Data. Vous pouvez injecter vos paramètres IA, les variables de conversation intégrées ({{scenario_id}}, {{language}}, {{country}}, …) et les métadonnées de conversation ({{metadata_*}}). Consultez Variables des AI Actions pour la référence complète.
Au-delà de la requête elle-même, une Action API possède trois réglages optionnels qu’il est utile de connaître : Enregistrer en mémoire, Exécuter uniquement si et Filtre de réponse.
Prévisualisez une requête d’Action API à partir d’un modèle fourni et de valeurs d’exemple synthétiques. Omettez les en-têtes contenant des identifiants. L’aperçu génère la requête sans l’envoyer.
Choisir les valeurs par défaut des paramètres
Section intitulée « Choisir les valeurs par défaut des paramètres »Pour une Action configurée sur L’IA décide, choisissez Aucune valeur par défaut lorsque l’IA doit recueillir la valeur dans la conversation. Un paramètre obligatoire sans valeur par défaut ne peut pas envoyer de valeur vide. Une valeur par défaut volontairement vide est un réglage distinct ; les valeurs vides existantes restent vides. L’éditeur conserve également les valeurs numériques 0 et booléennes false.
Pour un paramètre de texte ou de nombre, ouvrez Options de la valeur par défaut à côté du champ de valeur par défaut et choisissez Aucune valeur par défaut ou Valeur vide. Vous pouvez remplacer une valeur par défaut vide par une valeur. Pour un paramètre booléen, choisissez Aucune valeur par défaut dans la liste déroulante.
Choisir le moment d’exécution d’une Action API
Section intitulée « Choisir le moment d’exécution d’une Action API »Utilisez Moment d’exécution pour sélectionner l’un des trois modes :
La section est repliée par défaut et affiche le mode actif à côté de son titre. Dépliez-la pour changer de mode.

- L’IA décide : le mode par défaut. L’IA lit la description de l’Action et décide si la demande du visiteur nécessite son exécution. Utilisez ce mode lorsque l’Action ne doit s’exécuter que pour certaines questions ou après que l’IA a recueilli des informations auprès du visiteur.
- Avant la première réponse : Quickchat exécute l’Action une seule fois après que le visiteur a envoyé son premier message et avant que l’IA rédige sa première réponse. La réponse normale de l’IA reçoit la réponse de l’API et toutes les valeurs enregistrées avec Enregistrer en mémoire. L’IA ne peut plus choisir cette Action comme outil : elle ne s’exécute donc qu’au premier tour et pas de nouveau plus tard dans la conversation. Utilisez ce mode pour identifier le client, récupérer le contexte du compte, vérifier ses droits ou effectuer toute autre initialisation nécessaire à chaque conversation réelle.
- Lorsque les métadonnées correspondent : Quickchat vérifie les conditions Exécuter lorsque de l’Action après chaque tour de l’IA et l’exécute la première fois que toutes les conditions sont remplies. Les valeurs qu’une autre Action enregistre dans la mémoire au cours de ce tour sont immédiatement disponibles. L’IA ne peut pas choisir cette Action comme outil et sa réponse n’est pas ajoutée au chat. Utilisez ce mode pour les notifications internes, les mises à jour du CRM ou les requêtes de suivi qui doivent s’exécuter automatiquement dès que les données de la conversation sont disponibles.
Le mode Avant la première réponse est lié au premier message du visiteur, et non à la création de la conversation. L’ouverture d’un chat ou la réception d’un message de bienvenue ne l’exécute pas. Ainsi, les chats abandonnés n’envoient aucune requête. Quickchat enregistre l’exécution avant d’appeler l’endpoint. Elle n’est donc pas retentée dans la même conversation, même si la requête échoue ou si son résultat est incertain.
La première réponse attend la fin de la requête, ce mode peut donc ajouter de la latence. Si plusieurs Actions utilisent ce mode, elles s’exécutent l’une après l’autre et leurs temps de requête s’additionnent. Si des métadonnées requises sont absentes, si l’endpoint est indisponible ou si une requête échoue, l’IA répond tout de même. Ouvrez le Journal des requêtes de l’Action pour consulter les détails.
Comme l’Action s’exécute avant que l’IA puisse choisir les valeurs des paramètres, chaque paramètre IA qu’elle utilise doit avoir une valeur par défaut. Les métadonnées et les variables intégrées peuvent être insérées directement dans l’URL, les headers, les paramètres query ou le body.
Le mode Lorsque les métadonnées correspondent requiert au moins une condition Exécuter lorsque et une valeur par défaut pour chaque paramètre IA. Quickchat enregistre la tentative avant d’appeler l’endpoint. Une fois qu’une requête a été envoyée, l’Action n’est plus retentée dans la même conversation, qu’elle ait réussi, échoué ou que son résultat soit incertain. Une requête qui n’a pas pu être construite, parce qu’une valeur dont elle a besoin manque encore, n’est pas enregistrée et reste possible lors d’un tour ultérieur. L’Action s’exécute juste après que l’IA a terminé son tour, un échec ne remplace donc jamais la réponse de l’IA. Sur les canaux sans diffusion en continu, la durée de la requête s’ajoute au temps d’attente du visiteur.
Choisir Lorsque les métadonnées correspondent fait apparaître l’éditeur Exécuter lorsque dans la même section, de sorte que le déclencheur et ses conditions restent groupés.

Pour les canaux susceptibles de fournir soit une adresse e-mail, soit un numéro de téléphone, créez une Action de recherche pour chaque identifiant. Définissez les deux sur Avant la première réponse, puis ajoutez à chacune une condition Exécuter uniquement si correspondante, comme visitor_email exists ou visitor_phone_number exists. Quickchat envoie uniquement la requête correspondant aux métadonnées présentes.
Webhooks de fin de conversation et transcriptions
Section intitulée « Webhooks de fin de conversation et transcriptions »Une action API peut notifier votre webhook pendant un chat. Avec L’IA décide, demander de l’appeler à la fin de l’échange reste une instruction sans garantie d’exécution. Les modes standard ne garantissent aucun appel à la fin de la conversation, lorsqu’un visiteur devient inactif ou lorsqu’un onglet du navigateur se ferme.
Pour obtenir une transcription exacte, définissez dans votre intégration ce qui marque la fin de la conversation. Envoyez {{conversation_id}} à votre backend et utilisez un jeton API autorisé avec read_all pour récupérer toutes les pages des événements de conversation, avec limit et offset. Construisez la transcription à partir des événements de message. Conservez le jeton sur votre backend.
Aucune variable intégrée ne contient la transcription. Un paramètre de résumé ou de transcription généré par l’IA ne garantit pas une copie exacte. Consultez les variables des actions IA pour connaître le contexte que vous pouvez envoyer.
Actions HubSpot
Section intitulée « Actions HubSpot »Action HubSpot ouvre une galerie d’Actions API préremplies et modifiables qui utilisent votre compte HubSpot connecté.

Le modèle Ajouter une note au ticket crée une note privée sur le ticket HubSpot lié à la conversation. Enregistrez le contenu de la note dans la mémoire de la conversation sous la clé hubspot_note_body, puis ajoutez le modèle et activez-le. Il est préconfiguré avec Lorsque les métadonnées correspondent et attend que hubspot_note_body et le hubspot_ticket_id fourni par le serveur de Quickchat soient tous deux présents. Vous pouvez modifier la valeur par défaut du paramètre note_body pour ajouter du texte fixe autour de {{metadata_hubspot_note_body}}.
La note est interne à HubSpot et n’est pas montrée au visiteur. Le modèle tente la requête une seule fois par conversation Quickchat. Ouvrez le Journal des requêtes de l’Action pour confirmer sa transmission ou examiner une requête qui a échoué.
Actions Discord
Section intitulée « Actions Discord »Action Discord ouvre une galerie d’Actions API préremplies et modifiables :
- Support & Tickets : Ouvrir un ticket de support vous invite à sélectionner un serveur et un canal texte. Vous pouvez également sélectionner un rôle de support mentionnable, mais ce choix est facultatif. Le modèle crée trois Actions qui ouvrent un thread privé, ajoutent l’auteur de la demande actuelle et publient un résumé avec la mention facultative du rôle.
- Modération : Timeout d’un membre, Expulser un membre, Bannir un membre, Révoquer un bannissement, Attribuer un rôle, Définir le slowmode et Envoyer une annonce. Chaque modèle s’installe en un clic et utilise le serveur, le membre, le rôle ou le canal de la requête Discord actuelle.
Quickchat crée la méthode HTTP, l’URL, les headers, le body, les paramètres, la description, les réglages de réponse et les conditions d’exécution dans le backend. Les cartes obtenues sont des Actions de requête HTTP ordinaires. Vous pouvez consulter et modifier chaque champ.
Les sept modèles de modération incluent la condition author_is_admin is true sous Exécuter uniquement si. Discord calcule la permission Administrator de l’auteur actuel, la gateway Discord fournit cette valeur et Quickchat la vérifie avant d’envoyer la requête. Les métadonnées provenant du chat public ou de l’API ne peuvent pas définir cette clé. Testez les Actions de modération dans Discord avec un compte administrateur et un compte non-administrateur. AI Preview ne fournit pas d’expéditeur Discord autorisé.
Les Actions de modération sont modifiables. La suppression ou l’affaiblissement de la condition author_is_admin is true supprime la frontière d’autorisation fournie. L’expulsion et le bannissement ne demandent aucune confirmation avant leur exécution.
Les modèles n’ajoutent aucune automatisation propre. L’Agent ne les exécute que lorsqu’un administrateur le demande dans la conversation ; il n’y a ni comptage des strikes d’une conversation à l’autre, ni vérification des captures d’écran ou d’autres preuves, ni sanctions planifiées ou déclenchées de sa propre initiative.
Le bot lui-même a toujours besoin de la permission Discord requise par chaque requête :
| Action | Permission ou accès du bot |
|---|---|
| Timeout d’un membre | Moderate Members |
| Expulser un membre | Kick Members |
| Bannir un membre, Révoquer un bannissement | Ban Members |
| Attribuer un rôle | Manage Roles |
| Définir le slowmode | Manage Channels |
| Envoyer une annonce | View Channels et Send Messages |
Discord applique également la hiérarchie des rôles. Placez le rôle du bot au-dessus des membres et des rôles qu’il doit gérer. Le modèle n’effectue aucune vérification supplémentaire de la hiérarchie ou des permissions individuelles pour l’administrateur à l’origine de la demande.
Définir le slowmode et Envoyer une annonce acceptent un ID de canal comme paramètre. Sans cible fixe supplémentaire, le modèle ne vérifie pas que le canal appartient au serveur depuis lequel l’administrateur a envoyé la requête. Si le même bot appartient à plusieurs serveurs, modifiez ces Actions pour utiliser un ID de canal fixe ou répartissez les serveurs entre des Agents et des identifiants de bot distincts.
L’installation du ticket de support utilise les fonctions existantes des Actions pour transmettre les données :
open_support_ticketcrée un thread privé dans le canal sélectionné, capture$.idet l’enregistre dans la mémoire de la conversation sous la clédiscord_ticket_thread_id. Cette Action exige la condition visiblediscord_message is true, s’exécute uniquement sur le serveur sélectionné et seulement tant que cette clé de mémoire n’existe pas.add_ticket_requesterlit{{metadata_discord_ticket_thread_id}}et la variable{{metadata_discord_author_id}}fournie par Discord. Cette Action exige la condition visiblediscord_message is trueet s’exécute uniquement sur le serveur sélectionné une fois l’ID du thread disponible.post_in_ticketlit le même ID de thread enregistré, publie le résumé du problème en une ligne fourni par l’Agent et mentionne l’auteur de la demande. Si vous avez sélectionné un rôle de support, cette Action le mentionne également. Elle possède les mêmes conditions visibles concernant le message Discord, le serveur et le thread enregistré. Son body Discordallowed_mentionsest limité à l’auteur de la demande et, lorsqu’un rôle est configuré, à ce rôle.
Les descriptions et le prompt de votre Agent doivent lui indiquer d’exécuter ces Actions dans cet ordre. Il n’existe pas de couche distincte pour l’état du workflow, le verrouillage, la confirmation, les nouvelles tentatives, la récupération, la réconciliation ou la protection contre le replay. Si un résultat est incertain, vérifiez Discord et le journal de l’Action avant de réessayer, car Discord a peut-être déjà exécuté la requête.
discord_ticket_thread_id n’est pas effacé automatiquement. Le modèle prend donc en charge un ticket par conversation Quickchat. Pour un autre ticket, démarrez une nouvelle conversation ou un nouveau thread Discord, ou modifiez les Actions afin d’ajouter le cycle de vie de la mémoire dont vous avez besoin.
Pour les tickets de support, accordez au bot les permissions View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads et Manage Threads dans le canal de tickets sélectionné. Choisissez N’avertir aucun rôle sous Avertir un rôle (facultatif) si aucun rôle ne doit être mentionné. Si vous sélectionnez un rôle, il doit être mentionnable et ses membres doivent avoir accès aux threads privés. Lorsqu’aucun rôle mentionnable n’est disponible, les tickets s’ouvrent normalement sans notification de rôle. La galerie répertorie les canaux texte et les rôles mentionnables, mais ne valide pas tous les remplacements de permissions du canal.
Les Actions Discord nécessitent le token de votre propre app Discord dans Applications externes → Discord → Configuration avancée. Le bot partagé en un clic ne peut pas fournir ce token à lui seul. Consultez Discord.
La galerie est un raccourci de configuration, pas une couche de policy supplémentaire. Si vous modifiez une Action générée ou créez une Action API Discord personnalisée, vérifiez ses identifiants, ses cibles, ses paramètres, l’exposition de sa réponse et ses conditions Exécuter uniquement si avant de l’activer.
Enregistrer en mémoire
Section intitulée « Enregistrer en mémoire »Enregistrez une valeur provenant d’une entrée de l’Action ou de la réponse de l’API dans la mémoire de la conversation sous une clé de votre choix. Les Actions ultérieures peuvent la réutiliser via {{metadata_<key>}}, et elle apparaît dans les détails de la conversation (Boîte de réception, API et exports).
Utilisez‑la lorsqu’une Action produit quelque chose dont une Action ultérieure a besoin. Une Action de recherche peut enregistrer un customer_id issu de sa réponse ; une Action de suivi envoie ensuite {{metadata_customer_id}} sans que l’IA ait à recopier la valeur d’une Action à l’autre.
Dans l’éditeur d’Action API, ouvrez Enregistrer en mémoire et ajoutez une ligne :
- Choisissez une Source. Réponse de l’API lit la réponse JSON de l’API et constitue la source par défaut des nouvelles lignes. Entrée de l’action lit les valeurs des paramètres d’entrée déclarés de l’Action.
- Sous Valeur à enregistrer, sélectionnez le paramètre dans le menu déroulant pour Entrée de l’action. Pour Réponse de l’API, saisissez une Expression JSONPath, par exemple
$.customer_id. - Choisissez une Clé de mémoire. Les noms anglais courants des champs de nom, de téléphone et d’e-mail proposent la clé de visiteur correspondante. Vous pouvez conserver la suggestion ou saisir votre propre clé.
Pour enregistrer des coordonnées dans la Boîte de réception, utilisez Entrée de l’action avec les correspondances suivantes :
| Paramètre de l’Action | Clé de mémoire |
|---|---|
Name ou Full name | visitor_name |
Phone number ou Phone | visitor_phone_number |
Email ou Email address | visitor_email |
L’entrée doit être déclarée dans l’Action. L’enregistrer via une règle de mémoire Entrée de l’action compte comme une utilisation du paramètre : il peut donc être collecté pour la mémoire sans être envoyé dans la requête HTTP. Ces clés de visiteur remplissent les champs de coordonnées non renseignés dans la Boîte de réception et les métadonnées de conversation, avec la même validation que la Collecte intelligente de données. Les coordonnées existantes et les champs explicitement vidés par un opérateur sont préservés. Les règles portant sur la réponse de l’API ne peuvent pas écrire dans ces clés de visiteur ; utilisez une clé personnalisée telle que customer_id pour les valeurs renvoyées par un CRM.
Les entrées sont enregistrées après validation des entrées obligatoires et des conditions d’exécution de l’Action, avant la requête HTTP. Les coordonnées valides restent donc disponibles si l’API renvoie une erreur ou dépasse le délai d’attente. Pour les vérifier, exécutez l’Action dans une nouvelle conversation de l’Aperçu, puis ouvrez cette conversation dans la Boîte de réception. Le test API isolé de l’éditeur ne dispose d’aucune conversation dans laquelle enregistrer la mémoire.
Les clés de mémoire sont partagées avec les outils Remote MCP de l’Agent. Si un outil MCP enregistre déjà sous la même clé, le champ Clé de mémoire signale le conflit à l’enregistrement. Choisissez alors une autre clé. Les outils Remote MCP continuent d’enregistrer les valeurs de leurs résultats.
Utilisez des clés en snake_case (lettres, chiffres, underscores). Une clé comme customer_id est référençable via {{metadata_customer_id}} ; les clés avec des espaces ou d’autres signes de ponctuation ne peuvent pas être utilisées dans les marqueurs. Consultez Métadonnées de conversation pour comprendre le fonctionnement des variables de métadonnées.
Exécuter uniquement si
Section intitulée « Exécuter uniquement si »Restreignez une Action pour qu’elle ne s’exécute que lorsque des conditions sur les métadonnées de la conversation sont remplies. Les conditions sont toujours vérifiées de notre côté, en dehors du modèle. Avec L’IA décide ou Avant la première réponse, Quickchat les vérifie juste avant d’envoyer la requête. Avec Lorsque les métadonnées correspondent, les conditions elles-mêmes déclenchent la requête après un tour de l’IA, sans attendre que l’IA choisisse l’Action.
C’est l’outil adapté aux Actions à privilèges ou irréversibles (bannir un membre, émettre un remboursement, supprimer un enregistrement). Une ligne dans votre prompt indiquant « seuls les admins peuvent faire cela » est une instruction utile, mais ce n’est pas une frontière de sécurité : un utilisateur déterminé peut argumenter avec le modèle ou tenter une injection de prompt. Une condition d’exécution est déterministe et vit en dehors du prompt, elle tient donc quoi que dise la conversation.
- La condition d’exécution est la frontière. Elle est évaluée côté serveur et ne fait pas partie du prompt lu par le modèle. C’est elle qui empêche réellement l’Action de s’exécuter.
- La règle du prompt est l’expérience utilisateur. Gardez aussi une ligne dans votre prompt, pour que l’IA refuse poliment et explique pourquoi au lieu de rester silencieuse.
Ajoutez des conditions dans la section Exécuter uniquement si de l’éditeur d’Action. Pour une Action configurée sur Lorsque les métadonnées correspondent, cette section s’intitule Exécuter lorsque. Cliquez sur Ajouter une condition, choisissez une clé de métadonnées (par exemple telegram_sender_is_admin) et choisissez comment la comparer :
| Condition | Passe lorsque la valeur de métadonnée… |
|---|---|
| est vrai | est truthy |
| est faux | est falsy |
| existe | est présente sur la conversation |
| n’existe pas | est absente |
| est égal à | correspond à une valeur que vous indiquez |
| n’est pas égal à | diffère d’une valeur que vous indiquez |
| fait partie de | correspond exactement à l’une des valeurs de la liste, en tenant compte des majuscules, des minuscules et des espaces |
| contient le texte | est du texte comprenant le texte littéral indiqué, en respectant la casse |
L’Action ne s’exécute que lorsque toutes les conditions sont remplies. L’éditeur affiche ET entre les lignes. Lorsqu’une condition bloque une Action choisie par l’IA, l’IA peut expliquer que l’Action est indisponible. Une Action Lorsque les métadonnées correspondent reste silencieuse jusqu’à ce que ses conditions soient remplies.
Utilisez fait partie de pour proposer plusieurs valeurs possibles pour la même clé, en saisissant chacune dans une puce distincte. Par exemple, modelName is one of [K-65XR95M2, K-75XR95M2, K-85XR95M2] peut être associé à country equals UK ; les deux lignes doivent être satisfaites. Vous pouvez ajouter jusqu’à 50 valeurs possibles de 500 caractères maximum chacune. Les virgules font partie intégrante d’une valeur. Des lignes est égal à distinctes indiquant des valeurs différentes pour la même clé ne peuvent pas toutes correspondre.
contient le texte recherche une sous-chaîne littérale, sans caractères génériques ni expressions régulières. XR95M2 correspond aussi à des variantes de noms de modèles au-delà des trois modèles ci-dessus. Ces deux nouvelles conditions rejettent les clés absentes, null, les listes et les objets ; contient le texte rejette aussi les nombres et les booléens. Le texte de comparaison ne peut pas être vide. Les conditions existantes est faux, n’est pas égal à et n’existe pas peuvent correspondre à des clés absentes.

Lorsqu’une condition échoue, aucune requête n’est envoyée et l’IA indique à l’utilisateur qu’elle ne peut pas le faire. Ci‑dessous, la même demande de bannissement est bloquée pour un non‑admin et autorisée pour un admin, sans rien changer d’autre que la personne qui la formule :


Ne posez de conditions que sur des métadonnées définies par Quickchat (comme un indicateur telegram_sender_is_admin vérifié par le canal), pas sur des valeurs que le visiteur peut influencer. Consultez Métadonnées de conversation pour savoir d’où provient chaque clé.
Filtre de réponse
Section intitulée « Filtre de réponse »Par défaut, l’IA voit la réponse complète de l’API. Ajoutez des expressions JSONPath dans la section Filtre de réponse pour limiter l’IA à des parties précises de la réponse.
Deux raisons courantes de filtrer :
- Masquer les champs sensibles. Gardez les e‑mails des clients, les détails de paiement ou les identifiants internes hors du contexte du modèle lorsque l’endpoint renvoie plus que ce dont l’IA a besoin.
- Réduire le prompt. Les APIs bavardes peuvent renvoyer des payloads volumineux ; filtrer pour ne garder que les quelques champs qui comptent garde la réponse petite et l’IA concentrée.
Ajoutez une ou plusieurs expressions JSONPath. Le filtre conserve les champs sélectionnés dans les objets et tableaux qui les contiennent, au lieu de les aplatir en une liste de valeurs. Les champs en dehors des chemins sélectionnés sont omis. Par exemple, utilisez ces deux lignes :
$.customer.name$.orders[*].id
Pour cette réponse de l’API :
{ "customer": {"name": "Ada", "email": "ada@example.com"}, "orders": [{"id": 101, "total": 25}, {"id": 102, "total": 40}]}L’IA reçoit la réponse filtrée suivante, dans laquelle customer reste un objet et orders un tableau d’objets :
{ "customer": {"name": "Ada"}, "orders": [{"id": 101}, {"id": 102}]}Utilisez le panneau Test Response pour voir exactement ce que l’IA recevra après filtrage, avant de vous y fier. Consultez Tester votre Action.
Un JSONPath qui ne correspond à rien laisse l’IA avec une réponse vide. Commencez sans filtre, confirmez que l’appel fonctionne, puis resserrez‑le.

Prévisualisez les correspondances JSONPath dans une réponse JSON fournie. L’aperçu prend en charge les chemins racine, champ, index de tableau et joker pour les règles Filtre de réponse ou Enregistrer en mémoire.
Vérifier l’état et les journaux des Actions
Section intitulée « Vérifier l’état et les journaux des Actions »Un avertissement à côté d’Actions & MCPs dans la barre latérale signifie qu’une Action nécessite votre attention. Ouvrez la page et survolez le badge de sa carte, ou sélectionnez-le au clavier, pour en connaître la raison :
- En échec : des appels récents ont échoué à plusieurs reprises. Le badge indique le nombre d’échecs et la dernière erreur lorsqu’elle est disponible.
- Ne s’exécute pas : l’Action a été ignorée à plusieurs reprises, sans aucun appel exécuté pendant la période actuellement utilisée pour évaluer son état. Vérifiez la raison indiquée, par exemple des valeurs de conversation manquantes ou un problème de configuration.
- Reconnexion requise : une connexion MCP a perdu son autorisation et a été désactivée. Ouvrez Modifier, reconnectez-la, puis réactivez-la.
L’état tient compte des conversations réelles des sept derniers jours, ou depuis la dernière modification de l’Action si celle-ci est plus récente. Il est distinct des requêtes de test. Après avoir corrigé et enregistré une Action, vérifiez de nouvelles conversations pour confirmer la correction. La disparition d’un ancien avertissement ne prouve pas à elle seule que l’Action fonctionne.
Pour En échec ou Ne s’exécute pas, cliquez sur Voir les détails pour ouvrir le Journal des requêtes avec Problèmes uniquement activé. Voir les journaux ouvre le journal avec tous les appels. Désactivez Problèmes uniquement pour comparer les appels problématiques aux appels réussis.
Conversations ignorées répertorie les conversations dans lesquelles l’Action n’a pas pu s’exécuter, séparément des appels exécutés. Utilisez Voir la conversation pour examiner le contexte et Afficher plus pour charger les entrées plus anciennes. Une Action peut réussir dans certaines conversations et être ignorée dans d’autres. Cette liste peut donc apparaître même sans badge d’avertissement.
Si la raison indique des valeurs manquantes telles que {{metadata_visitor_email}}, fournissez-les via les métadonnées de votre site web ou de votre canal, ou faites-les enregistrer en mémoire par une Action précédente. Vérifiez ensuite le mode d’exécution :
- L’IA décide : l’Action n’est proposée à l’IA que dans les conversations qui disposent déjà des valeurs requises.
- Avant la première réponse : les valeurs doivent être présentes lorsque le visiteur envoie son premier message.
- Lorsque les métadonnées correspondent : ajoutez une condition existe pour chaque valeur requise afin que l’Action attende sa présence.
Consultez Variables des Actions IA pour savoir d’où proviennent les valeurs de conversation.
Les e-mails de résumé d’activité incluent également une section AI Actions need attention lorsqu’une Action HTTP ou MCP distante nécessite votre attention. Elle répertorie jusqu’à cinq Actions, avec une raison et un lien vers Actions & MCPs ; un compteur indique le nombre d’Actions supplémentaires qui nécessitent votre attention. Cette section n’apparaît pas lorsque tout fonctionne correctement.
L’e-mail présente l’état actuel, qui peut couvrir une période plus large que celle des activités du résumé quotidien. Après avoir corrigé et enregistré une Action API, son état est évalué à partir de cette modification. La reconnexion ou la déconnexion d’une connexion MCP concernée efface son avertissement d’autorisation. Les préférences et les règles d’éligibilité existantes des e-mails de résumé s’appliquent, et aucun e-mail d’alerte distinct n’est envoyé.
Bonnes pratiques
Section intitulée « Bonnes pratiques »- Soyez explicite dans les descriptions : quand utiliser l’action et comment remplir chaque paramètre.
- Limitez les scopes au minimum : n’incluez que les en-têtes et jetons nécessaires à l’endpoint. Pour Jira, utilisez l’en-tête Basic obtenu à partir de votre adresse e-mail Atlassian et de votre token API.
- Testez avant déploiement avec le panneau de test des requêtes. Vérifiez les codes de statut et les payloads d’exemple dans l’outil cible.
Tutoriels
Section intitulée « Tutoriels »- Connecter un Agent IA aux tickets Jira (référence principale) ou le tutoriel commenté du blog
- Envoyer une notification Slack avec une Action IA