Códigos de mensaje desde GoHighLevel

Cuando envías un mensaje saliente desde GoHighLevel hacia WhatsApp usando WhatGHL, puedes agregar códigos (normalmente con #) para cambiar el comportamiento del envío.

Esta guía está pensada para uso diario del equipo: qué código usar, en qué orden y qué espera el parser real de la app.

Dónde aplica

Úsalos en el cuerpo del mensaje de conversación de GHL (o en automatizaciones que publiquen el mismo tipo de mensaje saliente).

Reglas rápidas (muy importantes)

Respeta el orden cuando combines prefijos.
Varios códigos se detectan solo si están al inicio del texto actual.
Usa los códigos en su forma exacta (por ejemplo #traslate, no #translate).
Si un código no coincide con el formato, WhatGHL puede enviarlo como texto normal.

Orden cuando combinas códigos

WhatGHL procesa en este orden:

#WHN (enrutamiento por prioridad)
#NOPRESENCE|
#MSGALL|
Mensajes interactivos (encuesta, evento, lista, etc.)
Traducción inline (#traslate)
TTS (#voice)

Si cambias ese orden, algunos códigos pueden dejar de detectarse.

1) Enrutamiento de sesión: `#WHN`

Ejemplo: #WH2 Hola, te escribimos de soporte.
Qué hace: intenta enviar por la sesión WhatsApp con prioridad 2 (estado WORKING).
Se elimina del texto final: sí.

Si no usas #WH, se aplican las reglas de enrutado configuradas en Subcuenta → Connection → Outbound session selection.

Prefijo antiguo #|id

Si el mensaje empieza con #|id123 (plantillas viejas), el sistema lo limpia, pero ya no lo usa para enrutar.

2) Modos de envío

`#NOPRESENCE|`

Ejemplo: #NOPRESENCE|Tu código es 482910
Qué hace: envía sin simulación de presencia.
Debe ir al inicio: sí.
Se elimina: sí.

`#MSGALL|`

Ejemplo: #MSGALL|Equipo, reunión a las 10:00
Qué hace: en grupos WhatsApp, menciona a todos (@all).
Debe ir al inicio: sí (después de #NOPRESENCE| si usas ambos).
Se elimina: sí.

3) Mensajes interactivos

Toda la sintaxis de mensajes interactivos se documenta en una página aparte para evitar duplicados:

Mensajes interactivos de WhatsApp

Ahí encontrarás formatos, límites, orden de parseo y ejemplos de:

#POLL / #POLL:MULTIPLE
#EVENT
#LIST / #LISTJSON
#LOCATION
#LINKPREVIEW / #LCP
#CONTACT

4) Vídeo circular / PTV: `#CIRCLE`

Aplica cuando hay adjunto de vídeo:

Si el texto contiene #CIRCLE, el vídeo puede enviarse como PTV.
El sistema limpia del caption tokens tipo #CIRCLE1, #CIRCLE12, etc.
Si usas solo #CIRCLE (sin dígitos), el literal puede quedar visible en el caption.

Recomendación: usa #CIRCLE1 si quieres caption limpio.

5) Traducción inline: `#traslate`

Escribe exactamente #traslate (no #translate).

Código	Qué hace
`#traslate`	Fuerza traducción del mensaje (si traducción saliente + IA están activas).
`#traslate:xx`	Igual, pero fija idioma destino para ese envío. Códigos soportados: `es`, `en`, `pt`, `fr`, `de`, `it`.

Notas importantes:

Si pones un :xx no soportado (por ejemplo :br), no se aplica override de idioma.
El trigger solo corre cuando la traducción saliente y la configuración IA están completas.

6) Voz (TTS): `#voice`

Código	Qué hace
`#voice`	Convierte el texto en audio (MP3) y lo envía por WhatsApp.
`#voice:xx`	Fuerza ruta de voz/idioma para ese envío.

Condiciones habituales para que se genere audio:

TTS activo en la subcuenta.
Sin adjunto y sin payload interactivo en ese mismo envío.
Proveedor/configuración de voz correctos.

Sobre #voice:xx:

Soporta idiomas base (es, en, pt, fr, de, it) y claves regionales LATAM definidas en la subcuenta (por ejemplo mx, ar, co, br, etc.).
El sistema busca #voice en el texto original antes de limpiar hashtags por traducción.

7) Solo interno: `#note`

Si el mensaje contiene #note como palabra, WhatGHL lo trata como nota interna y no lo reenvía a WhatsApp.

Ejemplos listos para copiar

#WH1 #NOPRESENCE|Hola, este es un aviso rápido
#traslate:en Hola, gracias por contactarnos
#voice:mx #traslate:es Hello, how can I help you today?

Referencia rápida

Código	Uso
`#WHN`	Enrutar por prioridad de sesión
`#NOPRESENCE\|`	Enviar sin presencia
`#MSGALL\|`	Mencionar a todos en grupos
Ver sección interactivos	Encuestas, eventos, listas, ubicación, vista previa y contacto
`#CIRCLE` / `#CIRCLE1`	Vídeo circular (PTV) con adjunto vídeo
`#traslate` / `#traslate:xx`	Traducción inline
`#voice` / `#voice:xx`	Texto a voz
`#note`	No reenviar a WhatsApp

Documentación relacionada

Sessions — prioridades y sesiones.
Groups — uso de #MSGALL|.
Mensajes interactivos — diseño de payloads interactivos.
Generador de comandos embebido — creación asistida de comandos.
Onboarding — configuración base antes de producción.

Reglas rápidas (muy importantes)​

Orden cuando combinas códigos​

1) Enrutamiento de sesión: #WHN​

2) Modos de envío​

#NOPRESENCE|​

#MSGALL|​

3) Mensajes interactivos​

4) Vídeo circular / PTV: #CIRCLE​

5) Traducción inline: #traslate​

6) Voz (TTS): #voice​

7) Solo interno: #note​

Ejemplos listos para copiar​

Referencia rápida​

Documentación relacionada​