Saltar al contenido principal

Mensajes interactivos de WhatsApp

Los mensajes interactivos permiten que el contacto vote encuestas, confirme eventos, elija filas de lista, reciba ubicaciones o contactos, y vea previews personalizadas.
En WhatGHL se controlan con tokens estructurados escritos en el cuerpo del mensaje en GoHighLevel.

Qué puedes construir​

PatrónUso típico
EncuestasOpciones rápidas (“soporte / ventas / facturación”).
EventosPropuestas de cita con confirmar / rechazar.
ListasMenús con secciones y filas.
Tarjetas de contactoNombre y teléfono tipo vCard.
UbicaciónCoordenadas + título para compartir una ubicación.
Vista previa de enlacePreview custom con JSON (#LINKPREVIEW / #LCP).

Orden de detección (importante)​

Si mezclas formatos en un mismo mensaje, el parser intenta detectar en este orden:

  1. #POLL
  2. #EVENT
  3. #LOCATION
  4. #LIST / #LISTJSON
  5. #LINKPREVIEW / #LCP
  6. #CONTACT

Cuando uno coincide, normalmente los siguientes ya no se evalúan en ese envío.

Formatos soportados​

Encuesta​

  • Opción única: #POLL|Pregunta|Opción 1|Opción 2
  • Opción múltiple: #POLL:MULTIPLE|Pregunta|A|B|C
  • Límite: hasta 12 opciones.

Evento​

#EVENT|Nombre|UNIX_TIMESTAMP|Descripción|Ubicación|true_or_false
  • UNIX_TIMESTAMP: segundos.
  • El último campo acepta true o false.

Lista​

  • Formato simple: #LIST|Cuerpo|Texto botón|Sección 1|Fila 1*Descripción*id|Fila 2*Descripción*id||Sección 2|...
  • Formato JSON: #LIST|{...} o #LISTJSON|{...}
  • Límite total: 10 filas entre todas las secciones.

Ubicación​

  • Formato: #LOCATION|latitud|longitud|titulo_opcional
  • Ejemplo: #LOCATION|19.4326|-99.1332|Oficina CDMX

Vista previa personalizada​

  • Formato JSON: #LINKPREVIEW|{...} o #LCP|{...}
  • Debe incluir JSON válido (text, preview.url, preview.title, etc.).

Contacto​

  • Formato: #CONTACT|Nombre|Teléfono
  • Puede ir en cualquier parte del texto.
  • Solo se procesa si antes no se detectó otro interactivo.

Ejemplos listos para copiar​

  • #POLL|¿Qué necesitas?|Soporte|Ventas|Facturación
  • #POLL:MULTIPLE|¿Qué canales prefieres?|WhatsApp|Email|Llamada
  • #LIST|Selecciona un servicio|Ver opciones|Servicios|Implementación*Setup inicial*srv_impl|Soporte*Mesa de ayuda*srv_sup
  • #EVENT|Reunión onboarding|1738789200|Sesión inicial|Google Meet|true
  • #LOCATION|19.4326|-99.1332|Oficina CDMX
  • Gracias por escribir #CONTACT|Equipo Soporte|5215512345678

Dónde importa la configuración​

  • La subcuenta necesita una sesión de WhatsApp operativa y permisos para el tipo de payload.
  • El enrutado (#WH, prioridad de sesión) decide qué línea envía el interactivo — ver Connection.
  • La traducción puede modificar texto visible. Si usas #traslate, valida que labels y títulos del interactivo sigan claros.

Buenas prácticas​

  • Prueba formatos nuevos en una subcuenta de prueba o número de bajo tráfico.
  • Mantén textos cortos; títulos y labels muy largos se recortan en algunos dispositivos.
  • Si usas lista, diseña para máximo 10 filas.
  • Para vídeo/nota y #CIRCLE, revisa Códigos de mensaje desde GoHighLevel.

Relacionado​