Connectez votre IA à Help Scout

Ce que votre IA peut faire avec Help Scout

Une fois connecté, ces outils apparaissent automatiquement dans votre assistant IA :

• list_mailboxeslecture seule

  Listez les boîtes de réception du compte.

• list_conversationslecture seule

  Listez les conversations, éventuellement filtrées par boîte et par statut.

• get_conversationlecture seule

  Obtenez une conversation avec ses fils de discussion (messages).

• list_conversation_threadslecture seule

  Listez les fils d'une conversation à part, paginés — ce qu'a écrit le client, ce qu'ont répondu les agents, et les notes internes. Préférez cet outil à get_conversation quand un long échange doit être lu au-delà de sa première page.

• search_conversationslecture seule

  Cherchez des conversations par leur contenu, leur objet, leur client ou leur tag, avec la syntaxe de requête de Help Scout — par exemple subject:"remboursement" ou tag:urgent.

• add_noteécriture · approbation requise

  Ajoutez une note interne à une conversation. Seule l'équipe la voit, rien n'atteint le client. C'est la façon sûre pour une IA de déposer un résumé ou un constat sur un ticket. Action d'écriture : soumise au garde-fou de confirmation quand il est activé.

• reply_to_conversationécriture · approbation requise

  Rédigez une réponse au client. Elle est créée en BROUILLON par défaut, en attente dans Help Scout qu'un humain la relise et l'envoie — car une réponse publiée part immédiatement par email et ne se rattrape pas. Ne passez draft: false que si l'envoi immédiat a été demandé. Pour quelque chose que seule l'équipe doit voir, utilisez add_note. Action d'écriture : soumise au garde-fou de confirmation quand il est activé.

• schedule_replyécriture · approbation requise

  Programmez l'envoi différé d'un brouillon de réponse existant. S'applique au brouillon créé par reply_to_conversation — reprenez son identifiant dans le résultat. Une nouvelle programmation remplace la précédente. Action d'écriture : soumise au garde-fou de confirmation quand il est activé.

• create_conversationécriture · approbation requise

  Ouvrez une conversation dans une boîte avec un premier message — consigner un appel, enregistrer ce qu'un client a dit ailleurs. La création n'envoie pas d'email au client sauf si autoReply est demandé. Pour un historique repris d'un autre outil, activez imported : Help Scout ne génère alors ni email ni notification. Action d'écriture : soumise au garde-fou de confirmation quand il est activé.

• update_conversationécriture · approbation requise

  Changez l'objet, le statut, le propriétaire ou la boîte d'une conversation. Affectez-la à une personne ou à une équipe avec assignTo, ou remettez-la dans la file avec unassign. Action d'écriture : soumise au garde-fou de confirmation quand il est activé.

• set_conversation_tagsécriture · approbation requise

  Définissez les tags d'une conversation. ATTENTION, CELA REMPLACE TOUT : chaque tag absent de la liste est retiré, et une liste vide les efface tous. Il n'existe aucun moyen d'ajouter un seul tag — lisez d'abord les tags actuels avec get_conversation, puis renvoyez-les avec le nouveau. Action d'écriture : soumise au garde-fou de confirmation quand il est activé.

• list_customerslecture seule

  Listez ou cherchez des clients, par email, par nom ou par organisation.

• get_customerlecture seule

  Obtenez la fiche d'un client, avec ses emails, téléphones et son organisation.

• create_customerécriture · approbation requise

  Créez une fiche client. Action d'écriture : soumise au garde-fou de confirmation quand il est activé.

• update_customerécriture · approbation requise

  Mettez à jour les champs d'une fiche client. Seul ce que vous passez est modifié, le reste est laissé tel quel. Les emails et téléphones se gèrent à part et ne sont pas touchés ici. Action d'écriture : soumise au garde-fou de confirmation quand il est activé.

• get_mailboxlecture seule

  Obtenez une boîte de réception, avec son adresse d'envoi et ses réglages.

• list_saved_replieslecture seule

  Listez les réponses enregistrées d'une boîte — les formulations que l'équipe a déjà validées. À lire avant de rédiger, pour qu'une réponse ressemble à ce que l'équipe écrit vraiment.

• list_userslecture seule

  Listez les agents du compte.

• get_userlecture seule

  Obtenez un agent par son identifiant.

• get_current_userlecture seule

  Obtenez l'agent auquel appartient la connexion — celui que Help Scout considère comme l'auteur des actions. Utile à savoir avant d'affecter ou de signer quoi que ce soit.

• list_teamslecture seule

  Listez les équipes du compte. Une équipe peut posséder une conversation, comme un agent.

• list_team_memberslecture seule

  Listez les agents d'une équipe.

• list_tagslecture seule

  Listez les tags du compte. À lire avant set_conversation_tags, pour réutiliser un tag existant plutôt que d'en créer un presque identique.

• get_taglecture seule

  Obtenez un tag par son identifiant.

• list_organizationslecture seule

  Listez les organisations — les entreprises sous lesquelles les clients sont regroupés, avec leurs domaines, leur site et leurs notes.

• get_organizationlecture seule

  Obtenez une organisation par son identifiant.

• get_ratinglecture seule

  Obtenez une note de satisfaction : le score (great, okay, not_good), le commentaire du client, l'agent dont la réponse a été notée et la conversation concernée. L'identifiant est celui de la note, pas de la conversation.

• get_company_reportlecture seule

  Vue d'ensemble de l'entreprise sur une période : clients aidés, conversations closes, réponses envoyées, réponses par jour et par agent, avec les mêmes chiffres sur une période précédente et l'écart.

• get_company_customers_helpedlecture seule

  Nombre de clients distincts aidés par l'équipe, tracé sur la période. viewBy fixe la résolution : jour jusqu'à 60 jours, semaine jusqu'à un an, mois au-delà.

• get_company_drilldownlecture seule

  Les conversations qui composent un chiffre d'entreprise, page par page. range indique lequel, rangeId le précise quand il en accepte un.

• get_conversations_reportlecture seule

  Volume de conversations sur une période : entrées, closes, encore ouvertes, face à la période précédente.

• get_conversations_newlecture seule

  Nouvelles conversations dans le temps — la courbe des arrivées, à la résolution demandée.

• get_conversations_busy_timeslecture seule

  Quand les conversations arrivent réellement, en grille jour de semaine × heure. Le rapport qui répond aux questions d'effectif, pas de performance.

• get_conversations_received_messageslecture seule

  Messages reçus dans le temps, ce qui n'est pas la même chose que les conversations : un fil peut en porter plusieurs.

• get_conversations_volume_by_channellecture seule

  Volume réparti par canal — email, chat, téléphone — dans le temps.

• get_conversations_drilldownlecture seule

  Les conversations comptées par le rapport conversations, listées page par page.

• get_conversations_new_drilldownlecture seule

  Les conversations comptées comme nouvelles, listées page par page.

• get_conversations_field_drilldownlecture seule

  Les conversations derrière un tag, une réponse enregistrée, un workflow ou un client. field dit lequel des quatre, fieldId lequel en particulier.

• get_productivity_reportlecture seule

  Productivité de l'équipe sur la période : délai de première réponse, délai de réponse, délai de résolution, réponses envoyées, résolutions. officeHours mesure en heures ouvrées plutôt qu'en temps calendaire.

• get_productivity_first_response_timelecture seule

  Délai de première réponse sur la période — combien de temps un client attend avant la première réponse humaine.

• get_productivity_response_timelecture seule

  Délai de réponse sur la période, en comptant chaque réponse et pas seulement la première.

• get_productivity_resolution_timelecture seule

  Délai de résolution sur la période — combien de temps une conversation reste ouverte avant d'être close.

• get_productivity_replies_sentlecture seule

  Réponses envoyées sur la période, à la résolution demandée.

• get_productivity_resolvedlecture seule

  Conversations résolues sur la période, à la résolution demandée.

• get_happiness_reportlecture seule

  Score de satisfaction sur une période : combien de notes great, okay et not good, avec la même répartition sur la période précédente.

• get_happiness_ratingslecture seule

  Les notes de satisfaction une par une, avec le commentaire du client. rating filtre sur great, ok ou not-good : c'est là qu'on lit ce qu'un client mécontent a réellement écrit.

• get_user_reportlecture seule

  Les chiffres d'un agent sur une période : conversations traitées, réponses envoyées, délais de réponse et de résolution, satisfaction, face à la période précédente.

• get_user_customers_helpedlecture seule

  Nombre de clients distincts aidés par un agent, tracé sur la période.

• get_user_replieslecture seule

  Réponses envoyées par un agent sur la période, à la résolution demandée.

• get_user_resolutionslecture seule

  Conversations résolues par un agent sur la période, à la résolution demandée.

• get_user_happinesslecture seule

  Score de satisfaction d'un agent sur la période, face à la précédente.

• get_user_ratingslecture seule

  Les notes reçues par un agent, une par une, avec le commentaire du client. Filtrez avec rating pour ne lire que les mauvaises.

• get_user_conversation_historylecture seule

  Les conversations traitées par un agent sur la période, avec leur nombre de réponses et leurs délais. sortField remonte les plus lentes en tête.

• get_user_drilldownlecture seule

  Les conversations derrière les chiffres d'un agent, listées page par page.

• get_user_chat_reportlecture seule

  Les chiffres de chat d'un agent sur la période : chats traités, délais de réponse et de résolution.

• get_chat_reportlecture seule

  Les chiffres de chat de l'équipe sur la période, face à la précédente.

• get_email_reportlecture seule

  Les chiffres d'email de l'équipe sur la période, face à la précédente.

• get_phone_reportlecture seule

  Les chiffres de téléphone de l'équipe sur la période, face à la précédente.

• get_docs_reportlecture seule

  Performance de la base de connaissances Docs sur la période : vues, recherches, et les recherches restées sans résultat — la liste de ce que vos clients ont cherché sans le trouver.

Exemples de prompts

Demandez simplement à votre IA en langage naturel — elle choisit le bon outil Help Scout :

• “Listez les boîtes de réception du compte — depuis Help Scout, en langage naturel.”
• “Listez les conversations, éventuellement filtrées par boîte et par statut — depuis Help Scout, en langage naturel.”
• “Obtenez une conversation avec ses fils de discussion (messages) — depuis Help Scout, en langage naturel.”
• “Listez les fils d'une conversation à part, paginés — ce qu'a écrit le client, ce qu'ont répondu les agents, et les notes internes. Préférez cet outil à get_conversation quand un long échange doit être lu au-delà de sa première page — depuis Help Scout, en langage naturel.”

Comment ça marche

1. Créez votre compte Proxoria et ajoutez votre endpoint MCP à Claude ou ChatGPT.
2. Connectez Help Scout avec votre clé API — chaque utilisateur connecte son propre compte, identifiants chiffrés au repos.
3. Votre IA obtient aussitôt les outils Help Scout. Les actions d'écriture attendent votre approbation dans le tableau de bord avant tout changement.

Questions fréquentes

Help Scout a-t-il un serveur MCP officiel ?

Vous n'en avez pas besoin. Proxoria expose Help Scout à votre IA via le Model Context Protocol — utilisable depuis Claude, ChatGPT, Mistral ou tout client compatible MCP, sans serveur MCP officiel Help Scout.

Que peut faire mon IA avec Help Scout via Proxoria ?

Elle obtient 59 outils : list_mailboxes, list_conversations, get_conversation, list_conversation_threads, search_conversations, add_note, reply_to_conversation, schedule_reply, create_conversation, update_conversation, set_conversation_tags, list_customers, get_customer, create_customer, update_customer, get_mailbox, list_saved_replies, list_users, get_user, get_current_user, list_teams, list_team_members, list_tags, get_tag, list_organizations, get_organization, get_rating, get_company_report, get_company_customers_helped, get_company_drilldown, get_conversations_report, get_conversations_new, get_conversations_busy_times, get_conversations_received_messages, get_conversations_volume_by_channel, get_conversations_drilldown, get_conversations_new_drilldown, get_conversations_field_drilldown, get_productivity_report, get_productivity_first_response_time, get_productivity_response_time, get_productivity_resolution_time, get_productivity_replies_sent, get_productivity_resolved, get_happiness_report, get_happiness_ratings, get_user_report, get_user_customers_helped, get_user_replies, get_user_resolutions, get_user_happiness, get_user_ratings, get_user_conversation_history, get_user_drilldown, get_user_chat_report, get_chat_report, get_email_report, get_phone_report, get_docs_report. Par exemple : listez les boîtes de réception du compte.

Le connecteur Help Scout est-il en lecture seule ?

Non — il peut aussi modifier des données. Les actions d'écriture passent par le garde-fou de confirmation de Proxoria : votre IA les propose, et vous approuvez chacune depuis votre tableau de bord avant tout changement dans Help Scout.

Comment connecter Help Scout à mon IA ?

Créez un compte Proxoria, connectez Help Scout avec votre clé API, et ajoutez votre endpoint MCP Proxoria à Claude ou ChatGPT. Votre IA obtient aussitôt les outils Help Scout.