> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar GoHighLevel

> Conecta una o más Locations de GoHighLevel, dirige oportunidades abiertas a Nexor y sincroniza los resultados terminales configurados.

Conecta GoHighLevel para traer oportunidades elegibles a Nexor mediante un webhook en tiempo real o una revisión programada. Cada fuente puede dirigirse a un Agente y los resultados terminales configurados pueden actualizar la oportunidad en GoHighLevel.

<Frame caption="Pantalla de conexión de GoHighLevel observada en staging el 7 de septiembre de 2026.">
  <img src="https://mintcdn.com/nexor/7_xWfOhMNwV0KbZa/images/integrations/gohighlevel-connect-staging-2026-09-07.png?fit=max&auto=format&n=7_xWfOhMNwV0KbZa&q=85&s=7552c41f88cef654709d16963273e95c" alt="Pantalla de la integración GoHighLevel desconectada en staging de Nexor" width="1395" height="768" data-path="images/integrations/gohighlevel-connect-staging-2026-09-07.png" />
</Frame>

<Info>
  La cuenta de documentación de staging no tenía una Location de GoHighLevel conectada. Este recorrido confirma solo el formulario de conexión vacío. Las pantallas conectadas de subcuentas, routing, Auto-sync, webhook y resultados se verificaron contra el código actual del producto, pero no se pudieron capturar de forma segura en staging.
</Info>

## Qué permite la integración

| Área                   | Comportamiento actual                                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Conexiones             | Conectar más de una subcuenta. Cada conexión representa una Location de GoHighLevel.                                |
| Entrada en tiempo real | Un Workflow de GoHighLevel envía una oportunidad a una URL de Custom Webhook generada por Nexor.                    |
| Entrada programada     | Cuando está habilitado para la cuenta, Auto-sync revisa oportunidades abiertas elegibles cada 10 minutos.           |
| Routing                | Dirigir una fuente a un Agente activo, omitirla o usar una ruta predeterminada.                                     |
| Pausa y reanudación    | Pausar una ruta guardada sin borrarla. La pausa se aplica a la entrada por webhook y a la programada para esa ruta. |
| Salida                 | Mapear resultados terminales de Nexor a un status, una stage o ambos en GoHighLevel.                                |

Esto no es un espejo continuo de todos los objetos o stages de GoHighLevel. La salida actual se ejecuta para los resultados terminales configurados.

## Antes de conectar

Necesitas el **Location ID** y un **Private Integration Token** de la Location. Crea el token en **GoHighLevel Settings → Private Integrations** y trátalo como un secreto.

<Warning>
  Los permisos que muestra la pantalla actual de conexión en Nexor no son una lista completa de configuración. El importador activo también lee contactos y campos personalizados. Confirma con Nexor los permisos vigentes antes de crear el token. No uses la captura como una lista exhaustiva de scopes.
</Warning>

## Conectar una Location

<Steps>
  <Step title="Crea una integración privada">
    En la Location correcta de GoHighLevel, abre **Settings → Private Integrations**. Crea una integración privada con los permisos confirmados para las funciones que se usarán.
  </Step>

  <Step title="Copia las credenciales una vez">
    Copia el Location ID y el Private Integration Token. No publiques el token en capturas, tickets ni documentos compartidos.
  </Step>

  <Step title="Conecta en Nexor">
    Ve a **Integraciones → GoHighLevel**, ingresa el Location ID y el token, y selecciona **Conectar**.
  </Step>

  <Step title="Agrega otra subcuenta si hace falta">
    Después de la primera conexión, usa **Agregar subcuenta** para conectar otra Location. El selector de subcuentas aparece cuando existen dos o más conexiones.
  </Step>
</Steps>

## Dirigir las oportunidades entrantes

Abre **Entradas → Enrutamiento de leads**. Configura cada fuente con uno de estos destinos:

* Un **Agente** activo que debe recibir las oportunidades elegibles.
* **No importar** cuando la fuente deba quedar fuera de Nexor.
* La ruta predeterminada para fuentes que no coincidan con una regla específica guardada.

El routing por pipeline es el camino base. La interfaz también puede mostrar fuentes de Workflows de GoHighLevel observadas en tráfico reciente del webhook. Algunas conexiones antiguas podrían no tener habilitado el routing por fuente de Workflow. Confirma que esté activo antes de depender de esas rutas.

### Webhook en tiempo real

Abre **Webhook en tiempo real**, copia la URL generada y agrégala como una acción **Custom Webhook** dentro del Workflow correspondiente de GoHighLevel.

<Warning>
  La URL del webhook contiene un token de entrada. Trata la URL completa como un secreto y nunca la publiques en una captura o ejemplo.
</Warning>

### Pausar una ruta

Desactiva **Aceptando leads** en una ruta guardada para pausarla sin borrar su configuración. La ruta pausada deja de aceptar entradas del webhook en tiempo real y de Auto-sync. Vuelve a activarla para reanudar.

## Configurar Auto-sync

Cuando está habilitado para la cuenta, Auto-sync revisa oportunidades abiertas cada 10 minutos. Selecciona pipelines que ya dirijan a un Agente activo, limita las stages si hace falta y define un corte con zona horaria.

* Solo son elegibles las oportunidades con status `open`.
* Un scope guardado admite hasta 20 pipelines y 200 stages.
* Dejar las stages vacías incluye todas las stages elegibles de los pipelines seleccionados.
* Desactivar Auto-sync conserva el webhook y el scope guardado.

El backfill histórico cubre oportunidades elegibles anteriores al corte de la sincronización recurrente. Los leads del backfill se crean sin Agente ni cadencia, por lo que ejecutar un backfill no inicia el contacto.

## Sincronizar resultados terminales

Abre **Salidas → Sincronización de resultados**, elige un Agente y mapea cada resultado terminal deseado a un status, una stage o ambos en GoHighLevel.

Este camino solo escribe las transiciones terminales configuradas. No copia de forma continua stages intermedias, notas, llamadas ni reuniones.

## GoHighLevel como proveedor de booking

La API de Nexor reconoce GoHighLevel como proveedor externo de booking, pero el dashboard actual no ofrece una configuración self-service verificada que coincida con las tools obligatorias de crear, reprogramar y cancelar que exige la API.

Usa una configuración asistida o mediante API para booking con GoHighLevel. No interpretes la tarjeta **Herramientas de GoHighLevel** como una pantalla completa de configuración del proveedor de booking.

## Solución de problemas

<AccordionGroup>
  <Accordion title="Una ruta no recibe oportunidades">
    Confirma que la ruta esté asignada a un Agente activo y que **Aceptando leads** esté habilitado. Una ruta pausada bloquea la entrada por webhook y la programada.
  </Accordion>

  <Accordion title="Auto-sync no importa una oportunidad">
    Confirma que la oportunidad esté abierta, que su pipeline tenga una ruta activa, que su stage esté dentro del scope y que su fecha corresponda a la configuración recurrente. Las oportunidades históricas anteriores al corte pertenecen al camino de backfill.
  </Accordion>

  <Accordion title="No se aplica una ruta por fuente de Workflow">
    Algunas conexiones antiguas podrían no tener habilitado el routing por fuente de Workflow. Pide a Nexor que confirme que está activo antes de depender de esa fuente.
  </Accordion>
</AccordionGroup>
