Integración Nativa de WhatsApp para GoHighLevel
Connect es la plataforma empresarial que conecta múltiples números de WhatsApp personales y de empresa directamente a tus subcuentas de GoHighLevel con sincronización bidireccional en tiempo real, soporte de grupos, acciones y disparadores nativos para automatizaciones de Workflows.
Native WhatsApp Integration for GoHighLevel
Connect is the enterprise platform connecting multiple personal and business WhatsApp numbers directly into your GoHighLevel subaccounts with real-time 2-way synchronization, full group support, and native Workflow actions & triggers.
🏢 Conectar tu Subcuenta de GoHighLevel (OAuth)
Connect se integra de manera oficial con la API v2 de GoHighLevel. Para autorizar una subcuenta, sigue estos pasos:
🏢 Connect your GoHighLevel Subaccount (OAuth)
Connect officially integrates with GoHighLevel API v2. Follow these steps to authorize a subaccount:
📱 Vincular tu Número de WhatsApp
Puedes conectar cualquier número con WhatsApp Messenger normal o WhatsApp Business utilizando dos métodos seguros:
Método A: Código de Vinculación de 8 Dígitos (Recomendado)
59175224090 o 5215512345678 sin espacios ni signos más).Método B: Código QR
Si prefieres escanear con la cámara: selecciona la pestaña "Código QR", abre WhatsApp en tu celular > Dispositivos vinculados > Vincular un dispositivo y apunta la cámara a la pantalla.
📱 Link your WhatsApp Number
You can connect any phone number using standard WhatsApp Messenger or WhatsApp Business via two secure methods:
Method A: 8-Digit Pairing Code (Recommended)
59175224090 or 14696613158 without spaces or plus signs).Method B: QR Code
If you prefer scanning with your camera: select the "QR Code" tab, open WhatsApp on your phone > Linked Devices > Link a Device and scan the code on your screen.
📲 Múltiples Celulares en la Misma Subcuenta
A diferencia de otras soluciones que solo admiten un número por subcuenta, Connect te permite conectar tantos números de WhatsApp como tu equipo de ventas necesite.
📲 Multiple Phones in the Same Subaccount
Unlike other platforms that only allow one number per location, Connect allows you to link as many WhatsApp numbers as your sales team requires.
👤 Asignar Número a un Vendedor / Asesor de GHL
Puedes fijar cada número de WhatsApp a un vendedor específico de GoHighLevel para que todas sus conversaciones salgan automáticamente por su propio número:
👤 Asesor: [Nombre del Asesor].👤 Assign a WhatsApp Number to a GoHighLevel User / Sales Rep
You can lock any WhatsApp number to a specific GoHighLevel user so that their assigned leads and manual replies automatically send from their personal WhatsApp:
👤 Rep: [Sales Rep Name].🔀 ¿Cómo decide el sistema por qué celular enviar el mensaje?
Cuando se envía un mensaje desde GoHighLevel (manual o automatizado), Connect ejecuta un algoritmo de decisión con 4 niveles de prioridad:
| Prioridad | Regla de Selección | Comportamiento |
|---|---|---|
| Nivel 1 | Vendedor Asignado al Contacto | Si el contacto en GHL está asignado al Vendedor A, y el Vendedor A tiene una línea conectada, el mensaje saldrá SIEMPRE por esa línea. |
| Nivel 2 | Usuario Remitente del Mensaje | Si un asesor responde manualmente desde la bandeja de GoHighLevel, el sistema detecta su usuario y usa su WhatsApp asignado. |
| Nivel 3 | Continuidad de Conversación | Si el contacto no tiene asesor asignado pero previamente conversó por la Línea B, se responderá por la Línea B para mantener la coherencia. |
| Nivel 4 (Fallback) | Línea Principal (Predeterminada ⭐) | Si ninguna de las anteriores aplica (por ejemplo, lead nuevo de publicidad), el mensaje sale por la línea marcada con la estrella dorada. |
🔀 How does the system choose which phone line dispatches the message?
When a message is sent from GoHighLevel (manually or via automation), Connect runs an intelligent 4-tier decision algorithm:
| Priority | Selection Rule | Behavior |
|---|---|---|
| Level 1 | Sales Rep Assigned to Contact | If the contact in GHL is assigned to Rep A, and Rep A has a linked line, the message will ALWAYS dispatch through Rep A's WhatsApp. |
| Level 2 | Sender User in GoHighLevel | If a rep manually replies from the GoHighLevel Conversations inbox, the system detects their user and routes through their assigned device. |
| Level 3 | Conversation Continuity | If no rep is assigned but the contact previously chatted via Line B, the reply will dispatch through Line B to preserve continuity. |
| Level 4 (Fallback) | Default Main Line (⭐) | If none of the above apply (e.g., brand-new ad leads), the message sends through the line marked with the golden star. |
⭐ Línea Predeterminada (Principal)
Cada subcuenta tiene exactamente una Línea Predeterminada identificada con una insignia verde y estrella dorada. Esta línea se utiliza como canal central para todos los mensajes masivos, campañas de marketing o contactos sin asesor asignado.
Para cambiar la línea predeterminada: abre los ajustes del dispositivo deseado (⚙️) y activa la opción "Establecer como Dispositivo Principal".
⭐ Default Main Line
Each subaccount has exactly one Default Line indicated by a green badge and golden star. This line is used as the central fallback for broadcasts, marketing campaigns, and unassigned leads.
To change the default line: open the settings of the desired device (⚙️) and check "Set as Default Main Device".
🎙️ Notas de Voz Nativas (Opus PTT)
Connect convierte automáticamente los audios grabados con el micrófono de GoHighLevel al formato oficial de notas de voz de WhatsApp (audio/ogg; codecs=opus):
- Aparecen con el icono de micrófono verde en el celular del cliente.
- Muestran la onda de sonido interactiva y foto de perfil.
- Permiten acelerar la reproducción (1.5x y 2x) directamente en WhatsApp.
🎙️ Native Voice Notes (Opus PTT)
Connect automatically converts audio recorded via GoHighLevel's microphone into native WhatsApp Push-to-Talk format (audio/ogg; codecs=opus):
- Appears with the green microphone icon on the client's phone.
- Shows interactive sound waveforms and profile picture.
- Enables playback speed control (1.5x and 2x) directly in WhatsApp.
📎 Envío y Recepción de Archivos
Todos los tipos de archivos estándar son compatibles de forma nativa en ambas direcciones:
📎 Sending & Receiving Media Files
All standard file formats are supported natively in both directions:
📜 Script Personalizado (Custom JS) dentro de GoHighLevel
Para que tú y tus clientes puedan gestionar y vincular sus teléfonos de WhatsApp sin salir de GoHighLevel, añade el siguiente script en los ajustes de tu empresa o subcuenta:
<script src="https://app.upghl.com/js/custom-ghl-script.js" defer></script>
Ve a GoHighLevel > Settings > Company > Custom JavaScript (o en los ajustes de la subcuenta en Settings > Custom Code) y guarda los cambios.
📜 Custom JavaScript inside GoHighLevel
To allow you and your subaccount users to link and manage WhatsApp devices directly from inside the GoHighLevel dashboard, add this script in your settings:
<script src="https://app.upghl.com/js/custom-ghl-script.js" defer></script>
Navigate to GoHighLevel > Settings > Company > Custom JavaScript (or subaccount Settings > Custom Code) and save changes.
👥 Grupos de WhatsApp en GoHighLevel
Connect cuenta con soporte completo y nativo para Grupos de WhatsApp. Puedes recibir los mensajes de tus grupos directamente en las Conversaciones de GoHighLevel, identificar qué miembro escribió, abrir un chat privado con un clic y automatizar envíos a grupos mediante Workflows.
👥 [Nombre del Grupo] y su identificador JID único (ej: [email protected]).
👤 Carlos Pérez: ¿Tienen cupos disponibles?, permitiendo saber exactamente quién está hablando sin confundirlo con otros participantes.
Connect permite a tus asesores responderle por privado al miembro de un grupo con solo hacer clic en el enlace de contacto directo. El sistema creará o abrirá automáticamente el contacto privado individual en GoHighLevel.
👥 WhatsApp Groups in GoHighLevel
Connect features full native support for WhatsApp Groups. Receive group messages directly in GoHighLevel Conversations, identify which participant sent each message, switch to private chat with 1 click, and automate group broadcasts via Workflows.
👥 [Group Name] and its unique Group JID (e.g. [email protected]).
👤 John Smith: Are there any seats left?, allowing your team to clearly see who is speaking.
Connect allows your sales reps to message any group participant privately with one click. The system instantly creates or opens the individual 1-on-1 contact in GoHighLevel.
⚡ Workflows: Custom Actions & Triggers Nativos
Connect no utiliza la acción genérica "Send SMS" ni el trigger estándar de SMS. Para garantizar máxima potencia, multimedia, soporte de grupos y notas de voz, Connect instala sus propias Custom Actions (Acciones Personalizadas) y Custom Triggers (Disparadores Personalizados) dentro del constructor de Workflows de GoHighLevel.
Al crear o editar un Workflow en GoHighLevel, al presionar "+" (Añadir Acción) o al seleccionar un Disparador (Trigger), busca en la categoría de aplicaciones instaladas o escribe "Connect" en el buscador de acciones de GHL.
⚙️ Custom Actions (Acciones de Workflow)
Dispones de 5 acciones personalizadas diseñadas específicamente para WhatsApp:
- Campos configurables: Teléfono (
{{contact.phone}}), Mensaje con emojis y variables ({{contact.first_name}}), URL de Adjunto (foto, PDF, video), Selector de Plantillas nativas de GHL o de Connect. - Protección inteligente: Es exclusivamente para mensajes directos 1 a 1. Si detecta por error el JID de un grupo, bloquea el envío para evitar errores de privacidad.
- Respeto de DND: Bloquea automáticamente envíos si el contacto tiene activado "No Molestar" (DND).
- Campos configurables: ID del Grupo (
groupJid, ej:[email protected]), Mensaje, Adjunto multimedia (foto, PDF, video) y Plantilla. - Trazabilidad en GHL: El mensaje enviado al grupo queda registrado inmediatamente en la conversación del grupo en GoHighLevel.
- Casos de uso: Avisos de inicio de clases, ofertas flash comunitarias, alertas grupales de soporte.
- Campos configurables: Teléfono de destino y Texto del guion a hablar.
- Efecto en el cliente: El cliente recibe un audio grabado como si un asesor humano lo hubiese enviado en ese instante.
- Campos configurables: Group JID, Teléfono del contacto y Acción (
addpara agregar oremovepara expulsar). - Ejemplo VIP: Cuando un cliente compra en GoHighLevel ➡️ Añadir al grupo VIP. Si cancela la suscripción o pide reembolso ➡️ Expulsar del grupo automáticamente.
🪝 Custom Triggers (Disparadores de Workflow)
Tus automatizaciones pueden reaccionar en tiempo real a los eventos que ocurren en WhatsApp:
| Disparador (Trigger) | Cuándo se Ejecuta | Datos y Variables que Entrega |
|---|---|---|
Connect - Mensaje de WhatsApp Recibidowhatsapp_inbound |
Cada vez que un cliente envía un mensaje directo (1 a 1) por WhatsApp. |
• message: Texto del mensaje.• phone: Teléfono del contacto.• contactId: ID del contacto en GHL.• mediaUrl / attachments: Archivos recibidos.
|
Connect - Mensaje de Grupo Recibidogroup_message_inbound |
Cada vez que un participante escribe dentro de un grupo de WhatsApp vinculado. |
• groupJid: ID del grupo de WhatsApp.• groupName: Nombre del grupo.• participantPhone: Teléfono real del miembro.• participantName: Nombre del miembro.• message: Mensaje recibido.
|
Connect - Botón / Lista Clickeadabutton_clicked |
Cuando el contacto presiona un botón interactivo o elige una opción de lista. |
• buttonId: Identificador del botón pulsado.• buttonText: Texto del botón seleccionado.
|
Connect - Nota de Voz Recibidavoice_received |
Cuando el cliente envía un audio o nota de voz. |
• mediaUrl: Archivo de audio para transcripción con IA.• duration: Duración de la nota de voz.
|
💡 Ejemplos Prácticos de Flujos en GoHighLevel
Acción: Connect - Enviar Mensaje WhatsApp con foto y catálogo en PDF.
Acción 2: Connect - Notificación Interna al asesor asignado.
Acción: Connect - Cambiar Participante de Grupo (añadir al grupo VIP de alumnos).
Acción 2: Connect - Enviar Mensaje a Grupo dando la bienvenida al nuevo estudiante.
Acción: Connect - Enviar Nota de Voz con IA saludando al cliente por su nombre.
⚡ Workflows: Native Custom Actions & Triggers
Connect does not use the generic "Send SMS" action or standard SMS trigger. To deliver full WhatsApp power, media attachments, group support, and voice notes, Connect provides its own Custom Actions and Custom Triggers directly inside GoHighLevel's Workflow Builder.
When creating or editing a Workflow in GoHighLevel, click "+" (Add Action) or select a Trigger, search under installed apps or type "Connect" in the search bar.
⚙️ Available Custom Actions
You have 5 dedicated WhatsApp actions designed for advanced CRM automations:
- Configurable fields: Destination Phone (
{{contact.phone}}), Message with emojis & variables ({{contact.first_name}}), Attachment URL (image, PDF, video), Template selector (native GHL or Connect templates). - Smart Protection: Exclusively for 1-on-1 chats. If a group JID is passed by accident, it blocks the send to prevent privacy issues.
- DND Enforcement: Automatically blocks sends if the contact has Do Not Disturb (DND) active in GoHighLevel.
- Configurable fields: Group ID (
groupJid, e.g.[email protected]), Message text, Media attachments (image, PDF, video), and Template. - GHL Traceability: Messages sent to the group are logged in the group's conversation thread in GoHighLevel.
- Use cases: Event reminders, community announcements, flash discounts.
- Configurable fields: Destination phone and Voice script text.
- Client Experience: The recipient receives an audio note that sounds completely natural, as if recorded live by a sales rep.
- Configurable fields: Group JID, Contact Phone, and Action (
addto join orremoveto kick). - VIP Membership Example: Lead buys a course in GHL ➡️ Add to VIP WhatsApp group. Lead cancels subscription or requests refund ➡️ Remove from group automatically.
🪝 Available Custom Triggers
Trigger real-time GoHighLevel automations based on WhatsApp events:
| Trigger | When it Fires | Payload Variables Provided |
|---|---|---|
Connect - WhatsApp Message Receivedwhatsapp_inbound |
Fires every time a customer sends a direct 1-on-1 WhatsApp message. |
• message: Incoming text.• phone: Contact phone number.• contactId: GoHighLevel Contact ID.• mediaUrl / attachments: Received files.
|
Connect - Group Message Receivedgroup_message_inbound |
Fires every time any member posts a message inside a synced WhatsApp group. |
• groupJid: WhatsApp Group ID.• groupName: Group display name.• participantPhone: Real phone of the member.• participantName: WhatsApp profile name of the sender.• message: Message content.
|
Connect - Button / List Clickedbutton_clicked |
Fires when a contact taps an interactive quick reply button or selects a list row. |
• buttonId: Button ID clicked.• buttonText: Selected button text.
|
Connect - Voice Note Receivedvoice_received |
Fires specifically when a contact sends an audio voice note. |
• mediaUrl: Audio file for AI transcription.• duration: Voice note duration.
|
💡 Practical Workflow Examples in GoHighLevel
Action 1: Connect - Send WhatsApp Message with catalog PDF.
Action 2: Connect - Internal Notification to the assigned rep.
Action 1: Connect - Change Group Participant (add to VIP group).
Action 2: Connect - Send Group Message welcoming the new student.
Action: Connect - Send AI Voice Note personally greeting the contact by their first name.
❓ Preguntas Frecuentes (FAQ)
❓ Frequently Asked Questions
🔧 Solución de Problemas (Troubleshooting)
1. Verifica en tu WhatsApp móvil en Ajustes > Dispositivos vinculados que la sesión no haya sido cerrada manualmente.
2. Haz clic en el botón "Reconectar" en la tarjeta del dispositivo para restablecer el canal de socket.
3. Si la sesión fue cerrada en el celular, pulsa "Desvincular" y genera un nuevo código o QR.
Asegúrate de que el número del contacto en GoHighLevel contenga el código de país internacional correcto (por ejemplo,
+591... para Bolivia, +52... para México, +1... para EE. UU.).
🔧 Troubleshooting
1. Open WhatsApp on your mobile > Settings > Linked Devices and check if the session was closed manually.
2. Click "Reconnect" on the device card in Connect to refresh the socket.
3. If the session was logged out from the phone, click "Unlink" and generate a fresh pairing code or QR.
Ensure the contact's phone number in GoHighLevel includes the correct international country code (e.g.
+1... for USA, +52... for Mexico, +591... for Bolivia).
📞 Contactar con Soporte Técnico
¿Tienes alguna duda con la configuración de tu subcuenta o necesitas asistencia personalizada para tu equipo? Nuestro equipo técnico está listo para ayudarte.
📞 Contact Technical Support
Have questions about setting up your subaccount or need personalized onboarding for your team? Our technical engineers are ready to help.