Skip to main content

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.

Where this applies

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:

  1. #WHN (route by session priority)
  2. #NOPRESENCE|
  3. #MSGALL|
  4. Interactive messages (polls, events, lists, etc.)
  5. Inline translation (#traslate)
  6. 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.

Legacy #|id prefix

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

CodeWhat it does
#traslateForces translation of this outbound (when outbound translation + AI are configured).
#traslate:xxSame, but sets target language for this send. Supported: es, en, pt, fr, de, it.

Important notes:

  • Unsupported :xx values (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

CodeWhat it does
#voiceConverts text to audio (MP3) and sends it to WhatsApp.
#voice:xxForces 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 example mx, ar, co, br, etc.).
  • WhatGHL checks #voice in 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

CodeUse
#WHNRoute by session priority
#NOPRESENCE|Send without presence simulation
#MSGALL|Mention everyone in groups
See interactive sectionPolls, events, lists, location, custom preview, contact card
#CIRCLE / #CIRCLE1Circle video (PTV) with video attachment
#traslate / #traslate:xxInline translation
#voice / #voice:xxText-to-speech
#noteInternal only (do not forward)