Aller au contenu
WbizTool

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#

SensExempleComment
HighLevel → WhatsAppUn 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 → HighLevelUn 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éthodeEnvoyer (HighLevel → WhatsApp)Recevoir (WhatsApp → HighLevel)Forfaits nécessaires
Workflows HighLevel (recommandé)Action Custom Webhook → API d'envoi de messagesWebhook WbizTool → déclencheur Inbound WebhookFonctions premium des workflows HighLevel. Réception : le module Unibox.
ZapierLeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp MessageWbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact ou Add TaskUn compte Zapier. Réception : le module Unibox.
MakeAction Webhook de HighLevel → Webhooks de Make → module HTTPWebhook WbizTool → Webhooks de Make → API HighLevelUn compte Make. Réception : le module Unibox.
n8nAction Webhook de HighLevel → Webhook de n8n → WbizTool Send MessageWebhook WbizTool → Webhook de n8n → node HighLeveln8n avec le community node WbizTool. Réception : le module Unibox.
Pabbly ConnectAction Webhook de HighLevel → déclencheur webhook de Pabbly → requête API (Pabbly)Webhook WbizTool → déclencheur webhook de Pabbly → votre étape HighLevelUn compte Pabbly Connect. Réception : le module Unibox.

Envoyer des messages WhatsApp depuis un workflow HighLevel#

  1. 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é.

  2. 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.

  3. 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ête Authorization avec la valeur Bearer YOUR_API_KEY. Réglez Content-Type sur application/json.

  4. Collez le corps

    Collez l'un des blocs à copier-coller dans Raw Body et remplacez 678 par votre WhatsApp Client ID. Utilisez l'icône de tag de HighLevel pour ajouter d'autres champs du contact au message.

  5. 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

Raw Body de l'action Custom Webhook
{
  "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 : 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 \n dans le texte. Un vrai saut de ligne rend le JSON invalide.
  • Images et fichiers : les liens doivent être publics. msg devient 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_name est le nom exact d'un groupe WhatsApp dont votre numéro fait partie. Envoyez group_name ou phone, 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.

  1. 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.

  2. 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.

  3. 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).

  4. Ignorez les groupes et les numéros masqués

    Ajoutez une étape If/Else qui ne continue que si event vaut message_received, contact.is_group vaut false et contact.phone n'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.

  5. 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.

  6. 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.

  7. Publiez

    Publiez le workflow et envoyez un autre message de test.

Valeur de l'Inbound WebhookÀ utiliser pour
contact.phoneLe téléphone du contact. Ajoutez + devant.
contact.nameLe nom WhatsApp de l'expéditeur. Peut être vide.
message.contentLe 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.timestampLe moment où le message a été envoyé sur WhatsApp (ISO 8601, UTC).
message.media.urlUn 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_phoneCelui de vos numéros qui l'a reçu, si plusieurs numéros envoient au même workflow.
eventmessage_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).

  1. 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.

  2. Créez le webhook

    Ouvrez le module Webhooks, cliquez sur Add pour créer un webhook et copiez son adresse.

  3. Remplissez les espaces réservés

    Remplacez chaque espace réservé en majuscules dans les modules HTTP, comme YOUR_WBIZTOOL_API_KEY et YOUR_WHATSAPP_CLIENT_ID.

  4. 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_raw avec 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é.

  5. 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.

  1. 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).

  2. 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.

  3. 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_raw ré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é.

  4. 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#

FichierCe qu'il fait
ghl-blocks.mdLes blocs à copier-coller de cette page, dans un seul fichier.
gohighlevel-to-whatsapp.make.jsonMake : webhook HighLevel → message WhatsApp.
whatsapp-to-gohighlevel.make.jsonMake : message WhatsApp entrant → contact et note HighLevel.
gohighlevel-to-whatsapp.n8n.jsonn8n : webhook HighLevel → message WhatsApp.
whatsapp-to-gohighlevel.n8n.jsonn8n : 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èmeQue faire
Le message part vers le mauvais numéro, ou Invalid phone numberUtilisez {{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 requiredLe contact n'a pas de numéro de téléphone. Ajoutez une étape If/Else avant l'action.
Auth Error: invalid api keyVé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'arriveLe 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 absenteL'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 HighLevelLe 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 requisLes messages entrants nécessitent le module Unibox sur un forfait payant ou à vie. Consultez Forfaits et facturation.
Un nouveau contact est créé à chaque messageAssociez Phone avec le + devant, pour que HighLevel retrouve le contact existant.
Les discussions de groupe créent des contacts étrangesIgnorez 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 ZapUn 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#