Comment configurer HubSpot WhatsApp MCP avec Claude ou ChatGPT (testé)

Votre pipeline vit dans HubSpot. Les conversations qui le font avancer se déroulent sur WhatsApp — sur le téléphone de chaque commercial, dans des groupes clients, tard le soir. TimelinesAI synchronise déjà ces chats avec le bon contact et la bonne transaction HubSpot, donc rien n'est perdu quand un commercial est absent ou quitte l'entreprise.

Ce guide couvre l'étape suivante : poser des questions qui ont besoin des deux à la fois. Quelles transactions sont devenues silencieuses ? Qu'est-ce que le client a réellement dit ? Qui, dans l'équipe, doit une réponse ? Avec le connecteur officiel de HubSpot et le serveur MCP de TimelinesAI activés dans le même chat IA, vous pouvez poser exactement cette question, en langage naturel, et obtenir une seule réponse.

Nous avons mis en place tout cela sur notre propre compte HubSpot et notre propre espace WhatsApp avant d'écrire le moindre mot. Tout ce qui suit est ce que nous avons observé, y compris ce qui n'a pas fonctionné du premier coup.

Points clés

• Le connecteur HubSpot sait quand vous avez parlé à un client sur WhatsApp pour la dernière fois. Il ne peut pas voir ce qui a été dit. Le serveur MCP de TimelinesAI lit la conversation.
• Activez les deux dans un même chat — dans Claude, ChatGPT ou un autre assistant qui accepte un serveur MCP distant — et demandez "quelles transactions nous attendent" en langage naturel. La configuration prend environ 10 minutes, sans code.
• HubSpot peut rester en lecture seule. Chaque question de ce guide fonctionne avec ses permissions par défaut.
• Faites correspondre les clients par numéro de téléphone, pas par nom, et regroupez "qui attend" par responsable WhatsApp, pas par propriétaire de la transaction.
• Aucun coût supplémentaire de la part de TimelinesAI ou de HubSpot. Le MCP WhatsApp est inclus dans votre forfait TimelinesAI, et les connecteurs HubSpot sont disponibles à tous les niveaux. Il vous faut seulement un forfait IA payant.

Ce que signifie "HubSpot WhatsApp MCP"

Le MCP (Model Context Protocol) est le standard ouvert que les assistants IA utilisent pour se connecter à d'autres applications. Une configuration HubSpot WhatsApp MCP signifie que votre assistant IA — Claude, ChatGPT ou un autre — est connecté à deux serveurs MCP en même temps :

• Le connecteur officiel de HubSpot — la connexion propre de HubSpot à votre CRM, disponible pour Claude, ChatGPT, Microsoft 365 Copilot et Gemini.
• Le serveur MCP WhatsApp de TimelinesAI — la connexion aux conversations WhatsApp de votre équipe, sur tous les numéros.

Vous n'écrivez pas de code et n'exécutez aucun serveur. Vous ajoutez deux connecteurs à votre assistant, et c'est lui qui décide lequel interroger pour chaque partie de votre question.

Cela ne remplace pas la synchronisation. TimelinesAI continue de copier chaque conversation dans HubSpot comme aujourd'hui. Le MCP est la façon de poser des questions qui couvrent les deux.

Quels assistants IA fonctionnent

Il vous faut un assistant capable de maintenir les deux connexions en même temps. HubSpot propose une connexion officielle pour quatre assistants. TimelinesAI se connecte à tout assistant qui accepte un serveur MCP distant.

Nous avons effectué tous les tests de ce guide avec Claude. Le connecteur HubSpot pour ChatGPT fonctionne selon le même modèle de permissions — un super administrateur l'approuve et choisit ce à quoi il peut accéder — donc la configuration, les prompts et les pièges s'appliquent de la même façon.

Ce que chaque connecteur peut faire et ne peut pas faire

En une phrase : le connecteur HubSpot sait quand vous avez parlé à un client pour la dernière fois. TimelinesAI sait ce qui a été dit. Il vous faut les deux pour répondre à "qui nous attend".

Le connecteur HubSpot, en détail

HubSpot liste tout ce que son connecteur peut être autorisé à faire sur l'écran que vous voyez au moment de le connecter.

• Par défaut : lire les contacts, entreprises, transactions et tickets.
• Avec des permissions de lecture optionnelles : notes, appels, réunions, tâches, e-mails individuels, conversations de la boîte de réception, utilisateurs et équipes, leads, listes, devis, factures et plus encore.
• Avec des permissions d'écriture optionnelles : créer et mettre à jour des contacts, entreprises, transactions, tickets, notes, tâches et plus encore. L'accès en écriture doit être autorisé par un super administrateur HubSpot.
• Non disponible, quel que soit le niveau de permission : envoyer un message sur n'importe quel canal, répondre à une conversation de la boîte de réception ou l'assigner, et le type d'enregistrement que HubSpot utilise pour les messages WhatsApp consignés.

Le serveur MCP de TimelinesAI, en détail

34 outils, couvrant les numéros de l'app WhatsApp Business et les numéros de l'API WhatsApp Business, pour toute votre équipe :

• Trouver et lire : rechercher des chats par téléphone, nom, étiquette, membre de l'équipe ou statut de lecture ; lire l'historique complet, y compris les chats de groupe ; voir si la fenêtre de 24 heures d'un chat API est encore ouverte.
• Organiser : assigner ou désassigner un membre de l'équipe, ajouter ou retirer des étiquettes, clôturer ou rouvrir un chat.
• Agir (configurez-les pour demander une confirmation) : envoyer un message, répondre à un message précis, réagir, envoyer un modèle approuvé, démarrer un nouveau chat API.
• Espace de travail : lister vos numéros, votre équipe et votre consommation.

Comment les deux fonctionnent ensemble

Prenons la question "lesquelles de mes transactions sont devenues silencieuses, et pourquoi". Votre assistant y répond en quatre étapes :

1. Vous posez la question en langage naturel, dans un chat normal.
2. HubSpot trouve les transactions sans activité récente, leurs contacts et leurs numéros de téléphone.
3. TimelinesAI trouve le chat de chaque client par son numéro de téléphone et lit les derniers messages.
4. Votre assistant combine les deux en une seule réponse : qui attend, depuis quand, et sur quoi.

Si vous demandez ensuite une réponse, l'assistant la rédige, vous l'approuvez, et TimelinesAI l'envoie depuis le numéro de votre équipe. Le message arrive dans votre boîte de réception partagée et sur la fiche HubSpot, comme n'importe quel autre message WhatsApp.

Quatre façons de connecter HubSpot, WhatsApp et l'IA

Si vous êtes en train de choisir une configuration, voici comment les options se distinguent.

Si votre équipe utilise déjà WhatsApp via le canal de boîte de réception propre à HubSpot, le connecteur HubSpot peut lire ces fils de discussion — mais ne peut toujours pas y répondre. Si vous êtes sur n'importe quel autre niveau HubSpot, si vous utilisez des numéros de l'app WhatsApp Business, ou si vous voulez que votre assistant agisse sur une conversation, il vous faut un connecteur WhatsApp en plus.

Avant de commencer

• Un assistant IA qui accepte les deux connecteurs : Claude sur un forfait payant (Pro, Max, Team ou Enterprise), ou ChatGPT sur Plus, Pro, Business, Enterprise ou Education.
• HubSpot à n'importe quel niveau, y compris Free et Starter, et un compte utilisateur HubSpot.
• TimelinesAI avec l'intégration HubSpot activée, et les numéros de votre équipe connectés. Le MCP WhatsApp est inclus dans votre forfait. Nouveau sur le sujet ? Commencez par synchroniser WhatsApp avec HubSpot.
• La permission de connecter des applications dans HubSpot. Les utilisateurs ayant accès à l'App Marketplace peuvent se connecter directement ; tous les autres ont besoin qu'un super administrateur approuve d'abord le connecteur.
• Un forfait IA adapté à votre volume. Les questions occasionnelles fonctionnent bien avec les forfaits payants standard. Une équipe qui fait cela chaque matin sur une grosse boîte de réception consomme bien plus — notre guide de configuration du WhatsApp MCP donne des chiffres mesurés.

Configurez-le dans Claude (environ 10 minutes)

Étape 1 : Connecter HubSpot

Dans Claude, allez dans Personnaliser → Connecteurs, cherchez HubSpot et cliquez sur Connecter. Connectez-vous à HubSpot et choisissez votre compte.

HubSpot vous montre alors ce à quoi Claude peut accéder. Les valeurs par défaut — lire les contacts, entreprises, transactions et tickets — suffisent pour toutes les questions de ce guide. Si vous en voulez plus, cochez uniquement les permissions Afficher :

• Notes, appels, réunions et tâches — pour "ce qui s'est passé sur cette transaction"
• Utilisateurs et équipes — pour que "mes transactions" fonctionne sans taper votre nom
• Exécuter des requêtes — pour des totaux et répartitions sur tout le pipeline

Vous n'avez besoin de rien qui dise créer, modifier ou publier. Si ces options sont grisées, un super administrateur HubSpot doit les autoriser.

Étape 2 : Connecter TimelinesAI

Toujours dans Personnaliser → Connecteurs, cliquez sur +, puis sur Ajouter un connecteur personnalisé. Nommez-le TimelinesAI et collez l'URL du serveur : https://mcp.services.timelines.ai/mcp. Cliquez sur Ajouter, puis sur Connecter, connectez-vous à TimelinesAI et approuvez. Il n'y a aucune clé API à copier.

Sur un forfait Team ou Enterprise, un propriétaire ajoute le connecteur une seule fois, dans Paramètres de l'organisation → Connecteurs ; ensuite, chaque personne connecte son propre compte (le guide de Claude).

Enfin, ouvrez les paramètres d'outils de chaque connecteur et réglez tout ce qui envoie, met à jour ou assigne sur demander une confirmation. HubSpot recommande la même chose pour son propre connecteur.

Étape 3 : Activer les deux dans le même chat

Dans un nouveau chat, cliquez sur + en bas à gauche, ouvrez Connecteurs, et assurez-vous que HubSpot et TimelinesAI sont tous les deux activés. Les connecteurs s'activent par conversation.

Étape 4 : Vérifier que ça fonctionne

Posez deux questions rapides. Si les deux répondent, vous êtes prêt :

Combien de transactions ouvertes avons-nous dans HubSpot, par étape ?

Liste nos numéros WhatsApp dans TimelinesAI et indique si chacun est connecté.

La première question est celle de HubSpot ; la seconde, celle de TimelinesAI.

Configurez-le dans ChatGPT

1. Connecter HubSpot. Ajoutez le connecteur HubSpot pour ChatGPT et connectez-vous. Les mêmes approbation de super administrateur et permissions de données qu'avec Claude s'appliquent.
2. Activer le mode développeur. Dans ChatGPT sur le web, ouvrez Paramètres → Sécurité et connexion et activez le Mode développeur. Disponible sur Plus, Pro, Business, Enterprise et Education ; sur un compte professionnel, votre administrateur devra peut-être l'autoriser (le guide d'OpenAI).
3. Ajouter TimelinesAI. Créez une application en mode développeur avec l'URL du serveur https://mcp.services.timelines.ai/mcp, puis connectez-vous à TimelinesAI.
4. Poser la question avec les deux activés. Activez TimelinesAI pour le chat et incluez le mot "HubSpot" dans votre question — c'est le conseil de HubSpot lui-même pour faire intervenir son connecteur.
5. Garder les actions soumises à confirmation. Configurez le connecteur HubSpot pour qu'il demande une confirmation avant toute mise à jour, comme le recommande HubSpot, et vérifiez chaque envoi proposé avant de le confirmer.

Configurez-le dans Claude Code, Cursor ou Codex

Pour les analystes et les équipes techniques. TimelinesAI ne demande qu'une seule ligne de configuration dans chaque outil — les extraits sont dans notre guide de configuration du WhatsApp MCP. Côté HubSpot, les développeurs se connectent au serveur MCP distant de HubSpot, qui nécessite une application d'authentification MCP HubSpot. Nous avons effectué les tests de ce guide depuis Claude Code avec les deux connecteurs branchés.

Une revue de pipeline du lundi, du début à la fin

Voici la question qui justifie toute la configuration. Demandez :

Montre-moi mes transactions ouvertes sans activité depuis 7 jours. Pour chacune, retrouve la conversation WhatsApp du client dans TimelinesAI et dis-moi ce qu'il a dit en dernier et si on lui a répondu.

En coulisses, HubSpot trouve les transactions silencieuses et le numéro de téléphone de chaque contact ; TimelinesAI trouve le chat de chacun par ce numéro et lit les derniers messages. La réponse revient sous forme d'un seul tableau : quelles transactions vous attendent, depuis quand, et sur quoi.

Demandez ensuite les relances, sans rien envoyer :

Rédige une courte relance pour les trois qui nous attendent, dans la langue dans laquelle ils ont écrit. N'envoie rien.

Votre assistant rédige chaque réponse dans la langue du client. Quand vous dites "envoie la première", il demande une confirmation avant que TimelinesAI n'envoie quoi que ce soit. Rien n'atteint un client tant que vous ne l'autorisez pas.

Bibliothèque de prompts

Copiez-les tels quels, ou remplacez par vos propres étapes, noms et périodes. Plus d'idées dans les cas d'usage du WhatsApp MCP.

Pipeline

• "Quelles transactions à l'étape Contrat envoyé se clôturent ce mois-ci et n'ont eu aucune activité depuis 7 jours ? Pour chacune, qu'est-ce que le client a dit en dernier sur WhatsApp ?"
• "Avant mon appel avec [entreprise] : résume la transaction HubSpot et nos 30 derniers messages WhatsApp avec eux."
• "Quelles transactions ont avancé cette semaine sur WhatsApp mais sont toujours à la même étape dans HubSpot ?"

Équipe

• "Quels clients nous ont écrit en dernier sans avoir encore reçu de réponse ? Du plus ancien au plus récent, avec le membre de l'équipe assigné."
• "Combien de clients chaque membre de l'équipe doit-il actuellement une réponse ?"
• "Quels chats WhatsApp de cette semaine ne sont assignés à personne ?"

Client

• "Qu'avons-nous promis à [entreprise] sur WhatsApp ce mois-ci, et l'avons-nous tenu ?"
• "Dans le groupe WhatsApp avec [client], qui a demandé quoi, et qu'est-ce qui reste en attente ?"
• "Traduis les 10 derniers messages de [client] en français et dis-moi ce dont il a besoin."

Action (demander confirmation avant)

• "Rédige des réponses pour tous ceux qui attendent depuis plus de 24 heures, dans leur langue. N'envoie rien."
• "Assigne les chats non assignés de cette semaine à [membre de l'équipe]."
• "Lesquels de nos chats API WhatsApp Business ont encore une fenêtre de 24 heures ouverte ?"

Vous préférez le terminal ? Les mêmes données WhatsApp fonctionnent dans Claude Code — voir l'analyse WhatsApp avec Claude Code.

Ce que nous avons appris en le configurant

1. La connexion HubSpot par défaut est plus étroite qu'on ne le pense. Elle couvre quatre types d'enregistrements : contacts, entreprises, transactions et tickets. Demandez des notes, des appels, votre propre utilisateur ou un décompte de pipeline, et Claude répond : "Ce connecteur nécessite des permissions supplémentaires." Se reconnecter seul n'a pas résolu le problème pour nous : un super administrateur doit d'abord autoriser les permissions supplémentaires, puis chaque utilisateur se reconnecte.
2. Faites correspondre par numéro de téléphone, pas par nom. Un contact HubSpot dans notre test avait quatre chats WhatsApp — un pour chaque membre de l'équipe qui lui avait parlé — et aucun ne portait le même nom que le contact HubSpot. Les transactions créées depuis WhatsApp conservent aussi le nom du chat du jour de leur création. Demandez à l'assistant de faire correspondre par téléphone et d'utiliser le chat avec le message le plus récent.
3. Le propriétaire de la transaction n'est pas toujours la personne qui répond sur WhatsApp. Sur notre compte, chaque transaction créée depuis WhatsApp appartenait à un seul propriétaire HubSpot, alors que les chats étaient assignés à différents membres de l'équipe. Pour savoir "qui doit une réponse à qui", fiez-vous au responsable WhatsApp.
4. La synchronisation est très précise. L'heure de "dernier contact" de HubSpot et le dernier message de TimelinesAI étaient à 14 secondes d'écart. Faites confiance aux dates de HubSpot pour "qui est devenu silencieux" et à TimelinesAI pour "ce qui a été dit".
5. Les numéros déconnectés comptent quand même. Votre assistant peut lire l'historique d'un numéro déconnecté, mais ne peut rien envoyer depuis celui-ci — utile quand un commercial quitte l'entreprise.

Dépannage

• "Ce connecteur nécessite des permissions supplémentaires." La connexion HubSpot par défaut couvre quatre types d'enregistrements. Demandez à un super administrateur d'autoriser les permissions d'affichage dont vous avez besoin, puis reconnectez HubSpot.
• Les options de permission sont grisées. Votre compte restreint ce à quoi le connecteur peut accéder. Un super administrateur approuve le connecteur et ses permissions de données.
• L'assistant ne répond qu'à partir d'une seule application. L'autre connecteur n'est pas activé pour ce chat. Dans Claude : + → Connecteurs, activez les deux. Dans ChatGPT : activez l'application TimelinesAI et incluez "HubSpot" dans votre question. Nommer l'application ("dans TimelinesAI") aide dans tous les cas.
• Il ne trouve pas le chat d'un client. Les noms des chats ne correspondent pas aux noms HubSpot, ou le format du numéro diffère. Demandez-lui de faire correspondre par téléphone au format international (+indicatif pays), et vérifiez le champ téléphone du contact dans HubSpot.
• Il a choisi une ancienne conversation. Un client peut avoir plusieurs chats, un par numéro de membre de l'équipe. Demandez le chat avec le message le plus récent.
• Les décomptes "en attente" par commercial semblent faux. Le propriétaire de la transaction dans HubSpot n'est pas le responsable WhatsApp. Regroupez par responsable WhatsApp.
• La réponse s'arrête ou ralentit sur des questions volumineuses. Lire des mois d'historique atteint les limites d'utilisation. Restreignez à une seule période, un seul numéro ou une seule étiquette à la fois.
• TimelinesAI vous demande de vous reconnecter. La session a expiré. Reconnectez TimelinesAI dans les paramètres de connecteurs de votre assistant.
• Un message ne s'envoie pas. Le numéro est déconnecté, ou la fenêtre de 24 heures d'un chat API s'est fermée. Reconnectez le numéro, ou envoyez un modèle approuvé.
• Aucune donnée d'activité ni de conversation en provenance de HubSpot. Les données sensibles sont activées sur votre compte HubSpot, et HubSpot les bloque volontairement — voir les paramètres de données sensibles de HubSpot.

Permissions et sécurité

• HubSpot reste en lecture seule sauf si un super administrateur autorise les permissions d'écriture. Rien dans ce guide n'en a besoin.
• Rien n'atteint un client sans votre approbation lorsque les outils d'envoi de TimelinesAI sont réglés pour demander une confirmation. L'assistant rédige ; vous décidez.
• Dans Claude, attention au mode Recherche. Claude peut appeler automatiquement les outils des connecteurs pendant Recherche, sans demander à chaque fois. Désactivez TimelinesAI, ou gardez ses outils d'envoi bloqués, avant de lancer Recherche.
• Dans ChatGPT, le mode développeur est réservé aux serveurs auxquels vous faites confiance. OpenAI conseille de ne connecter que des serveurs MCP en qui vous avez confiance, et HubSpot conseille de vérifier chaque modification proposée par ChatGPT avant de la confirmer.
• Uniquement des réponses et des relances, jamais d'envoi en masse. WhatsApp restreint les numéros qui envoient des messages non sollicités en volume. Utilisez ceci avec des personnes qui vous parlent déjà — voir notre guide des bonnes pratiques WhatsApp pour les équipes HubSpot.
• Tout est attribué. Les modifications effectuées via le connecteur HubSpot sont enregistrées à la fois au nom de l'utilisateur et du connecteur.
• Données sensibles HubSpot : si elles sont activées, HubSpot bloque les données d'activité et de conversation de son connecteur.

FAQ

Qu'est-ce que HubSpot WhatsApp MCP ?

C'est une configuration où un assistant IA comme Claude ou ChatGPT se connecte à HubSpot via le connecteur officiel de HubSpot et au WhatsApp de votre équipe via le serveur MCP de TimelinesAI, en même temps. Vous pouvez alors poser une seule question qui a besoin des deux — par exemple, quelles transactions attendent une réponse WhatsApp — sans code.

Avec quels assistants IA cela fonctionne-t-il ?

Claude et ChatGPT pour la routine complète, plus Claude Code, Cursor et Codex pour les équipes techniques. Les connexions Copilot et Gemini de HubSpot ne couvrent que les questions CRM.

L'IA propre de HubSpot peut-elle lire nos messages WhatsApp ?

Pas ceux synchronisés par TimelinesAI. Dans notre test, le connecteur HubSpot montrait quand un client avait été contacté pour la dernière fois et combien de fois, mais pas les messages. Si vous utilisez le canal de boîte de réception WhatsApp propre à HubSpot, son connecteur peut lire ces fils — mais ne peut pas y répondre.

Ai-je besoin de l'intégration WhatsApp propre à HubSpot ?

Non. Le canal WhatsApp de HubSpot nécessite Marketing Hub ou Service Hub Professional ou Enterprise et n'accepte pas les comptes personnels. TimelinesAI fonctionne sur tous les niveaux HubSpot, avec les numéros de l'app et de l'API WhatsApp Business.

Est-ce la même chose que les résumés IA à l'intérieur de HubSpot ?

Non. Les résumés sur la fiche sont l'IA propre de HubSpot. Ceci s'adresse aux équipes qui travaillent déjà dans Claude ou ChatGPT et qui veulent poser une seule question couvrant HubSpot et le WhatsApp de chaque commercial.

Dois-je donner à l'IA un accès en écriture à HubSpot ?

Non. Toutes les questions de ce guide fonctionnent avec la connexion en lecture seule par défaut de HubSpot.

L'assistant peut-il mettre à jour des transactions, notes et tâches HubSpot ?

Oui, dans Claude et ChatGPT, si un super administrateur autorise les permissions d'écriture. Le connecteur ChatGPT met à jour jusqu'à 10 enregistrements à la fois. HubSpot recommande de configurer le connecteur pour qu'il demande une confirmation avant chaque mise à jour.

Quelle est la différence entre le serveur MCP de HubSpot et le connecteur HubSpot pour Claude ?

Le connecteur est l'application prête à l'emploi que vous ajoutez dans Claude ou ChatGPT — c'est celle à utiliser pour ce guide. Le serveur MCP distant de HubSpot est ce à quoi les développeurs connectent leurs propres outils IA.

Fonctionne-t-il avec les numéros de l'app WhatsApp Business, ou uniquement avec l'API ?

Les deux, sur toute votre équipe.

Fonctionne-t-il avec HubSpot Free ou Starter ?

Oui. Le connecteur HubSpot comme TimelinesAI fonctionnent sur tous les niveaux HubSpot.

Peut-il lire les chats de groupe ?

Oui, y compris qui a envoyé chaque message.

Est-ce que cela coûte plus cher ?

Pas du côté de TimelinesAI : le MCP WhatsApp est inclus dans votre forfait TimelinesAI. HubSpot ne facture pas non plus ses connecteurs séparément — ils sont disponibles à tous les niveaux HubSpot, y compris Free. Ce qu'il vous faut, c'est un forfait IA payant, et une équipe qui fait cela chaque matin sur une grosse boîte de réception devrait prévoir un niveau supérieur.

Puis-je utiliser ChatGPT à la place de Claude ?

Oui. Le connecteur officiel HubSpot pour ChatGPT lit votre CRM et, si autorisé, le met à jour. TimelinesAI se connecte via le mode développeur de ChatGPT sur les forfaits Plus, Pro, Business, Enterprise et Education.

Fonctionne-t-il avec Microsoft Copilot ou Gemini ?

Pour les questions CRM, oui : HubSpot propose un agent pour Microsoft 365 Copilot et un connecteur en lecture seule pour Gemini. Nous n'avons vérifié aucun moyen d'y ajouter TimelinesAI, donc pour les questions qui nécessitent WhatsApp, utilisez Claude ou ChatGPT.

Guides associés

• Comment fonctionne la synchronisation de WhatsApp vers HubSpot
• Guide de configuration du WhatsApp MCP
• Boîte de réception WhatsApp partagée pour les équipes HubSpot
• Bonnes pratiques WhatsApp et HubSpot
• Cas d'usage du WhatsApp MCP
• Analyse WhatsApp avec Claude Code

Prêt à l'essayer sur votre propre pipeline ? Commencez gratuitement avec TimelinesAI, connectez le WhatsApp de votre équipe à HubSpot, puis posez votre première question.