Intégrations
GoHighLevel et WhatsApp
Connectez GoHighLevel (HighLevel) à WbizTool et vos workflows envoient des messages WhatsApp depuis votre propre numéro WhatsApp. Les messages WhatsApp entrants peuvent aussi revenir dans HighLevel, sous forme de note, de tag ou de tâche sur le contact.
Tout ce qui est décrit sur cette page utilise des fonctions qui existent déjà des deux côtés : les webhooks des workflows HighLevel, ainsi que l'API d'envoi de messages et les webhooks de messages entrants de WbizTool. Vous n'installez rien.
Qui peut le faire : dans WbizTool, un Propriétaire crée la clé API (Clés API), et un Propriétaire ou un Éditeur configure les webhooks de messages entrants. Dans HighLevel, une personne autorisée à modifier les workflows du sous-compte les construit. L'agence doit activer les fonctions premium des workflows HighLevel (voir Avant de commencer).
Ce que vous pouvez faire#
| Sens | Exemple | Comment |
|---|---|---|
| HighLevel → WhatsApp | Un formulaire est envoyé, un tag est ajouté ou un rendez-vous est réservé, et le contact reçoit un message WhatsApp. | Une action Custom Webhook dans un workflow HighLevel appelle l'API d'envoi de messages de WbizTool. |
| WhatsApp → HighLevel | Un client écrit à votre numéro WhatsApp, et le message est ajouté comme note sur son contact HighLevel. Le contact est créé s'il n'existe pas encore. | Un numéro de la boîte WbizTool envoie chaque message à un déclencheur Inbound Webhook de HighLevel. Il faut le module Unibox. |
Avant de commencer#
- Un numéro WhatsApp connecté dans Numéros WhatsApp, et son WhatsApp Client ID (l'ID affiché pour le numéro), par exemple
678. - Une clé API WbizTool depuis Paramètres → Clés API. Dans HighLevel, elle va dans un en-tête
Authorization: Bearer, vous n'avez donc pas besoin du Client ID. Consultez Envoyer la clé dans un en-tête. - Les fonctions premium des workflows HighLevel. HighLevel classe Custom Webhook et Inbound Webhook parmi les fonctions premium des workflows. Les agences peuvent les activer sur tous les forfaits HighLevel : dans l'Agency View, allez dans Settings → Company et activez Workflow - Premium Features. HighLevel facture chaque exécution premium, et chaque sous-compte reçoit 100 exécutions premium gratuites (une seule fois, pas chaque mois). L'agence peut refacturer ce coût au sous-compte. Les prix de HighLevel figurent sur sa propre page d'aide.
- Pour les messages entrants uniquement : le module Unibox sur un forfait WbizTool payant ou à vie (pas l'essai gratuit). Il coûte 20 $ par mois ou 200 $ par an au prix catalogue américain pour chaque numéro WhatsApp de la boîte de réception. Un Propriétaire l'ajoute dans Facturation et forfaits (voir Modules complémentaires).
Choisir une méthode#
La méthode des workflows HighLevel est la plus courte : HighLevel appelle WbizTool directement, sans autre outil entre les deux. N'utilisez un outil d'automatisation que si vos workflows y tournent déjà.
| Méthode | Envoyer (HighLevel → WhatsApp) | Recevoir (WhatsApp → HighLevel) | Forfaits nécessaires |
|---|---|---|---|
| Workflows HighLevel (recommandé) | Action Custom Webhook → API d'envoi de messages | Webhook WbizTool → déclencheur Inbound Webhook | Fonctions premium des workflows HighLevel. Réception : le module Unibox. |
| Zapier | LeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact ou Add Task | Un compte Zapier. Réception : le module Unibox. |
| Make | Action Webhook de HighLevel → Webhooks de Make → module HTTP | Webhook WbizTool → Webhooks de Make → API HighLevel | Un compte Make. Réception : le module Unibox. |
| n8n | Action Webhook de HighLevel → Webhook de n8n → WbizTool Send Message | Webhook WbizTool → Webhook de n8n → node HighLevel | n8n avec le community node WbizTool. Réception : le module Unibox. |
| Pabbly Connect | Action Webhook de HighLevel → déclencheur webhook de Pabbly → requête API (Pabbly) | Webhook WbizTool → déclencheur webhook de Pabbly → votre étape HighLevel | Un compte Pabbly Connect. Réception : le module Unibox. |
Envoyer des messages WhatsApp depuis un workflow HighLevel#
Ouvrez ou créez un workflow
Dans votre sous-compte HighLevel, ouvrez Automation et créez un workflow, ou modifiez-en un. Donnez-lui le déclencheur souhaité, comme l'envoi d'un formulaire, un nouveau tag ou un rendez-vous réservé.
Ajoutez l'action Custom Webhook
Cliquez sur + à l'endroit où le message doit partir, puis sur Send Data → Custom Webhook (ou recherchez « webhook » dans les actions et choisissez Custom Webhook). L'action Webhook simple ne permet pas de définir l'en-tête et le corps dont cette API a besoin.
Configurez la requête
Réglez Event sur CUSTOM et Method sur POST. Réglez URL sur
https://wbiztool.com/api/v1/send_msg/. Pour Authorization, choisissez Bearer Token et collez votre clé API WbizTool, ou choisissez aucune authentification et ajoutez l'en-têteAuthorizationavec la valeurBearer YOUR_API_KEY. Réglez Content-Type surapplication/json.Collez le corps
Collez l'un des blocs à copier-coller dans Raw Body et remplacez
678par votre WhatsApp Client ID. Utilisez l'icône de tag de HighLevel pour ajouter d'autres champs du contact au message.Testez et publiez
Enregistrez l'action et publiez le workflow. Exécutez-le sur un contact de test avec votre propre numéro de téléphone. Chaque exécution apparaît dans les journaux d'exécution du workflow. Quand WbizTool accepte le message, il répond
"status": 1. Le message part ensuite depuis votre numéro WhatsApp.
Le champ du numéro de téléphone#
Utilisez {{contact.phone_raw}}, pas {{contact.phone}}. Le {{contact.phone}} de HighLevel est formaté pour la lecture, comme (515) 555-2345, sans l'indicatif du pays. {{contact.phone_raw}} est le même numéro au format international, comme +15155552345.
WbizTool supprime pour vous le +, les espaces, les tirets et les parenthèses. Un numéro écrit avec + contient déjà son indicatif du pays, vous n'avez donc pas besoin d'envoyer country_code. Si certains de vos contacts ont été enregistrés sans indicatif, ajoutez "country_code": "1" (l'indicatif téléphonique de votre pays) au corps. Il n'est ajouté qu'aux numéros écrits sans +. Consultez Envoyer un message → phone.
Blocs à copier-coller#
URL : https://wbiztool.com/api/v1/send_msg/ · Méthode : POST · En-têtes : Authorization: Bearer YOUR_API_KEY et Content-Type: application/json
{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, thanks for contacting {{location.name}}. We'll reply here on WhatsApp."
}{
"whatsapp_client": 678,
"msg_type": 1,
"phone": "{{contact.phone_raw}}",
"img_url": "https://example.com/images/welcome-offer.jpg",
"msg": "Hi {{contact.first_name}}, here is your welcome offer from {{location.name}}."
}{
"whatsapp_client": 678,
"msg_type": 2,
"phone": "{{contact.phone_raw}}",
"file_url": "https://example.com/files/price-list.pdf",
"file_name": "price-list.pdf",
"msg": "Hi {{contact.first_name}}, here is our price list."
}{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, a reminder of your appointment with {{location.name}} at {{appointment.start_time}}.",
"expire_after_seconds": 3600
}{
"whatsapp_client": 678,
"group_name": "Sales team",
"msg": "New lead: {{contact.name}}, {{contact.phone_raw}}, {{contact.email}}"
}whatsapp_client: l'ID du numéro qui envoie. Vous ne pouvez l'omettre que si votre espace de travail a exactement un numéro connecté.msg: jusqu'à 3 000 caractères. La mise en forme WhatsApp fonctionne :*bold*,_italic_. Pour un retour à la ligne, tapez\ndans le texte. Un vrai saut de ligne rend le JSON invalide.- Images et fichiers : les liens doivent être publics.
msgdevient la légende. Consultez Envoyer des images et des fichiers. expire_after_seconds: si le message n'est pas parti dans ce délai, par exemple parce que le numéro était déconnecté, il est marqué comme expiré et n'est pas envoyé.- Groupes :
group_nameest le nom exact d'un groupe WhatsApp dont votre numéro fait partie. Envoyezgroup_nameouphone, jamais les deux. Consultez Envoyer à un groupe.
Enregistrer les messages WhatsApp entrants dans HighLevel#
Ce sens nécessite le module Unibox. Chaque message reçu par votre numéro WhatsApp est envoyé au déclencheur Inbound Webhook de HighLevel. Le workflow trouve ou crée alors le contact et ajoute le message sous forme de note, de tag ou de tâche. Les messages n'apparaissent nulle part ailleurs dans HighLevel.
Créez un workflow avec un déclencheur Inbound Webhook
Dans HighLevel, créez un workflow et choisissez le déclencheur Inbound Webhook. Copiez l'URL de webhook qu'il affiche.
Dirigez votre numéro WhatsApp vers cette URL
Dans WbizTool, ouvrez Numéros de la boîte. Cliquez sur Ajouter un numéro à la boîte, choisissez le numéro et collez l'URL HighLevel sous URL du webhook (facultatif). Pour un numéro déjà dans la boîte de réception, collez-la dans les Paramètres du webhook du numéro. Sous Messages à envoyer, cochez uniquement Messages reçus. Chaque envoi compte comme une exécution premium dans HighLevel, laissez donc Messages envoyés décoché, sauf si vous en avez besoin.
Envoyez un message de test
Depuis un autre téléphone, envoyez un message à votre numéro WhatsApp. Il est transmis après la vérification suivante, généralement en une minute ou deux. Dans HighLevel, cliquez sur Test Trigger, choisissez la requête sous Mapping Reference et enregistrez le déclencheur. Les champs sont listés dans Contenu (payload).
Ignorez les groupes et les numéros masqués
Ajoutez une étape If/Else qui ne continue que si
eventvautmessage_received,contact.is_groupvautfalseetcontact.phonen'est pas vide. WhatsApp masque parfois le numéro d'un expéditeur, et les messages de groupe portent l'ID du groupe au lieu d'un numéro de téléphone.Trouvez ou créez le contact
Dans l'action Create/Update Contact, réglez Phone sur
+suivi de contact → phone parmi les valeurs de l'Inbound Webhook. WbizTool envoie le numéro sans+, et le+indique à HighLevel que le numéro contient l'indicatif du pays. Vous pouvez aussi associer contact → name. C'est le nom WhatsApp de l'expéditeur, et il peut remplacer un nom que vous avez modifié dans HighLevel.Ajoutez le message au contact
Ajoutez une action Add to Notes. Écrivez une note comme « Message WhatsApp : » et choisissez message → content et message → timestamp parmi les valeurs de l'Inbound Webhook. Vous pouvez aussi ajouter Add Contact Tag (par exemple
whatsapp), une tâche ou une notification interne pour votre équipe.Publiez
Publiez le workflow et envoyez un autre message de test.
| Valeur de l'Inbound Webhook | À utiliser pour |
|---|---|
contact.phone | Le téléphone du contact. Ajoutez + devant. |
contact.name | Le nom WhatsApp de l'expéditeur. Peut être vide. |
message.content | Le texte. Pour les photos, les messages vocaux et les fichiers, c'est une étiquette comme 📸 Image, et les légendes ne sont pas incluses. |
message.timestamp | Le moment où le message a été envoyé sur WhatsApp (ISO 8601, UTC). |
message.media.url | Un lien de téléchargement pour une photo ou un fichier. Il expire au bout de 3 jours et demi à 7 jours, ne comptez donc pas dessus dans une note. |
whatsapp_phone | Celui de vos numéros qui l'a reçu, si plusieurs numéros envoient au même workflow. |
event | message_received ou message_sent. |
- Seuls les nouveaux messages sont transmis, à partir du moment où le webhook est défini. Les anciennes discussions ne sont pas importées.
- Un webhook par numéro. Chaque numéro de la boîte envoie vers une seule URL. Si un Zap Zapier utilise le déclencheur Incoming WhatsApp Message pour le même numéro, le Zap reprend le webhook tant qu'il est activé.
- Répondre depuis HighLevel : pour répondre sur WhatsApp depuis le même workflow, ajoutez l'action Custom Webhook avec
"phone": "{{contact.phone_raw}}". - Gardez l'URL privée. L'Inbound Webhook de HighLevel ne vérifie pas la signature de WbizTool, donc toute personne qui connaît l'URL peut y envoyer des données. Si elle fuite, créez un nouveau déclencheur et collez sa nouvelle URL dans WbizTool.
Zapier#
L'application HighLevel sur Zapier s'appelle LeadConnector. Elle a un seul déclencheur, Pipeline Stage Changed. Ses actions comprennent Add/Update Contact et Add Task. Consultez Intégration Zapier pour connecter WbizTool.
- Envoyer : déclencheur LeadConnector Pipeline Stage Changed, puis une étape Filter by Zapier pour l'étape de pipeline voulue, puis WbizTool Send Text-Only WhatsApp Message. Choisissez le numéro sous WhatsApp Number, associez le téléphone du contact à Phone Number et rédigez le Message. Pour les autres événements HighLevel, utilisez plutôt l'action Custom Webhook.
- Recevoir : déclencheur WbizTool Incoming WhatsApp Message (nécessite le module Unibox), puis une étape Filter by Zapier qui ne continue que si Contact Phone Hidden et Is Group sont faux. Ensuite LeadConnector Add/Update Contact avec le téléphone réglé sur
+et Contact Phone, puis LeadConnector Add Task avec Message Content.
Make#
L'application HighLevel sur Make s'appelle GoHighLevel. Ces modèles n'utilisent que les modules génériques Webhooks, JSON et HTTP de Make, vous n'avez donc pas besoin d'une connexion GoHighLevel dans Make. Le modèle de réception a besoin à la place d'un jeton Private Integration de HighLevel et de votre location ID (voir ci-dessous).
Importez le blueprint
Téléchargez un modèle ci-dessous. Dans Make, créez un scénario, ouvrez le menu … et choisissez Import blueprint.
Créez le webhook
Ouvrez le module Webhooks, cliquez sur Add pour créer un webhook et copiez son adresse.
Remplissez les espaces réservés
Remplacez chaque espace réservé en majuscules dans les modules HTTP, comme
YOUR_WBIZTOOL_API_KEYetYOUR_WHATSAPP_CLIENT_ID.Connectez le webhook
Envoyer : dans HighLevel, ajoutez à votre workflow une action Webhook avec l'adresse Make comme URL. Sous Custom Data, ajoutez la clé
phone_rawavec la valeur{{contact.phone_raw}}. Recevoir : collez l'adresse Make comme URL de webhook du numéro dans Numéros de la boîte, avec uniquement Messages reçus coché.Exécutez-le une fois
Cliquez sur Run once dans Make et déclenchez le workflow, ou envoyez un message WhatsApp à votre numéro.
Le modèle de réception écrit dans HighLevel via son API, avec un jeton Private Integration issu des paramètres de votre sous-compte, avec le scope contacts.write, et le location ID de votre sous-compte. Vous pouvez utiliser à la place les modules Create a Contact et Add a Note to the Contact de l'application GoHighLevel.
n8n#
n8n a un node HighLevel intégré. Son opération Contact → Create or Update trouve un contact par téléphone ou e-mail, ou en crée un, et peut ajouter une Note. Installez d'abord le community node WbizTool : consultez Intégration n8n.
Importez le workflow
Téléchargez un modèle ci-dessous. Dans n8n, créez un workflow et importez le fichier (menu … → Import from File, ou collez le JSON sur le canevas).
Ajoutez vos credentials
Ouvrez le node WbizTool Send Message et choisissez ou créez un credential WbizTool API. Dans le workflow de réception, ouvrez le node HighLevel et choisissez ou créez un credential HighLevel.
Connectez le webhook
Copiez l'URL de production du node Webhook. Envoyer : utilisez-la comme URL d'une action Webhook de HighLevel, avec la clé Custom Data
phone_rawréglée sur{{contact.phone_raw}}. Recevoir : collez-la comme URL de webhook du numéro dans Numéros de la boîte, avec uniquement Messages reçus coché.Activez
Activez le workflow et faites un test.
Pabbly Connect#
Utilisez le déclencheur webhook de Pabbly Connect et son action API (Pabbly), configurée comme dans Envoyer des messages WhatsApp depuis n'importe quel outil d'automatisation. Pour l'envoi, dirigez une action Webhook de HighLevel vers l'URL du webhook Pabbly et associez phone_raw à phone. Pour les messages entrants, collez l'URL du webhook Pabbly comme URL de webhook du numéro dans Numéros de la boîte.
Modèles#
| Fichier | Ce qu'il fait |
|---|---|
| ghl-blocks.md | Les blocs à copier-coller de cette page, dans un seul fichier. |
| gohighlevel-to-whatsapp.make.json | Make : webhook HighLevel → message WhatsApp. |
| whatsapp-to-gohighlevel.make.json | Make : message WhatsApp entrant → contact et note HighLevel. |
| gohighlevel-to-whatsapp.n8n.json | n8n : webhook HighLevel → message WhatsApp. |
| whatsapp-to-gohighlevel.n8n.json | n8n : message WhatsApp entrant → contact HighLevel avec une note. |
Les modèles ne contiennent aucune clé. Ajoutez les vôtres dans les espaces réservés ou les credentials après l'import.
Dépannage#
| Problème | Que faire |
|---|---|
Le message part vers le mauvais numéro, ou Invalid phone number | Utilisez {{contact.phone_raw}}, pas {{contact.phone}}. Si le numéro du contact n'a pas d'indicatif du pays dans HighLevel, ajoutez country_code au corps ou corrigez le contact. |
Either phone or group_name parameter is required | Le contact n'a pas de numéro de téléphone. Ajoutez une étape If/Else avant l'action. |
Auth Error: invalid api key | Vérifiez l'en-tête Authorization : Bearer, un espace, puis la clé, sans guillemets. La clé a peut-être été supprimée. Consultez Clés API. |
Invalid whatsapp client ou Invalid whatsapp client id. | Utilisez le WhatsApp Client ID affiché dans Numéros WhatsApp. Il est obligatoire si vous avez plus d'un numéro. |
Invalid JSON format: … | Le corps n'est pas un JSON valide : une virgule manquante, une virgule en trop à la fin, un vrai saut de ligne dans msg, ou une valeur insérée qui contient un guillemet double. |
"status": 1, mais rien n'arrive | Le message reste en file d'attente jusqu'à ce que votre numéro WhatsApp soit connecté. Vérifiez Numéros WhatsApp et le statut du message. |
| L'action Custom Webhook ou Inbound Webhook est absente | L'agence n'a pas activé les fonctions premium des workflows (Workflow - Premium Features), ou le sous-compte a utilisé ses exécutions gratuites et n'est pas refacturé. Demandez à votre agence. |
| Aucun message entrant n'arrive dans HighLevel | Le numéro doit afficher Synchronisation dans Numéros de la boîte, avec la bonne URL et Messages reçus coché. Le récepteur doit répondre 2xx en moins de 8 secondes. Les requêtes arrivent avec le User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), au cas où un pare-feu filtre sur cette valeur. Plus d'informations dans Webhooks de messages entrants. |
| Module Unibox requis | Les messages entrants nécessitent le module Unibox sur un forfait payant ou à vie. Consultez Forfaits et facturation. |
| Un nouveau contact est créé à chaque message | Associez Phone avec le + devant, pour que HighLevel retrouve le contact existant. |
| Les discussions de groupe créent des contacts étranges | Ignorez les messages où contact.is_group vaut true dans une étape If/Else. |
| Les messages entrants se sont arrêtés après l'activation d'un Zap | Un Zap avec le déclencheur WbizTool Incoming WhatsApp Message reprend le webhook du numéro tant qu'il est activé. Désactivez le Zap, ou utilisez un autre numéro. |
Voir aussi#
- API d'envoi de messages : tous les champs et toutes les erreurs
- Webhooks de messages entrants : numéros de la boîte, envoi, contenu
- Clés API et Client ID
- Intégration Zapier
- Intégration n8n
- Envoyer depuis n'importe quel outil d'automatisation : Make, Pabbly Connect et d'autres

