AccueilDocumentation

MCP Server Integration

ChatReact implémente le Model Context Protocol (MCP), ce qui vous permet de connecter votre compte ChatReact à des assistants IA comme Claude Desktop, Cursor et d'autres outils compatibles MCP.

Qu'est-ce que le MCP ?

Le Model Context Protocol est une norme ouverte qui permet aux assistants IA d'interagir avec des services et des sources de données externes. Grâce à l'intégration MCP de ChatReact, vous pouvez :

  • Gérer les chatbots — créer, configurer (persona, langues, widget, comportement, restrictions), intégrer et supprimer des chatbots
  • Construire la base de connaissances — ajouter des documents, crawler des sites web, gérer les pages crawlées et les instructions de base
  • Gérer les FAQ — FAQs, catégories, suggestions, traductions et le widget FAQ
  • Examiner les conversations — noter les conversations, attribuer des catégories de confiance, exécuter l'Improvement Agent
  • Gérer les leads et formulaires — leads, catégories de leads, paramètres de capture, formulaires de contact et soumissions
  • Agir en tant qu'agent de chat en direct — définir votre disponibilité, prendre en charge des conversations en attente, répondre et clore des sessions
  • Administrer votre entreprise — profil, couleurs de marque, membres de l'équipe et invitations
  • Utiliser l'Email Assistant — connexions de boîtes mail, catégories, contacts et activité
  • Lire les analyses et notifications

Tout ce que vous pouvez faire dans le tableau de bord est disponible via MCP (et la REST API) ; seules les actions liées au navigateur comme les paiements, l'OAuth des boîtes mail, les passkeys, la suppression de compte et la gestion des clés API restent dans le tableau de bord.

Premiers pas

1. Générez une clé API

  1. Naviguez vers votre Tableau de bord → Entreprise → API onglet
  2. Cliquez sur Créer une clé API
  3. Donnez un nom descriptif à votre clé (p. ex. « Claude Desktop ») et sélectionnez au moins une autorisation
  4. Copiez la clé générée (commence par cr_)

Les clés API sont disponibles sur les offres payantes — voir notre Pricing page.

Stockez votre clé API en toute sécurité. Elle ne peut pas être récupérée après création.

2. Configurez votre client MCP

Le serveur MCP de ChatReact est hébergé à https://www.chatreact.ai/api/mcp et communique via HTTP (JSON-RPC). Authentifiez-vous avec un en-tête Authorization: Bearer — un en-tête X-API-Key avec la même clé est également accepté.

Cursor IDE

Cursor prend en charge les serveurs MCP distants directement. Ajoutez dans vos paramètres MCP de Cursor :

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Le fichier de configuration de Claude Desktop prend en charge les serveurs basés sur des commandes, utilisez donc le pont standard mcp-remote pour vous connecter au point de terminaison hébergé :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "chatreact": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.chatreact.ai/api/mcp",
        "--header",
        "X-API-Key:cr_your_api_key_here"
      ]
    }
  }
}

Cette configuration nécessite Node.js. L'exemple utilise l'en-tête X-API-Key car certains clients ne gèrent pas correctement les espaces dans les arguments.

3. Redémarrez votre assistant IA

Après avoir enregistré la configuration, redémarrez Claude Desktop ou Cursor pour établir la connexion.

Outils disponibles

Le MCP de ChatReact expose les outils ci‑dessous, regroupés par domaine. La colonne Scope indique l'autorisation de clé API requise par un outil (any = toute clé valide). Les outils s'exécutent avec les mêmes autorisations applicables, limites de plan et effets secondaires que les opérations prises en charge dans le tableau de bord. Les workflows liés au navigateur pour les paiements, l'autorisation des boîtes mail, les passkeys, la suppression de compte et la gestion des clés restent dans le tableau de bord.

Les outils destructifs (supprimer, réinitialiser, clore, fusionner) demandent confirmation lorsqu'ils sont utilisés via le Dashboard Assistant. Via la clé API, ils s'exécutent immédiatement.

Compte

ToolDescriptionScope
account_usage_getObtenir le plan actuel (tier, status), les compteurs d'utilisation de la période de facturation en cours (companies, chatbots, team members, chats, tokens) et les limites du plan, plus les limites effectives et les flags de fonctionnalités de l'entreprise à laquelle l'appel est scellé.any
user_companiesLister toutes les entreprises auxquelles l'utilisateur actuel a accès, avec le rôle de l'utilisateur dans chacune.any
user_notification_mark_readMarquer comme lue l'une des notifications de l'utilisateur actuel.any
user_notification_preferences_getObtenir les préférences de notification de l'utilisateur actuel : bascules globales email/push, fréquence/heure/jour de synthèse, fuseau horaire et paramètres par type.any
user_notification_preferences_updateMettre à jour les préférences de notification globales de l'utilisateur actuel (bascules email/push, planning de synthèse, heures calmes).any
user_notification_type_setting_updateActiver ou désactiver la livraison par e-mail / in-app pour un type de notification unique de l'utilisateur actuel (par ex.any
user_notification_types_listLister tous les types de notification regroupés par catégorie (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countObtenir le nombre de notifications non lues de l'utilisateur actuel.any
user_notificationsLister les notifications de l'utilisateur actuel, les plus récentes en premier, avec pagination par curseur.any
user_notifications_delete_oldEntretien : supprimer définitivement les notifications de l'utilisateur actuel qui sont déjà lues et datent de plus de 30 jours.any
user_notifications_mark_all_readMarquer toutes les notifications de l'utilisateur actuel comme lues.any
user_profileObtenir le profil de l'utilisateur actuel (id, name, email, role, subscription tier).any

Entreprise & Équipe

ToolDescriptionScope
company_chatbots_listLister tous les chatbots d'une entreprise spécifique avec des statistiques récapitulatives.chatbots:read
company_getObtenir des informations détaillées sur une entreprise : profil, propriétaire, paramètres de marque (couleurs, email de notification) et compteurs.any
company_invite_cancelAnnuler (supprimer) une invitation d'équipe pour que le lien cesse de fonctionner.company:write
company_invite_resendRenvoyer une invitation d'équipe en attente : émet un nouveau token, prolonge l'expiration de 7 jours et renvoie l'email d'invitation.company:write
company_invites_listLister les invitations d'équipe d'une entreprise (en attente par défaut ; définir includeExpired pour retourner aussi les expirées).company:read
company_listLister toutes les entreprises auxquelles l'utilisateur a accès (les clés API et le Dashboard Assistant ne voient que leur propre entreprise).any
company_logo_removeSupprimer le logo de l'entreprise (supprime l'image stockée et efface l'URL du logo).company:write
company_member_inviteInviter un membre d'équipe par e-mail avec un rôle (ADMIN, MANAGER, AGENT ou VIEWER).company:write
company_member_removeRetirer un membre d'équipe de l'entreprise.company:write
company_member_update_roleChanger le rôle d'un membre d'équipe (ADMIN, MANAGER, AGENT ou VIEWER).company:write
company_members_listLister les membres d'une entreprise avec leurs rôles (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateMettre à jour les paramètres de marque de l'entreprise : primaryColor / secondaryColor (#RRGGBB) et l'notificationEmail pour les revues de chat.company:write
company_updateMettre à jour le profil de l'entreprise : nom (2-100 caractères), description (max 1000 caractères) ou site web (https:// ajouté automatiquement ; passer une chaîne vide pour effacer site/description).company:write

Gestion des chatbots

ToolDescriptionScope
chatbot_add_instructionAjouter une nouvelle instruction de base à un chatbot (1-5000 caractères).chatbots:write
chatbot_confirm_embedMarquer un chatbot comme intégré sur le site web (cache le rappel de configuration dans le tableau de bord).chatbots:write
chatbot_createCréer un nouveau chatbot (comme l'assistant de configuration du tableau de bord).chatbots:write
chatbot_deleteSupprimer définitivement un chatbot avec toutes ses FAQs, documents, chats, leads et formulaires (irréversible).chatbots:write
chatbot_delete_instructionSupprimer une instruction de base d'un chatbot.chatbots:write
chatbot_getObtenir des informations détaillées sur un chatbot : paramètres généraux, personnalité (persona, tonalité, langues, restrictions), paramètres du widget, chat en direct, phase d'apprentissage, statut d'intégration et compteurs.chatbots:read
chatbot_get_embed_codeObtenir le snippet HTML pour installer un chatbot sur un site web (URL du script + balise <script>) et savoir si l'intégration a été confirmée.chatbots:read
chatbot_get_instructionsObtenir toutes les instructions de base d'un chatbot.chatbots:read
chatbot_improve_instructionsRéécrire le texte d'une instruction de base avec l'améliorateur IA de la plateforme (comme « Improve with AI » du tableau de bord).chatbots:write
chatbot_learning_phase_getObtenir les paramètres de la phase d'apprentissage d'un chatbot : preset de comportement (CAUTIOUS, BALANCED, CONFIDENT), prompt personnalisé et indication si le bot est encore en phase d'apprentissage.chatbots:read
chatbot_learning_phase_updateDéfinir le preset de comportement de la phase d'apprentissage (CAUTIOUS = renvoyer à un humain en cas de doute, BALANCED, CONFIDENT) et/ou un prompt personnalisé pour la phase d'apprentissage.chatbots:write
chatbot_listLister tous les chatbots auxquels l'utilisateur a accès, avec des statistiques récapitulatives.chatbots:read
chatbot_reorder_instructionsDéfinir l'ordre des instructions de base d'un chatbot.chatbots:write
chatbot_templates_listLister les templates de chatbot (préréglages pour persona, tonalité, messages et comportement du widget) qui peuvent être passés en templateId à chatbot_create, et indiquer si le plan de l'entreprise peut les utiliser.chatbots:read
chatbot_toggle_activeActiver ou désactiver un chatbot.chatbots:write
chatbot_toggle_learningTerminer (false) ou réactiver (true) la phase d'apprentissage d'un chatbot.chatbots:write
chatbot_updateMettre à jour les paramètres généraux d'un chatbot : nom, description, isActive, live chat (liveChatEnabled/liveChatMode, fonctionnalité selon le plan), showBranding (plans white-label), emails de revue de chat, génération automatique de FAQ, texte legacy coreInstructions, phase d'apprentissage (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionMettre à jour une instruction de base existante (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityMettre à jour la personnalité d'un chatbot : persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), curseurs de tonalité 1-5, langues (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), messages (welcomeMessage, fallbackMessage, proactive greeting) et restrictions (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getObtenir les paramètres actuels du widget d'un chatbot (tous les aspects d'apparence, branding, comportement et champs du formulaire pré-chat).chatbots:read
widget_settings_updateMettre à jour le widget de chat d'un chatbot : position (incl.chatbots:write
widget_translations_getObtenir les traductions par langue du widget d'un chatbot : { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateDéfinir les traductions du widget par langue.chatbots:write

Base de connaissances

ToolDescriptionScope
crawler_job_cancelAnnuler un job de crawl PENDING ou RUNNING ; les pages restantes sont ignorées.knowledge:write
crawler_job_getObtenir le statut d'un job de crawl, sa progression (pagesCrawled/pagesFound, tokensUsed) et le statut de chaque page.knowledge:read
crawler_jobs_listLister les jobs de crawl d'un chatbot (les plus récents en premier) avec statut et progression.knowledge:read
crawler_limitsObtenir les limites de crawl du plan pour un chatbot (max pages par crawl, tokens par page, crawls par mois) et savoir si un nouveau crawl peut être lancé ce mois-ci.knowledge:read
crawler_preview_scanScanner un site web et lister ses pages crawlables (url, title, isRecommended) sans rien importer.knowledge:write
crawler_startDémarrer un job de crawl qui importe les URLs sélectionnées dans la base de connaissances du chatbot (traité en arrière-plan ; poller crawler_job_get).knowledge:write
knowledge_document_add_from_urlTélécharger un document (PDF, TXT, MD, CSV, JSON, DOCX ; max 10 MB) depuis une URL publique http(s) et l'ajouter à la base de connaissances d'un chatbot.knowledge:write
knowledge_document_add_textAjouter un document texte ou markdown à la base de connaissances d'un chatbot à partir d'un contenu en ligne (max 10 MB).knowledge:write
knowledge_document_deleteSupprimer un document téléversé de la base de connaissances.knowledge:write
knowledge_document_getObtenir les détails d'un document téléversé incluant le statut de traitement, le message d'erreur et une URL de téléchargement temporaire.knowledge:read
knowledge_documents_listLister les documents téléversés (PDF, TXT, MD, CSV, JSON, DOCX) dans la base de connaissances d'un chatbot avec statut et taille.knowledge:read
knowledge_page_addCrawler une seule URL et l'ajouter à la base de connaissances du chatbot (échoue avec CONFLICT lorsque l'URL est déjà indexée, FORBIDDEN lorsque la limite de tokens est atteinte).knowledge:write
knowledge_page_deleteSupprimer une page crawlée de la base de connaissances (supprime son fichier de vector-store).knowledge:write
knowledge_page_getObtenir une page crawlée incluant le contenu markdown qui a été indexé pour le chatbot (utile pour vérifier ce que le bot connaît d'une page).knowledge:read
knowledge_page_recrawlRécupérer à nouveau une page crawlée et remplacer son contenu indexé (par ex.knowledge:write
knowledge_pages_deleteSupprimer plusieurs pages crawlées d'un chatbot en une seule fois.knowledge:write
knowledge_pages_listLister les pages crawlées dans la base de connaissances d'un chatbot, éventuellement filtrées par domaine, statut ou terme de recherche (URL/title).knowledge:read
knowledge_statsAperçu de la base de connaissances d'un chatbot : documents (par statut, taille), pages crawlées et sites web (par statut), jobs de crawl, instructions de base séparées par source (manuel vs improvement agent), FAQs, statut/tailles du vector store et usage de stockage vs.knowledge:read
knowledge_website_deleteSupprimer toutes les pages crawlées d'un site web (domaine) de la base de connaissances du chatbot.knowledge:write
knowledge_website_recrawlRe-crawler toutes les pages d'un site (domaine) dans la base de connaissances du chatbot pour actualiser son contenu.knowledge:write
knowledge_website_recrawl_cancelAnnuler un re-crawl de site en cours : les pages en file d'attente (PENDING) du domaine sont reverties à leur état indexé précédent.knowledge:write
knowledge_websites_listLister les sites web (domaines) dont les pages sont dans la base de connaissances d'un chatbot, avec le nombre de pages par statut et les totaux de tokens.knowledge:read

Gestion des prix

Ces outils gèrent des brouillons de prix structurés et des approbations explicites. Sauvegarder un brouillon est distinct de l'approbation de la version exacte ; l'éligibilité dépend aussi du statut et de la validité. Les clés API existantes ne reçoivent pas automatiquement les autorisations prix. Seul le propriétaire de l'entreprise peut accorder prices:write ou prices:approve. Les appels via clé API s'exécutent directement, donc vérifiez l'entrée exacte avant d'appeler une mutation. Voir Prices & services pour le workflow client.

ToolDescriptionScope
price_listPaginer les price heads et séparer l'éligibilité des versions approuvées.prices:read
price_getLire l'état complet d'un item et ses révisions.prices:read
price_detailLire le détail d'un item avec historique de révisions paginé.prices:read
price_suggestions_listPaginer les suggestions de prix.prices:read
price_createCréer un brouillon avec un ID d'item généré par le serveur.prices:write
price_editCréer un nouveau brouillon à partir d'une version d'item explicitement attendue.prices:write
price_import_csvImporter des brouillons avec un format explicite et un import ID stable pour des retries sûrs.prices:write
price_suggestion_applyAppliquer le candidat de suggestion sélectionné comme brouillon.prices:write
price_approveApprouver une version d'item explicitement attendue.prices:approve
price_approve_manyApprouver atomiquement une sélection explicite ID/version ; toute version obsolète rejette la sélection entière.prices:approve
price_archiveArchiver un item à sa version explicitement attendue.prices:approve

Les modifications de brouillon préservent la révision approuvée précédente. Le format CSV et le séparateur décimal doivent être explicites ; tout changement du contenu CSV nécessite un nouvel import ID. Toutes les opérations sont liées à l'entreprise de la clé API et au chatbot spécifié.

Gestion des FAQ

ToolDescriptionScope
faq_cache_purgeVider les données mises en cache du widget FAQ sur tous les sites CMS connectés (plugin WordPress).faqs:write
faq_categories_listLister les catégories FAQ d'un chatbot avec leur nombre de FAQs, slugs, mode de tri et traductions.faqs:read
faq_categories_reorderDéfinir l'ordre des catégories FAQ dans le widget : la position dans categoryIds devient le sortOrder.faqs:write
faq_category_createCréer une catégorie FAQ pour un chatbot (le slug est généré à partir du nom).faqs:write
faq_category_deleteSupprimer une catégorie FAQ.faqs:write
faq_category_translations_updateRemplacer les traductions d'une catégorie FAQ, par ex.faqs:write
faq_category_updateRenommer une catégorie FAQ ou modifier sa description, son icône ou son mode de tri.faqs:write
faq_createCréer une FAQ pour un chatbot.faqs:write
faq_deleteSupprimer définitivement une FAQ (l'enlève aussi de la base de connaissances du chatbot et purge les caches du widget CMS).faqs:write
faq_embed_code_getObtenir les snippets d'intégration pour le widget FAQ : balise script, shortcode WordPress et snippet Shopify Liquid, plus les variantes par catégorie (utiliser categorySlug de faq_categories_list pour intégrer une seule catégorie).chatbots:read
faq_getObtenir les détails complets d'une FAQ : question, réponse, catégorie, état de publication, ordre de tri, traductions, champs SEO et statistiques de feedback.faqs:read
faq_listLister les FAQs d'un chatbot (utilisez chatbot_list pour trouver le chatbotId).faqs:read
faq_reorderDéfinir l'ordre d'affichage des FAQs dans le widget.faqs:write
faq_suggestion_approveApprouver une suggestion FAQ PENDING : crée une FAQ publiée (optionnellement avec question/réponse/catégorie modifiées) et marque la suggestion APPROVED.faqs:write
faq_suggestion_getObtenir les détails complets d'une suggestion FAQ (réponse complète, raisonnement IA, catégorie suggérée, état de revue).faqs:read
faq_suggestion_rejectRejeter une suggestion FAQ PENDING avec une raison optionnelle.faqs:write
faq_suggestions_generateLaisser l'IA proposer de nouvelles FAQs à partir de la base de connaissances du chatbot (pages crawlées / documents téléversés), éventuellement pour une catégorie donnée.faqs:write
faq_suggestions_listLister les suggestions FAQ générées par l'IA d'un chatbot (à partir de conversations ou faq_suggestions_generate).faqs:read
faq_translateTraduire la question et la réponse d'une FAQ avec l'IA dans les autres langues supportées du chatbot (ou les targetLanguages fournies) et sauvegarder le résultat.faqs:write
faq_translations_updateSauvegarder les traductions d'une FAQ par langue, p. ex.faqs:write
faq_updateMettre à jour la question, la réponse, la catégorie, l'état de publication ou l'ordre de tri manuel d'une FAQ.faqs:write
faq_widget_settings_getObtenir les paramètres d'apparence et de comportement du widget FAQ intégrable (couleurs, bordure, titre, espacement, largeur max, allowMultipleOpen, autoOpenFirst, mode de tri, traductions de titre).chatbots:read
faq_widget_settings_updateMettre à jour les paramètres du widget FAQ : couleurs (hex), borderRadius 0-32, titre (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = pleine largeur), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name et traductions de titre par langue.chatbots:write

Historique des chats & Feedback

ToolDescriptionScope
chat_feedback_dismissMarquer un chat comme revu sans le noter (le retire de la file d'attente pending, ne change pas le score de confiance).chats:write
chat_feedback_getObtenir une revue de chat (feedback) avec analyse IA, gravité, catégorie de confiance, changement de score et session d'amélioration liée.chats:read
chat_feedback_listLister les revues de chat (lignes de feedback) d'un chatbot avec filtre de statut et compteurs.chats:read
chat_feedback_set_severityOutrepasser la classification de gravité (MINOR|MODERATE|MAJOR|CRITICAL) d'un chat négatif revu ; la gravité pondère la chute du score de confiance.chats:write
chat_feedback_statsComptes de sessions par bucket de revue pour un chatbot (total, none, pending, positive, negative, reviewed, improved) — les cartes statistiques de la page chats du tableau de bord.chats:read
chat_feedback_submitNoter une session de chat comme Good (isPositive=true) ou Needs Work (isPositive=false).chats:write
chat_session_getObtenir une session de chat avec la transcription complète (par message token/model/latency/pageUrl), détails du visiteur, URL de la page de démarrage, catégorie de confiance, feedback (gravité, analyse IA, session d'amélioration liée) et tags.chats:read
chat_session_searchRechercher des sessions de chat d'un chatbot par contenu de message et/ou email du visiteur.chats:read
chat_session_set_categoryAttribuer ou changer la catégorie de confiance d'une session de chat (corrige la catégorisation IA ; la confiance par catégorie est recalculée quand le chat a été revu).chats:write
chat_sessions_listLister les sessions de chat d'un chatbot, les plus récentes en premier, avec les mêmes filtres de file d'attente de revue que la page chats du tableau de bord.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listLister les catégories de confiance d'un chatbot avec score de confiance par catégorie, nombre de revues et fréquence des emails de revue.chats:read
confidence_category_createCréer une catégorie de confiance pour un chatbot.chatbots:write
confidence_category_deleteSupprimer une catégorie de confiance.chatbots:write
confidence_category_mergeFusionner une catégorie de confiance dans une autre du même chatbot : tous les chats/revues passent vers la cible, la source est supprimée et les scores sont recalculés.chatbots:write
confidence_category_updateRenommer une catégorie de confiance et/ou définir sa fréquence d'email de revue (EVERY|HOURLY|DAILY|WEEKLY|NEVER ; emailFrequencyHours 1-24 uniquement pour HOURLY).chatbots:write
confidence_status_getStatut de confiance d'un chatbot : score, seuil de graduation, flag de phase d'apprentissage, comportement de la phase d'apprentissage (CAUTIOUS|BALANCED|CONFIDENT) et prompt personnalisé, comptes de revues et scores de confiance par catégorie.analytics:read
improvement_proposal_approveApprouver une proposition d'amélioration PENDING et appliquer le changement au chatbot (ajout/mise à jour d'instruction de base, création/mise à jour de FAQ ou mise à jour de persona) — même logique et limites de plan que le tableau de bord.chatbots:write
improvement_proposal_rejectRejeter une proposition d'amélioration PENDING.chatbots:write
improvement_proposal_simulateSimuler comment le chatbot répondrait au message problématique avec une proposition appliquée (original vs.chatbots:write
improvement_proposals_pendingLister les propositions d'amélioration en attente de revue (statut PENDING) à l'échelle de l'entreprise ou pour un chatbot.chatbots:read
improvement_session_completeMarquer une session d'amélioration comme COMPLETED (le chat compte alors comme Improved dans la file d'attente de revue).chatbots:write
improvement_session_createOuvrir l'Improvement Agent pour un chat noté Needs Work.chatbots:write
improvement_session_getObtenir une session d'amélioration avec le chat original (les messages ont un index 1-based utilisable comme targetMessageIndex), la conversation de l'agent, toutes les propositions (avec leur dernière simulation) et les simulations.chatbots:read
improvement_session_resetRedémarrer une session d'amélioration : supprime tous les messages de l'agent, les simulations et les propositions PENDING/REJECTED (les propositions appliquées sont conservées) et lance une nouvelle conversation.chatbots:write
improvement_session_send_messageEnvoyer un message à l'Improvement Agent (décrire ce qui était erroné dans la réponse du bot ; optionnellement targetMessageIndex = index 1-based du message du bot dans originalChat.messages).chatbots:write
improvement_sessions_listLister les sessions d'amélioration (conversations de l'Improvement Agent démarrées depuis des revues de chat négatives) pour un chatbot ou l'ensemble de l'entreprise, les plus récentes en premier, avec le nombre de propositions.chatbots:read
improvement_simulation_assessNoter un résultat de simulation : isApproved=true lorsque la réponse simulée est bonne (la proposition peut alors être appliquée), false lorsque cela nécessite plus de travail (commentaire 'almost' = presque correct).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availableObtenir la disponibilité live chat de l'utilisateur actuel, les agents actuellement disponibles pour le live chat (heartbeat récent, le même signal que le widget utilise) et savoir si le plan de l'entreprise inclut le live chat.chats:read
live_chat_heartbeatRafraîchir le heartbeat de présence live chat de l'utilisateur actuel (uniquement lorsqu'il est marqué disponible via live_chat_set_availability).chats:write
live_chat_message_sendEnvoyer un message au visiteur en tant qu'agent assigné.chats:write
live_chat_queueObtenir la file d'attente live chat : sessions en attente d'un agent, les plus anciennes en premier (FIFO).chats:read
live_chat_session_assignPrendre une session live chat WAITING depuis la file : l'assigne à l'utilisateur actuel (propriétaire de l'entreprise pour les clés API) et notifie le visiteur que l'agent a rejoint.chats:write
live_chat_session_closeTerminer une session live chat en tant qu'agent (tout membre de l'entreprise non-VIEWER).chats:write
live_chat_session_getObtenir une session live chat avec info visiteur, agent assigné, tous les messages et la conversation bot précédente (contexte de handoff).chats:read
live_chat_sessions_listLister les sessions live chat (les plus récentes en premier ; les sessions WAITING les plus anciennes en premier) avec filtres optionnels par chatbot, statut et agent assigné.chats:read
live_chat_set_availabilityBasculer l'interrupteur 'Available for Live Chat' de l'utilisateur actuel pour une entreprise.chats:write

Leads

ToolDescriptionScope
lead_assignAssigner un lead à un membre de l'entreprise ou le désassigner (assignedToId: null).leads:write
lead_bulk_update_statusDéfinir le statut de plusieurs leads (max 100) en une seule fois.leads:write
lead_categories_listLister les catégories de leads d'un chatbot avec le nombre de leads et les membres notifiés par catégorie.leads:read
lead_category_assign_userAjouter un membre de l'entreprise à la liste de notification d'une catégorie de lead (ou mettre à jour ses flags de notification).leads:write
lead_category_createCréer une catégorie de lead pour un chatbot.leads:write
lead_category_deleteSupprimer une catégorie de lead.leads:write
lead_category_remove_userRetirer un membre de la liste de notification d'une catégorie de lead.leads:write
lead_category_updateMettre à jour le nom, la description et/ou la couleur d'une catégorie de lead.leads:write
lead_createCréer un lead manuellement (par ex.leads:write
lead_deleteSupprimer définitivement un lead.leads:write
lead_field_config_getObtenir la configuration de capture de leads d'un chatbot : champs (ids mappés aux clés dans lead.data), message de confirmation, traductions des champs/UI et paramètres de reconnaissance IA.leads:read
lead_field_config_updateMettre à jour la configuration de capture de leads d'un chatbot.leads:write
lead_getObtenir les détails complets d'un lead incluant assigné, catégorie et la transcription du chat source (paginée avec messageOffset/messageLimit, par défaut les 20 premiers messages).leads:read
lead_listLister les leads d'un chatbot (les plus récents en premier) avec filtres optionnels par statut, catégorie, assigné et recherche en texte libre (name/email/company).leads:read
lead_statsObtenir les statistiques de leads pour un chatbot : comptes par statut, leads des 7 derniers jours et taux de conversion (pourcentage).leads:read
lead_updateMettre à jour le statut, la catégorie, les notes, les données capturées et/ou l'assigné d'un lead.leads:write

Formulaires

ToolDescriptionScope
form_createCréer un formulaire de contact pour un chatbot (basique, champs, design et paramètres anti-spam en un seul appel).forms:write
form_deleteSupprimer définitivement un formulaire de contact et TOUTES ses soumissions (cascade).forms:write
form_getObtenir un formulaire de contact en entier : champs, traductions, style, paramètres anti-spam, état actif, nombre de soumissions et le code d'intégration (embedCode).forms:read
form_listLister les formulaires de contact d'un chatbot avec nombre de champs, nombre de soumissions et codes d'intégration.forms:read
form_statsComptes de soumissions d'un formulaire de contact : total, pending, approved, spam et rejected.forms:read
form_submission_deleteSupprimer définitivement une soumission de formulaire de contact (par ex.forms:write
form_submission_getObtenir une soumission de formulaire de contact en entier : données des champs soumis, score anti-spam et analyse IA anti-spam, métadonnées IP/user agent/referrer et informations de revue.forms:read
form_submission_update_statusRevoir une soumission de formulaire de contact : définir son statut sur APPROVED, SPAM ou REJECTED avec une note de revue optionnelle.forms:write
form_submissions_listLister les soumissions d'un formulaire de contact, les plus récentes en premier, éventuellement filtrées par statut (PENDING, APPROVED, SPAM, REJECTED) et date de création.forms:read
form_updateMettre à jour un formulaire de contact : nom, description, état actif (isActive contrôle si l'intégration se rend), champs (remplacement complet), design (couleurs, texte du bouton, message de succès) et paramètres anti-spam (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsRemplacer les traductions des champs et/ou de l'UI d'un formulaire de contact.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listLister le journal d'activité des emails traités d'une connexion de boîte mail (les plus récents en premier) : expéditeur, sujet, catégorie assignée, résultat (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) et outcomeDetail.email:read
email_categories_listLister les catégories d'email d'une connexion de boîte mail (ordonnées par sortOrder).email:read
email_category_createCréer une catégorie d'email pour une connexion de boîte mail (max 20 par connexion).email:write
email_category_deleteSupprimer une catégorie d'email.email:write
email_category_updateMettre à jour une catégorie d'email (partiel : seules les champs fournis changent).email:write
email_connection_disconnectDéconnecter définitivement une boîte mail.email:write
email_connection_getObtenir une connexion de boîte mail incl.email:read
email_connection_updateMettre à jour une connexion de boîte mail : mettre en pause/reprendre la sync (paused true/false ; ne fait que basculer ACTIVE<->DISABLED, ne remplace jamais TOKEN_EXPIRED/ERROR), basculer le draft de réponse (draftingEnabled) et la catégorisation/organisation (organizingEnabled), rediriger le chatbot alimentant (chatbotId de la même entreprise) ou définir la signature HTML de réponse (signatureHtml, max 20000 caractères ; chaîne vide la supprime).email:write
email_connections_listLister les connexions de boîtes mail Email Assistant de l'entreprise (adresse, statut ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, dernière sync, dernière erreur, toggles drafting/organizing, chatbot alimentant, draftReadyCategoryCount = catégories pouvant produire des brouillons, baseRuleCount = règles "Chat + Email" appliquées à chaque brouillon) ainsi que les limites du plan (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteSupprimer un contact email appris (oublier le profil de l'expéditeur, par ex.email:write
email_contact_getObtenir un contact email appris avec tous les faits appris, notes internes, relation, paramètre d'adresse formelle/informelle et statistiques email.email:read
email_contact_updateMettre à jour un contact email appris.email:write
email_contacts_listLister les contacts email appris de l'entreprise (email le plus récent en premier) avec relation, adresse formelle/informelle (formalAddress: true = adresse formelle 'Sie', false = adresse informelle 'Du', null = automatique), nombre de faits et aperçu des notes.email:read
email_folder_createCréer un dossier mail sous la boîte de réception (retourne l'existant si le nom est pris) à utiliser comme cible de déplacement de catégorie.email:write
email_folders_listLister les dossiers dans lesquels une catégorie d'email peut déplacer le courrier, en direct depuis la boîte : sous-dossiers inbox, dossiers top-level personnalisés, archive, spam et corbeille (id 'deleteditems').email:read
email_general_rules_listLister les règles applicables à chaque brouillon de réponse d'une boîte mail : instructions de base actives avec channel BOTH ("Chat + Email"), plus les anciennes règles email-only non encore migrées vers une catégorie.email:read

Analytics

ToolDescriptionScope
analytics_chat_volumeVolume de chats (sessions démarrées) dans le temps pour graphiques et tendances : période week/month/quarter/year, granularité hour/day/week/month, éventuellement pour un chatbot.analytics:read
analytics_chatbot_statsPerformance par chatbot d'une entreprise en un appel (la table de performance chatbot du tableau de bord) : id, name, slug, isActive, sessions, messages, FAQs et leads par chatbot, trié par sessions.analytics:read
analytics_formsStatistiques de soumissions de formulaires de contact pour une entreprise ou un chatbot (widget analytics du tableau de bord) : soumissions par statut (pending/approved/rejected/spam), nombre de formulaires, total, taux de spam en pourcentage et la série submissions-per-day des 7 derniers jours.analytics:read
analytics_leadsEntonnoir de leads pour une entreprise ou un chatbot (widget analytics du tableau de bord) : leads par statut (new/contacted/qualified/converted/lost), total, taux de conversion en pourcentage et la série leads-per-day des 7 derniers jours.analytics:read
analytics_overviewAperçu analytics pour une entreprise ou un chatbot : chats, messages, taux de satisfaction et questions principales pour une période roulante (day/week/month/year), plus le widget overview du tableau de bord (total chatbots/published FAQs/leads, sessions aujourd'hui/cette semaine/ce mois, leads aujourd'hui/cette semaine, soumissions de formulaire total/aujourd'hui/pending).analytics:read
dashboard_activityCe qui nécessite actuellement de l'attention (vue d'accueil du tableau de bord) : par entreprise, les chatbots avec de nouveaux leads aujourd'hui, suggestions FAQ pending, soumissions de formulaire pending, live chats en attente/actifs ou une phase d'apprentissage en cours.any

Scénarios d'exemple

Ajouter une instruction de base

Demandez à votre assistant IA :

« Ajoutez une instruction de base à mon chatbot 'Support Bot' : nous offrons la livraison gratuite pour les commandes supérieures à 50 € »

L'assistant utilisera chatbot_add_instruction avec les paramètres appropriés.

Examiner des suggestions d'amélioration

« Montrez-moi toutes les propositions d'amélioration en attente pour mon chatbot et expliquez les changements qu'elles proposent »

L'assistant :

  1. Utilisera improvement_proposals_pending pour récupérer les propositions
  2. Analysera et résumera chaque suggestion
  3. Les approuvera ou les rejettera en votre nom avec improvement_proposal_approve ou improvement_proposal_reject

Analyser la performance des chats

« Donnez‑moi un rapport hebdomadaire du volume de chats et de la satisfaction client pour mon chatbot »

L'assistant utilisera analytics_overview et analytics_chat_volume pour compiler un rapport complet.

Importer un site web

« Scannez https://example.com, importez les pages produit et tarif dans mon 'Support Bot' et dites‑moi quand le crawl est terminé »

L'assistant appellera crawler_preview_scan, sélectionnera les pages pertinentes, démarrera l'import avec crawler_start et interrogera crawler_job_get jusqu'à la fin du job.

Examiner les leads et soumissions de formulaires

« Montrez‑moi les nouveaux leads de cette semaine, assignez les qualifiés à Anna et approuvez les soumissions de formulaires en attente »

L'assistant combine lead_list, lead_assign, form_submissions_list et form_submission_update_status.

Prendre en charge un live chat

« Passez disponible pour le live chat et prenez la conversation en attente la plus ancienne »

L'assistant utilise live_chat_set_availability, live_chat_queue et live_chat_session_assign ; les réponses passent par live_chat_message_send.

Sécurité

  • Les clés API sont liées à votre entreprise et aux scopes d'autorisation que vous sélectionnez lors de leur création (voir la colonne Scope ci‑dessus)
  • Les clés s'exécutent avec les autorisations du propriétaire de l'entreprise ; les limites de plan et les gates de fonctionnalités s'appliquent exactement comme dans le tableau de bord
  • Les clés peuvent être révoquées à tout moment depuis le tableau de bord
  • L'accès API est disponible sur les offres payantes — voir notre Pricing page

Dépannage

Connexion échouée

  1. Vérifiez que votre clé API est correcte
  2. Vérifiez que la clé n'a pas été révoquée
  3. Assurez‑vous que votre plan inclut l'accès API
  4. Redémarrez votre client MCP

Outil introuvable

Redémarrez votre client MCP après avoir modifié la configuration afin qu'il recharge les outils disponibles. Les noms d'outils sont en minuscules avec des underscores (par ex., faq_list).


Besoin d'aide ? Contactez notre équipe support →