Il existe deux façons de faire fonctionner WhatsApp avec HubSpot Service Hub. HubSpot propose son propre canal WhatsApp dans sa boîte de réception via la WhatsApp Business API, ce qui implique un numéro enregistré sur l'API, des modèles validés pour les messages hors de la fenêtre de 24 heures, et des frais par message. L'autre façon garde WhatsApp sur le numéro que vos clients utilisent déjà, avec Spun comme espace de travail WhatsApp, et crée les tickets HubSpot par un workflow dans votre propre n8n.
Cette page couvre la seconde voie, pour des tickets HubSpot issus de WhatsApp : chaque conversation individuelle devient un ticket dans le pipeline que vous choisissez, chaque message est consigné sur le ticket et dans la chronologie du contact, et les agents répondent sur WhatsApp depuis le ticket. Elle fonctionne aux côtés de la synchronisation des contacts HubSpot CRM de Spun, qui garde les contacts alignés et ne crée pas de tickets.
Des tickets HubSpot depuis WhatsApp : ce que fait le workflow
- Chaque conversation WhatsApp individuelle devient un ticket HubSpot dans le pipeline et l'étape choisis par votre administrateur. Les conversations de groupe sont ignorées.
- Chaque message est consigné sur le ticket comme communication WhatsApp et apparaît aussi dans la chronologie du contact, avec le nom de l'auteur dans le texte.
- Les réponses que votre équipe envoie depuis la boîte de réception Spun sont consignées sur le ticket elles aussi, de sorte que les deux côtés peuvent répondre.
- Archiver dans Spun fait passer le ticket à l'étape fermée, et désarchiver le ramène à l'étape ouverte. Fermer dans HubSpot peut aussi archiver la conversation dans Spun, une option désactivée tant que vous ne l'activez pas.
[WhatsApp] Maria Lopez (+15550142233): Hi, my order has not arrived yet
[Sent from Spun] Alex: Sorry about that, checking now.
[Sent from HubSpot] It ships today, here is the tracking link.Répondre depuis le ticket avec le champ Spun reply
Les agents répondent en saisissant leur texte dans une propriété Spun reply du ticket, puis en enregistrant. En quelques secondes, le texte arrive chez le client sur WhatsApp, il est consigné sur le ticket, et le champ est de nouveau vide. Si une réponse n'a pas pu être envoyée, une note sur le ticket en indique la raison.
Les réponses sont uniquement textuelles ; les pièces jointes du ticket ne sont pas transmises. Les notes et e-mails HubSpot restent internes. Tout ce qui est écrit dans Spun reply est envoyé, quel qu'en soit l'auteur, gardez donc cette propriété hors des modifications en masse, des imports et des workflows HubSpot.
Aux côtés de la synchronisation des contacts HubSpot CRM
La synchronisation des contacts HubSpot CRM de Spun gère les contacts ; ce workflow gère les tickets. Le workflow utilise sa propre clé HubSpot et ne modifie jamais un contact. Lorsque la synchronisation des contacts est connectée, il ne crée jamais de contact non plus : le ticket d'un tout nouveau client est lié une fois que la synchronisation a transmis le contact, ce qui se produit avec « Synchroniser maintenant » ou une étiquette associée, et non à chaque message.
À lire aussi : WhatsApp + HubSpot CRM : la synchronisation des contacts
La configuration, pas à pas
Il vous faut HubSpot Service Hub, un utilisateur capable de créer des propriétés, des clés et des abonnements webhook, une instance n8n que HubSpot et Spun peuvent joindre en HTTPS, et une application pour transporter le webhook de réponse : une application privée héritée (créez-la avant le 26 octobre 2026, date à laquelle HubSpot cesse d'en accepter de nouvelles pour les comptes existants) ou une application basée sur un projet, construite avec la CLI HubSpot et qui nécessite un développeur.
- 1
Créez deux propriétés de ticket
Spun chat id (texte sur une ligne) et Spun reply (texte sur plusieurs lignes). Ajoutez Spun reply à la barre latérale du ticket pour que les agents la voient.
- 2
Créez une clé pour les appels API
Une clé de service ou le jeton d'accès de votre application privée héritée, avec les portées tickets et contacts indiquées dans le guide de configuration, conservée dans n8n comme identifiant Header Auth.
- 3
Importez le workflow
Lancez une fois son assistant de configuration pour lister vos pipelines et étapes de tickets, et copiez les identifiants dans le nœud Settings.
- 4
Indiquez-lui la synchronisation des contacts
Laissez le réglage de synchronisation des contacts activé si la synchronisation des contacts HubSpot de Spun est connectée, ou en cas de doute.
- 5
Abonnez l'application aux modifications de tickets
Pointez le webhook de l'application vers l'URL de réponse du workflow avec un abonnement sur la propriété Spun reply, et collez le secret client de l'application dans le workflow.
- 6
Créez une clé API Spun
« Paramètres », puis « Webhooks », puis « Gérer les clés API », avec la portée d'envoi de messages. Cochez aussi « Fermer & Rouvrir les Conversations » si la fermeture dans HubSpot doit archiver la conversation dans Spun.
- 7
Abonnez Spun au workflow
Ajoutez un webhook pour les messages entrants, les messages sortants, la conversation fermée et la conversation rouverte, avec le modèle de contenu réglé sur raw, et collez son secret de signature dans le workflow.
- 8
Envoyez un message de test
Écrivez à la ligne depuis un autre téléphone. Un ticket apparaît dans HubSpot ; saisissez une réponse dans Spun reply, enregistrez, et la réponse arrive sur le téléphone.
À lire aussi : Documentation : HubSpot Service Hub via n8n, le guide de configuration complet · WhatsApp + n8n : l'API et les webhooks sous-jacents
Ce que vous devez savoir avant de construire
- Les webhooks HubSpot sont signés et le workflow vérifie la signature. Les propres événements de Spun sont signés en HMAC.
- Les médias arrivent sur le ticket sous forme de lien valable 24 heures, pas comme fichier HubSpot.
- Les limites de l'API HubSpot s'appliquent par clé (100 ou 190 requêtes toutes les 10 secondes, plus une limite quotidienne par compte). Une nouvelle conversation coûte quatre ou cinq appels et un message suivant deux.
- Chaque événement livré consomme des jetons IA de votre formule Spun. La façon dont cela est décompté pour un usage helpdesk est encore à l'étude.
À lire aussi : Toutes les intégrations WhatsApp avec un helpdesk · WhatsApp comme helpdesk à part entière