HighLevel + WhatsApp, native sync

Overview

Wazzap installs as a custom conversation provider in HighLevel at the agency level. From there you map each Wazzap sub-account to a GHL sub-account (one-to-one). Once linked, the sync is bidirectional and instantaneous:

• A customer sends a WhatsApp → message appears in GHL's Conversations tab.
• A salesperson replies inside GHL → it leaves your real WhatsApp number.
• Contact details (name, phone, tags) propagate both ways.

What syncs (and what doesn't)

To set expectations:

• Syncs both ways: text messages, images, audio, video, documents, stickers, locations, contact cards, replies, message edits, reactions (where GHL supports).
• Syncs one way (Wazzap → GHL): typing indicators, read receipts, presence.
• Doesn't sync: WhatsApp polls (GHL has no equivalent), live location updates after the first ping, view-once media.

Setup in 3 steps

1. Get your Agency API key from HighLevel

1. In HighLevel, switch to your Agency view.
2. Open Settings → Business Profile → API Key.
3. Copy the Agency API Key. Treat it like a password.

Paste the key into Wazzap at Settings → Integrations → HighLevel. Click "Connect". The connection is verified in seconds.

2. Map sub-accounts

For each Wazzap sub-account (a connected WhatsApp number), pick which GHL sub-account it should sync to. One Wazzap sub-account = one GHL sub-account. If you have 10 agency clients, you'll pair 10 Wazzap sub-accounts with their respective GHL sub-accounts.

Wazzap sub-account #4  →  GHL sub-account "Acme Co"
Wazzap sub-account #5  →  GHL sub-account "Vertex AI"
…

3. Test with the first chat

From your phone, send a WhatsApp to the linked number. Open GHL's Conversations tab in the matching sub-account — the message should be there within 1-2 seconds. Reply from GHL. Your phone buzzes. Done.

White-label setup

If you resell Wazzap under your own brand (agency white-label), the GHL conversation tab can display your brand instead of "Wazzap":

1. In Wazzap, go to Brand Settings → GHL provider name.
2. Enter your agency name and upload your logo (PNG, square, 512px+).
3. Click "Push to HighLevel". GHL re-renders the conversation provider with your branding.

Your clients inside GHL see your agency, never "Wazzap". See the white-label guide for domain + emails too.

Troubleshooting

"Connection verified" but messages don't appear in GHL

Most common cause: a sub-account is mapped to the wrong GHL location. Open the mapping panel and confirm the destination sub-account is the one with active chats.

Outbound messages from GHL show "Failed"

Your WhatsApp number is probably disconnected (phone offline 14+ days, or banned). Re-scan the QR in Wazzap. The message queue retries automatically.