> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryvo.so/llms.txt
> Use this file to discover all available pages before exploring further.
# Conectar GoHighLevel
> Conecta tu subcuenta de GoHighLevel para que tu agente busque contactos, agende citas, mande mensajes y abra oportunidades.
GoHighLevel es la integración más completa de Ryvo y también la única que pide un paso extra. Bien conectada, tu agente trabaja dentro de tu CRM mientras habla: encuentra al contacto por su teléfono, agenda la cita en tu calendario, deja la nota de lo que acordaron y abre la oportunidad en tu embudo.
Mal conectada, la tarjeta dice **Conectada** y tu agente no puede agendar. Por eso esta guía insiste tanto en el paso 5.
GoHighLevel es la **única** app del catálogo que te pide datos después del OAuth. Si cierras ese modal sin llenar la **Subcuenta**, la acción «Agendar una cita» ni siquiera aparece en el constructor. No es un error que veas: simplemente no está.
## Qué necesitas antes de empezar
* Una cuenta de **GoHighLevel** y, sobre todo, un usuario que **pertenezca a la subcuenta** que quieres usar. Un usuario de agencia no sirve, y más abajo se explica por qué.
* El **id de tu subcuenta** (el *Location ID*). Lo vas a teclear a mano, así que tenlo a la mano antes de empezar. Está en GoHighLevel, en **Settings › Business Profile**.
* Plan **Starter** o superior, con el módulo Engine activo.
* Si vas a usar oportunidades, ten claro en qué **embudo** deben caer.
## Cómo conectarla
En el portal, entra a **Configuración** y después a **Integraciones**. Busca la tarjeta de **GoHighLevel**.
Se abre la pantalla de GoHighLevel en una ventana nueva.
En la pantalla de GoHighLevel, selecciona la subcuenta que quieres que use tu agente e inicia sesión con un usuario de esa subcuenta. Este es el punto donde más conexiones se rompen: lee la sección «Por qué la agencia no sirve» antes de autorizar si tienes dudas.
Al terminar regresas solo a la pantalla de Integraciones y la tarjeta pasa a **Conectada**.
Justo al volver se abre el modal **Lo que GoHighLevel necesita de ti**. Ahí va lo importante, y está explicado en la siguiente sección. Si le das **Más tarde**, la pantalla te deja un aviso con un botón **Completar** para retomarlo.
## La configuración de GoHighLevel, campo por campo
Tu agente no puede adivinar estos datos a media llamada, y el modelo nunca los ve: los guardas una vez y viajan solos en cada llamada a GoHighLevel.
Es el id de la subcuenta de GoHighLevel donde vive tu CRM. Es el **único** dato que tienes que ir a buscar, porque el proveedor de la conexión nos lo entrega recortado y no podemos leerlo completo.
**Dónde lo encuentras**: en GoHighLevel, entra a la subcuenta, abre **Settings** y después **Business Profile**. El **Location ID** aparece en esa pantalla y se copia con un clic. También lo ves en la barra de direcciones cuando navegas dentro de la subcuenta, en la parte que dice `/location//`.
Pégalo tal cual, sin espacios.
En cuanto la Subcuenta está puesta, este campo deja de estar gris y se llena con **tus calendarios reales**, por nombre. Elige el calendario en el que tu agente debe agendar.
Sin este dato no hay «Buscar horarios libres» ni «Agendar una cita».
Igual que el calendario: sale de tu propia cuenta en cuanto hay Subcuenta. Elige el embudo donde deben caer las oportunidades nuevas.
Sólo lo necesitas si vas a usar las acciones de oportunidades. Mientras esté vacío, esas acciones no se ofrecen.
Da **Guardar**. Guardar también actualiza los agentes que ya usan esta integración, así que no tienes que volver a publicarlos por esto.
Después puedes cambiar cualquiera de los tres desde **Configuración › Integraciones › GoHighLevel › Ver acciones**: los mismos campos están arriba de la lista de acciones, y cada acción que todavía no se puede usar te dice exactamente qué le falta.
## Por qué la agencia no sirve
GoHighLevel entrega dos clases de acceso y sólo una funciona para lo que tu agente necesita:
* Si quien autoriza pertenece a la **subcuenta**, el acceso puede leer contactos, calendarios, conversaciones y oportunidades. Es el bueno.
* Si quien autoriza es un **usuario de agencia**, GoHighLevel entrega un acceso de agencia. Con él, todos los endpoints de subcuenta responden «no permitido»: ni un contacto, ni un calendario, ni una conversación.
Ryvo lo detecta al volver del OAuth y no te deja creer que quedó bien: la tarjeta pasa a **Error** y dice, con todas sus letras, que vuelvas a conectar desde un usuario que pertenezca a la subcuenta. Esto no se arregla cambiando nada en Ryvo, hay que rehacer la conexión desde el usuario correcto.
## Lo que tu agente puede hacer ya conectada
**Contactos**
| Acción | Qué hace en la conversación |
| ----------------------------------------- | ------------------------------------------------------------------------------ |
| **Buscar contacto por teléfono o correo** | Encuentra a la persona al inicio de la llamada para saber si ya es cliente. |
| **Crear o actualizar contacto** | Guarda a la persona en el CRM. Si ya existe la actualiza, así que no duplica. |
| **Ver un contacto** | Lee la ficha completa para confirmar datos antes de cambiarlos. |
| **Etiquetar contacto** | Marca el resultado de la conversación, por ejemplo interesado o no contesta. |
| **Quitar etiquetas** | Quita etiquetas que dejaron de aplicar. |
| **Dejar una nota en el contacto** | Escribe lo que acordaron, para quien dé seguimiento después. |
| **Ver tareas del contacto** | Lista los pendientes abiertos cuando la persona pregunta en qué va su trámite. |
**Agenda**
| Acción | Qué hace en la conversación | Necesita |
| --------------------------------- | ------------------------------------------------------------------- | ---------------------- |
| **Buscar horarios libres** | Consulta qué huecos hay antes de proponer una cita. | Calendario |
| **Agendar una cita** | Reserva la cita después de ver el hueco libre. | Calendario y Subcuenta |
| **Reagendar o cancelar una cita** | Mueve la hora de una cita que ya existe, o la cancela. | |
| **Ver citas del contacto** | Lista las citas de una persona, para confirmarle cuándo es la suya. | |
| **Consultar la agenda** | Lee todo lo agendado en un rango de fechas. | Subcuenta |
**Conversaciones**
| Acción | Qué hace en la conversación | Necesita |
| ----------------------- | -------------------------------------------------------------------------------------------------------------- | --------- |
| **Enviar mensaje** | Manda un SMS, correo, WhatsApp, RCS, Instagram o Facebook al contacto, para confirmar por escrito lo acordado. | |
| **Buscar conversación** | Encuentra conversaciones previas, para saber si ya se le había contactado. | Subcuenta |
| **Leer mensajes** | Retoma el hilo sin pedirle a la persona que repita. | |
**Oportunidades**
| Acción | Qué hace en la conversación | Necesita |
| ---------------------------------- | --------------------------------------------------------------------- | ------------------ |
| **Crear o actualizar oportunidad** | Abre la oportunidad cuando la persona muestra intención de compra. | Subcuenta y Embudo |
| **Ver oportunidad** | Lee en qué etapa va antes de moverla. | |
| **Cerrar oportunidad** | La marca como ganada, perdida o abandonada al cerrar la conversación. | |
Las acciones se encienden una por una en la sección [**Tools**](/es/guides/agents/tools) del constructor de cada agente, con un tope de **10 acciones de integración por agente**. En la lista de **Ver acciones**, las que todavía les falta un dato aparecen marcadas con **Falta un dato** y te dicen cuál.
## Qué hacer si algo falla
| Lo que ves | Qué pasó | Qué hacer |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| La tarjeta dice **Conectada** pero «Agendar una cita» no aparece en el constructor | Falta la **Subcuenta** o el **Calendario** | Entra a **Ver acciones** y llena los campos de arriba. La acción aparece en cuanto guardas |
| La tarjeta pasa a **Error** y habla de una cuenta de agencia | Autorizaste con un usuario de agencia, no de la subcuenta | Da **Reconectar** y autoriza con un usuario que pertenezca a la subcuenta que quieres usar |
| El desplegable de **Calendario** no carga nada | La **Subcuenta** está vacía o el id está mal escrito | Revisa el Location ID en GoHighLevel, en Settings › Business Profile, y pégalo de nuevo sin espacios |
| Reconectaste con otro usuario y todo siguió igual de roto | Le diste **Reconectar** sobre una conexión que seguía marcada como activa | Da **Desconectar** primero y después **Conectar app**: así el OAuth arranca de cero |
| Las acciones de oportunidades no se ofrecen | Falta el **Embudo** | Llénalo en **Ver acciones**. Sólo las de oportunidades dependen de él |