La meilleure façon de connecter WhatsApp à HubSpot avec l'historique de conversation dans la fiche Contact

Connectez WhatsApp à HubSpot avec un scan de QR code et une autorisation OAuth — sans Business API. Les messages se synchronisent avec la chronologie du Contact dans HubSpot en quelques secondes, affichés comme activité WhatsApp regroupée par jour et par conversation. Les appels sont journalisés à part comme Call Engagements. La configuration prend environ deux minutes.

Pour une équipe commerciale, la fiche Contact est l'endroit où une affaire vit réellement — pas la boîte de réception, pas le téléphone d'un commercial. Si la conversation WhatsApp qui a conclu, bloqué ou fait perdre une affaire n'est pas sur ce Contact, la fiche est incomplète, quelle que soit la qualité du reste de la configuration HubSpot.

Un déclencheur courant pour vérifier cela : un commercial conclut une affaire presque entièrement par WhatsApp, puis un responsable ouvre l'Affaire dans HubSpot en espérant voir comment cela s'est passé — et trouve une fiche Contact sans aucune conversation, parce que rien n'a jamais été connecté.

Ce guide couvre ce que la plupart des guides de configuration omettent : exactement comment l'historique de conversation apparaît une fois connecté — sur quel objet il atterrit, comment il est regroupé, et quoi vérifier s'il n'est pas là. Si WhatsApp n'est pas encore connecté à HubSpot, la configuration complète est ici ; si vous cherchez à comprendre pourquoi les messages n'arrivent pas du tout dans HubSpot, commencez plutôt ici.

Ce que « historique de conversation dans la fiche Contact » signifie vraiment

Une conversation WhatsApp se résout à trois endroits dans HubSpot : la Chronologie du Contact, une association avec l'Affaire concernée et — spécifiquement pour les appels — un Call Engagement distinct.

• Chronologie du Contact — chaque message WhatsApp, entrant et sortant, y est journalisé comme activité WhatsApp.
• Association à l'Affaire — la même conversation s'attache aussi à l'Affaire concernée, si bien qu'un commercial consultant une Affaire voit l'historique WhatsApp sans passer par le Contact.
• Call Engagements — les appels vocaux et vidéo WhatsApp sont journalisés comme leur propre type d'objet, le Call Engagement natif de HubSpot, pas comme activité de message dans la Chronologie.

Les messages se synchronisent avec la Chronologie en quelques secondes après leur envoi ou réception. Ce que vous y voyez, cependant, est regroupé : la chronologie HubSpot rassemble l'activité du même jour d'une conversation en une seule entrée, dépliable pour voir l'échange complet — le même schéma visuel que HubSpot utilise pour d'autres types d'activité fréquemment mis à jour, rien de propre à WhatsApp. Un message d'il y a dix minutes et un autre de ce matin peuvent apparaître dans la même carte repliée, ce qui relève d'un choix d'affichage, pas d'un retard de synchronisation.

Pourquoi c'est important : cette distinction résout la confusion la plus fréquente avec cette intégration. Les données sont déjà arrivées — elles ne sont simplement pas affichées comme une ligne distincte par message dans la carte de la Chronologie. Dépliez l'entrée du jour pour tout voir.

Les signaux d'installations et d'avis confirment cela au-delà d'une simple affirmation : la fiche de l'intégration sur le Marketplace HubSpot affiche 4,4 étoiles sur 53 avis et environ 3 000 installations — une base nettement plus large que la même intégration sur Pipedrive ou Bitrix24, et qui mérite d'être vérifiée directement sur la plateforme HubSpot plutôt que d'être prise pour argent comptant.

Pourquoi le type de compte compte plus que ne le disent la plupart des guides de configuration

La plupart des outils WhatsApp-vers-HubSpot, y compris les deux auxquels celui-ci est le plus souvent comparé, reposent sur la WhatsApp Business API — ce qui signifie qu'un numéro dédié, approuvé par Meta, est un prérequis avant que la synchronisation des Contacts puisse même commencer.

• L'intégration HubSpot de wati exige un accès à la WhatsApp Business API, disponible uniquement sur les forfaits payants de wati, en plus d'un forfait HubSpot Professional ou supérieur. Elle est véritablement performante — synchronisation bidirectionnelle native, résumés de conversation par IA, création automatique de tâches à partir des promesses faites en discussion — mais rien de tout cela ne démarre tant qu'un numéro Business API n'est pas en place.
• L'intégration HubSpot de respond.io repose elle aussi sur la Business API, mais propose WhatsApp Coexistence comme voie plus douce — un numéro existant peut rejoindre en mode coexistence plutôt que d'être entièrement désinscrit. C'est une différence réelle par rapport à une exigence stricte d'API uniquement, mais cela implique quand même une vérification Meta Business, pas une simple connexion par QR code.

Pourquoi c'est important : si l'objectif est vraiment de voir les conversations WhatsApp *existantes* de votre équipe — celles que les commerciaux mènent depuis leurs propres numéros depuis des mois —, une exigence de Business API est un mur, pas une étape de configuration. Se connecter par QR code, comme décrit ci-dessous, est ce qui rend ces conversations existantes accessibles en premier lieu.

Avant de commencer

• Droits d'administrateur HubSpot — pour autoriser l'application via OAuth.
• N'importe quel compte WhatsApp — WhatsApp classique, l'application Business ou la Business API. Aucune approbation Business API n'est requise pour se connecter.
• Environ deux minutes — un scan de QR code plus une autorisation OAuth.

Étape 1 : Connectez votre compte WhatsApp

Scannez un QR code depuis l'espace de travail TimelinesAI, de la même façon que vous lieriez WhatsApp Web. Étapes complètes de configuration ici si vous voulez le parcours intégral — ce guide reprend à partir d'une connexion déjà effectuée.

Pourquoi c'est important : cette étape détermine quelles conversations existent pour être synchronisées. Connecter votre propre numéro met ses conversations existantes à portée ; un numéro partagé ou sans titulaire nécessite sa propre connexion, traitée séparément dans notre guide sur les boîtes partagées pour les équipes HubSpot.

Étape 2 : Autorisez HubSpot via OAuth

Autorisez l'application du Marketplace HubSpot avec un compte administrateur. C'est un flux OAuth standard — pas de clés API à générer, pas de configuration développeur.

Pourquoi c'est important : la portée OAuth détermine ce sur quoi l'intégration peut écrire. Une autorisation administrateur est ce qui permet aux objets Contact, Affaire et Call Engagement d'être tous accessibles — un utilisateur autorisant avec des restrictions peut réduire silencieusement ce qui se synchronise réellement.

Étape 3 : Vérifiez que la correspondance des contacts se résout correctement

Chaque message est associé à un Contact par numéro de téléphone, et un nouveau Contact est créé automatiquement en l'absence de correspondance — la même logique de correspondance documentée pour Pipedrive, fonctionnant ici sur le même mécanisme sous-jacent.

Pourquoi c'est important : correspondance et affichage sont deux mécanismes distincts. Un message peut être correctement associé au bon Contact dès son arrivée, tout en apparaissant encore dans une carte quotidienne regroupée de la Chronologie — essayer de résoudre un problème de « message manquant » en remettant en cause la correspondance, alors que le vrai problème est simplement le regroupement d'affichage de l'Étape 1, est une impasse fréquente.

Étape 4 : Décidez de ce qui se passe sur les Affaires, pas seulement les Contacts

Vérifiez que la conversation s'associe véritablement à la bonne Affaire, pas seulement au Contact — cela mérite un regard délibéré plutôt qu'une supposition, surtout pour un Contact ayant plus d'une Affaire ouverte.

Pourquoi c'est important : une fiche Contact avec plusieurs Affaires peut laisser planer une ambiguïté sur celle à laquelle appartient un fil WhatsApp. Le confirmer maintenant évite qu'un commercial consulte la mauvaise Affaire et rate justement le contexte qui l'explique. C'est particulièrement important pour la vente par comptes, où un Contact peut avoir en même temps un renouvellement, une montée en gamme et une conversation sur un nouveau produit — trois fils WhatsApp distincts qui doivent atterrir sur trois Affaires distinctes, pas se fondre en une seule.

Étape 5 : Activez les actions Workflow si vous voulez de l'automatisation

Les Workflows HubSpot peuvent envoyer un message WhatsApp comme action native au sein de n'importe quelle automatisation — un nouveau stade d'Affaire, la soumission d'un formulaire, une relance planifiée. C'est une fonctionnalité distincte de l'historique de conversation, à activer seulement si vous avez une automatisation concrète en tête, traitée en détail ailleurs.

Pourquoi c'est important : les actions Workflow et la synchronisation de la Chronologie sont des systèmes indépendants. Activer l'un n'affecte pas l'autre, et les traiter comme s'ils étaient identiques lors du dépannage fait perdre du temps.

Étape 6 : Vérifiez que l'historique arrive réellement sur la fiche Contact

Envoyez un message test et vérifiez exactement où il apparaît — c'est le seul moyen de savoir que la configuration fonctionne réellement de bout en bout, plutôt que de le supposer à partir d'un statut de connexion vert.

1. Envoyez un message WhatsApp depuis un numéro ayant une correspondance existante dans HubSpot.
2. Ouvrez cette fiche Contact dans HubSpot.
3. Vérifiez que le message apparaît dans la Chronologie, en dépliant l'entrée du jour si elle est repliée.
4. Ouvrez l'Affaire associée et vérifiez que la même conversation y est aussi visible.
5. S'il s'agissait d'un appel, vérifiez qu'il apparaît séparément comme Call Engagement, pas dans l'activité de message de la Chronologie.

Cette vidéo montre la synchronisation de bout en bout, y compris comment les messages, pièces jointes et réactions arrivent sur le Contact et l'Affaire.

Problèmes courants et dépannage

Un message semble absent. C'est presque toujours qu'il se trouve dans une carte quotidienne repliée de la Chronologie, pas manquant. Dépliez l'entrée de ce jour avant de supposer que la synchronisation a échoué.

Les messages atterrissent sur le mauvais Contact, ou en dupliquent un. C'est le mécanisme de correspondance, pas un problème d'affichage — la même cause profonde documentée pour Pipedrive : des fiches Contact déjà en double dans HubSpot brouillent la correspondance par numéro de téléphone. Dédupliquez d'abord dans HubSpot.

Un appel n'apparaît pas où vous l'attendiez. Les appels sont journalisés comme Call Engagements, un objet différent de l'activité de message de la Chronologie utilisée pour les textes. Vérifiez la section Appels de la fiche Contact, pas la Chronologie des messages.

Les actions Workflow ne se déclenchent pas. C'est un sous-système distinct de la synchronisation de conversation. Vérifiez que le Workflow lui-même est activé et que les conditions de déclenchement sont réellement remplies avant de supposer un problème de connexion.

Rien ne se synchronise du tout avec HubSpot. Vérifiez d'abord la connexion WhatsApp, pas le côté HubSpot — une connexion WhatsApp coupée ressemble en tout point à un échec de synchronisation HubSpot vu depuis le CRM.

Questions fréquentes

Ai-je besoin de la WhatsApp Business API pour me connecter à HubSpot ?

Non. WhatsApp classique, l'application WhatsApp Business et la Business API fonctionnent tous. Aucune approbation Business API n'est requise pour démarrer.

Mon numéro WhatsApp actuel fonctionnera-t-il, ou m'en faut-il un nouveau ?

Votre numéro actuel fonctionne tel quel, connecté par QR code — rien n'a besoin d'être désinscrit ni migré au préalable.

Les messages apparaissent-ils sur les Affaires, ou seulement sur les Contacts ?

Les deux. La même conversation est journalisée dans la Chronologie du Contact et associée à l'Affaire concernée, si bien que quiconque consulte l'une ou l'autre fiche voit l'historique.

À quelle vitesse WhatsApp se synchronise-t-il réellement avec HubSpot ?

Les messages se synchronisent en quelques secondes après leur envoi ou réception. Ce qui apparaît dans la Chronologie est regroupé par jour et par conversation pour l'affichage — un schéma d'interface HubSpot, pas un retard dans la synchronisation réelle.

Les appels WhatsApp apparaissent-ils de la même façon que les messages ?

Non — les appels sont journalisés comme Call Engagements HubSpot, un objet distinct de l'activité de message de la Chronologie utilisée pour les conversations textuelles.

Existe-t-il un moyen de vérifier si cette intégration est vraiment fiable ?

La fiche du Marketplace HubSpot affiche le nombre d'installations et la note directement depuis la plateforme HubSpot elle-même — une source vivante qui se met à jour d'elle-même, contrairement à tout résumé tiers, y compris celui-ci.

Plusieurs membres de l'équipe peuvent-ils voir le même historique de conversation WhatsApp ?

Oui, une fois sur la fiche Contact, quiconque a accès à ce Contact dans HubSpot voit l'historique synchronisé complet — de la même façon qu'il verrait toute autre activité de la Chronologie. Gérer qui peut répondre depuis quel numéro relève d'une question distincte de boîte partagée, pas de visibilité de l'historique.

Une agence peut-elle utiliser ceci sur plusieurs portails HubSpot ?

Chaque portail HubSpot est autorisé séparément via sa propre connexion OAuth, si bien qu'une agence gérant plusieurs portails clients connecte chacun individuellement plutôt que de partager une seule autorisation entre comptes.

Commencer

Connectez WhatsApp à HubSpot et donnez à vos fiches Contact l'historique de conversation qui leur manque. Démarrez un essai gratuit — sans carte bancaire.