WhatsApp koppelen aan GoHighLevel-contacten op een Coexistence-nummer

Hoe komt een WhatsApp-bericht bij een HighLevel-contact?

Meta stuurt elk bericht op het nummer naar de webhook-bestemming die je hebt ingesteld, hier een n8n Webhook-node. De workflow geeft het nummer van de afzender en de WhatsApp-profielnaam door aan de HighLevel-node van n8n. De contactresource daarvan heeft een bewerking om aan te maken of bij te werken, dus een nieuwe afzender wordt een contact en een bekende wordt gevonden in plaats van dubbel aangemaakt.

Heb je de contact-id, dan plaatst een node voor HTTP-verzoeken de berichttekst naar /contacts/{contactId}/notes. De notitie verschijnt op het contactrecord, waar iedereen die het opent ziet wat de klant schreef. Vraagt het bericht om opvolging, dan kan de HighLevel-node ook een taak op het contact aanmaken of een opportunity in een pipeline, allebei rechtstreeks ondersteund.

Het team blijft gewoon antwoorden vanuit de WhatsApp Business app.

Welk token moet de workflow gebruiken?

Een Private Integration-token. De API v2 van HighLevel is bereikbaar met OAuth of met een van deze tokens, en de oude v1 API-sleutels zijn end of life. Een Private Integration-token maak je aan in de instellingen van het sub-account, afgebakend tot de rechten die je aanvinkt, en je stuurt het mee in de Authorization-header zoals elk toegangstoken.

Het ververst zichzelf niet, wat goed past bij een automatisering: het blijft werken totdat iemand het roteert. Roteer je het, dan houdt HighLevel het oude en het nieuwe token zeven dagen naast elkaar geldig. Dat is je tijdvenster om het nieuwe token in n8n te plakken voordat het oude stopt.

Vink alleen de scopes aan die de workflow nodig heeft: contacten, notities en, als je ze gebruikt, opportunities en taken. Vind je Private Integrations niet in de instellingen, dan zegt HighLevel dat je het in Labs moet inschakelen.

Hoe bedient één workflow meerdere sub-accounts van klanten?

Door te routeren op het ontvangende nummer. Elke webhook die Meta stuurt bevat het phone_number_id van het bedrijfsnummer dat het bericht ontving. Wijs het nummer van elke klant naar dezelfde n8n-webhook, houd een kleine tabel bij die elk phone_number_id koppelt aan het sub-account en het token van die klant, en zoek het token aan het begin van elke run op.

Zo hoef je maar één workflow te onderhouden voor alle klanten, en dat telt voor een bureau zwaarder dan voor wie dan ook. Een fix in de matchinglogica of het notitieformaat komt voor iedereen tegelijk door.

De limieten worden geteld per app per sub-account, dus klanten eten niet van elkaars ruimte: elk heeft zijn eigen 100 verzoeken per tien seconden en 200.000 per dag.

Komen antwoorden die op de telefoon zijn getypt in HighLevel terecht?

Dat kan. Op een Coexistence-nummer blijft de WhatsApp Business app in gebruik, en als iemand daarvandaan antwoordt, stuurt Meta een echo van het uitgaande bericht naar dezelfde webhook-bestemming, onder het veld smb_message_echoes.

Voeg een tak toe voor die echo's en schrijf ze als notities die als verzonden zijn gemarkeerd. Het contactrecord bevat dan de regels van de klant en de antwoorden van het bedrijf op volgorde, en dat verwacht een klant te zien als die zijn CRM opent.

Verstuurt de workflow zelf een bericht via de Cloud API, bijvoorbeeld een goedgekeurd template nadat een afspraak is geboekt, schrijf de notitie dan op het moment van verzenden. De workflow heeft de tekst en de contact-id dan al.

Veelgemaakte fouten

• Een v1 API-sleutel gebruiken. De v1 API van HighLevel is end of life; API v2 vraagt om een Private Integration-token of OAuth.
• Het Private Integration-token roteren zonder n8n bij te werken binnen de overlap van zeven dagen. Elke aanroep mislukt zodra het oude token verloopt.
• De berichten van alle klanten schrijven met het token van één sub-account. Koppel eerst phone_number_id aan het juiste sub-account, anders belanden records bij de verkeerde klant.

Veelgestelde vragen

Lees verder