Message codes from GoHighLevel
When you send an outbound message from GoHighLevel to WhatsApp through WhatGHL, you can add # codes to control how that message is routed, transformed, or delivered.
This guide is written for day-to-day operations: what to type, in what order, and what the real parser expects.
Use these codes in GHL conversation messages (or automations that post the same outbound body type).
Quick rules (important)
- Keep the order when combining prefixes.
- Several codes only work when placed at the start of the current text.
- Use exact spellings (for example
#traslate, not#translate). - If a format is invalid, WhatGHL may send it as normal text.
Processing order when combining codes
WhatGHL processes in this order:
#WHN(route by session priority)#NOPRESENCE|#MSGALL|- Interactive messages (polls, events, lists, etc.)
- Inline translation (
#traslate) - TTS (
#voice)
If you change this order, some codes may not be detected.
1) Session routing: #WHN
- Example:
#WH2 Hello, this is support. - What it does: tries to send through the WhatsApp session with priority
2(WORKING state). - Removed from output text: yes.
If you omit #WH, WhatGHL applies your configured outbound routing rules in Sub-account → Connection → Outbound session selection.
#|id prefixIf a message still starts with #|id123 from old templates, WhatGHL strips it, but it no longer routes by that value.
2) Sending modes
#NOPRESENCE|
- Example:
#NOPRESENCE|Your code is 482910 - What it does: sends without presence simulation.
- Must be at start: yes.
- Removed: yes.
#MSGALL|
- Example:
#MSGALL|Team, meeting at 10:00 - What it does: in WhatsApp groups, mentions everyone (
@all). - Must be at start: yes (after
#NOPRESENCE|if both are used). - Removed: yes.
3) Interactive messages
Interactive syntax now lives in its dedicated page (to avoid duplicated docs):
That page contains exact formats, limits, parser order, and examples for:
#POLL/#POLL:MULTIPLE#EVENT#LIST/#LISTJSON#LOCATION#LINKPREVIEW/#LCP#CONTACT
4) Circle video / PTV: #CIRCLE
Applies when there is a video attachment:
- If text contains
#CIRCLE, media may be sent as PTV. - Caption cleanup removes tokens like
#CIRCLE1,#CIRCLE12, etc. - If you use only
#CIRCLE(without digits), the literal may remain in caption text.
Recommendation: use #CIRCLE1 if you want a clean caption.
5) Inline translation: #traslate
Type exactly
#traslate(not#translate).
| Code | What it does |
|---|---|
#traslate | Forces translation of this outbound (when outbound translation + AI are configured). |
#traslate:xx | Same, but sets target language for this send. Supported: es, en, pt, fr, de, it. |
Important notes:
- Unsupported
:xxvalues (for example:br) do not apply a language override. - The trigger only runs when outbound translation and AI config are complete.
6) Text-to-speech: #voice
| Code | What it does |
|---|---|
#voice | Converts text to audio (MP3) and sends it to WhatsApp. |
#voice:xx | Forces a voice/language route for this send. |
Typical conditions for TTS to run:
- TTS enabled on the sub-account.
- No attachment and no interactive payload on that same outbound.
- Valid voice provider configuration.
About #voice:xx:
- Supports core language keys (
es,en,pt,fr,de,it) plus configured LATAM regional keys (for examplemx,ar,co,br, etc.). - WhatGHL checks
#voicein original text before translation strips hashtags.
7) Internal only: #note
If a message contains #note as a word token, WhatGHL treats it as an internal note and skips forwarding it to WhatsApp.
Copy-paste examples
#WH1 #NOPRESENCE|Hello, this is a quick alert#traslate:en Hola, gracias por escribirnos#voice:mx #traslate:es Hello, how can I help you today?
Quick reference
| Code | Use |
|---|---|
#WHN | Route by session priority |
#NOPRESENCE| | Send without presence simulation |
#MSGALL| | Mention everyone in groups |
| See interactive section | Polls, events, lists, location, custom preview, contact card |
#CIRCLE / #CIRCLE1 | Circle video (PTV) with video attachment |
#traslate / #traslate:xx | Inline translation |
#voice / #voice:xx | Text-to-speech |
#note | Internal only (do not forward) |
Related docs
- Sessions — priorities and sessions.
- Groups — usage with
#MSGALL|. - Interactive messages — interactive payload design.
- Embedded command generator — assisted command creation.
- Onboarding — baseline setup before production.