Consigner les messages WhatsApp dans HubSpot depuis un numéro Coexistence

Comment un message WhatsApp arrive-t-il sur un contact HubSpot ?

En trois étapes. Meta livre le message à la destination de webhook que vous avez définie pour le numéro, ici un nœud Webhook n8n. Le workflow cherche dans HubSpot un contact portant le numéro de téléphone de l'expéditeur et en crée un si rien ne correspond. Il crée ensuite un enregistrement de communication contenant le texte du message et l'associe à ce contact.

HubSpot a conçu l'objet Communications pour ce cas. Il représente un message WhatsApp, LinkedIn ou SMS envoyé ou reçu en dehors de HubSpot, et il s'affiche dans la chronologie de la fiche comme un appel ou un e-mail consigné. Les propriétés obligatoires sont le type de canal, hs_communication_logged_from défini sur CRM, le corps, un propriétaire et un horodatage.

Rien de tout cela ne nécessite une application de la marketplace HubSpot. Le nœud HTTP Request de n8n peut réutiliser l'identifiant HubSpot que vous avez déjà configuré pour le nœud HubSpot, et l'appel se résume à un seul POST par message.

{
  "properties": {
    "hs_communication_channel_type": "WHATS_APP",
    "hs_communication_logged_from": "CRM",
    "hs_communication_body": "do you have anything friday?",
    "hubspot_owner_id": "75480934",
    "hs_timestamp": "2026-10-11T14:20:00.000Z"
  }
}

Les messages saisis sur le téléphone sont-ils aussi consignés ?

Oui, et c'est ce qu'apporte un numéro Coexistence. Quand quelqu'un de l'équipe répond depuis l'application WhatsApp Business, Meta envoie un écho de ce message sortant à la même destination de webhook. Un workflow qui traite à la fois les messages entrants et les échos écrit les deux côtés de la conversation dans la chronologie : un commercial qui ouvre le contact dans HubSpot voit ce que le client a demandé et ce que la boutique a répondu.

Faites un branchement sur le champ du webhook. Les messages entrants arrivent sous messages et les réponses du téléphone sous smb_message_echoes. Consignez les premiers comme reçus et les seconds comme envoyés, et la chronologie se lit dans l'ordre.

Les réponses que le workflow envoie lui-même via la Cloud API lui sont déjà connues : consignez-les au moment de l'envoi plutôt que d'attendre un webhook.

Qu'en est-il du canal de boîte de réception WhatsApp natif de HubSpot ?

C'est une intégration différente. La boîte de réception de conversations de HubSpot connecte un numéro WhatsApp à HubSpot lui-même, et sa base de connaissances précise que le numéro ne doit pas être connecté à une autre intégration WhatsApp. Elle est disponible avec Marketing Hub ou Service Hub Professional et Enterprise.

Un numéro connecté via EasyCoexistence fonctionne dans l'autre sens : Meta achemine ses webhooks vers une URL qui vous appartient, et HubSpot reçoit les enregistrements par son API. La conversation se déroule depuis le téléphone ou par votre workflow, et HubSpot devient le système de référence qui conserve l'historique sur le contact, l'affaire ou le ticket.

L'appel exige un scope d'écriture sur les contacts pour l'application privée ou l'identifiant qui l'effectue, soit le même scope dont un workflow a déjà besoin pour créer le contact au départ.

Comment le workflow doit-il associer un expéditeur à un contact ?

Par numéro de téléphone, normalisé avant la recherche. Meta envoie l'expéditeur sous forme de chiffres avec l'indicatif du pays et sans signe plus, par exemple 14155550188. Les contacts HubSpot sont saisis à la main : la même personne peut donc être enregistrée sous +1 415 555 0188 ou (415) 555-0188.

Le schéma fiable consiste à garder une propriété de contact dédiée contenant le numéro en chiffres uniquement, à la renseigner quand le workflow crée un contact et à rechercher sur cette propriété. Chercher directement dans le champ téléphone en texte libre fonctionne pour les contacts créés par le workflow et en manque beaucoup de ceux créés par une personne, ce qui produit des doublons.

Quand une recherche ne renvoie rien, créez le contact avec le nom de profil du payload du webhook comme prénom et le numéro en chiffres uniquement dans les deux champs. Quelqu'un pourra fusionner ou renommer plus tard, et la conversation est déjà rattachée.

Erreurs courantes

• Ne consigner que les messages entrants. La chronologie montre alors des questions sans réponses, car les réponses saisies sur le téléphone arrivent sous forme d'événements smb_message_echoes.
• Laisser hs_communication_logged_from non renseigné. HubSpot exige la valeur CRM pour créer une communication via l'API.
• Rechercher les contacts sur le champ téléphone brut. Le format en chiffres uniquement de Meta correspond rarement à ce qu'une personne a saisi, et chaque échec crée un contact en double.

Questions fréquemment posées

Poursuivre la lecture