Conectar tu CRM (OAuth)

La conexión con tu CRM es lo que convierte GodSetter de un marcador en una máquina de agendar citas: el CRM (GoHighLevel) es donde viven tus contactos, tus calendarios y tus citas. GodSetter se conecta a él mediante OAuth — autorizas una sola vez a nivel de agencia, sin claves API que pegar — y a partir de ahí tus subcuentas entran automáticamente como clientes.

Paso 1 — Inicia el flujo OAuth

Abre Conexiones y busca la tarjeta GoHighLevel («CRM — contactos, calendarios, reservas.»). Haz clic en «Conectar GoHighLevel». Te llevará a la pantalla de consentimiento del Marketplace.

Iniciar el flujo requiere acceso de editor en el área Conexiones: el propietario, un admin o un colaborador al que un admin le haya dado derechos de editor.

Paso 2 — Elige la cuenta de tu agencia

Accede en la pantalla de consentimiento si se te pide. Cuando el Marketplace pregunte en qué cuenta instalar, elige la cuenta de tu agencia, no una subcuenta individual. La conexión debe ser a nivel de agencia para que GodSetter pueda ver todas tus subcuentas; una instalación limitada a una sola ubicación se rechaza y no se guarda nada.

Después aprueba los permisos solicitados: contactos, calendarios, campos personalizados y el resto de capacidades que GodSetter usa para agendar citas y devolver los datos de las llamadas al CRM.

Paso 3 — Verifica la conexión

Vuelves redirigido a la página Conexiones:

• Éxito → «GoHighLevel conectado correctamente.» y el estado de la tarjeta pasa a conectado.
• Fallo → «La conexión con GoHighLevel falló. Vuelve a intentarlo.» La causa más habitual es haber elegido una subcuenta en lugar de la agencia en el paso anterior: vuelve a hacer clic en «Conectar GoHighLevel» y elige la cuenta de agencia.

Paso 4 — Importa tus subcuentas

Una vez conectado, tus subcuentas del CRM se importan automáticamente una vez al día como clientes. No tienes que esperar a que ocurra: abre Clientes y haz clic en «Sincronizar subcuentas» para importarlas de inmediato.

Mientras no hayas importado nada, la página Clientes encabeza con «Importa las subcuentas desde GoHighLevel» y el botón Sincronizar subcuentas en lugar de una tabla vacía: tus clientes ya existen en el CRM, así que importarlos es la forma normal de crearlos.

Cuando creas un cliente a mano, el formulario lista tus ubicaciones de GoHighLevel y los calendarios de esa ubicación en dos selectores — nunca pegas ids, salvo que GoHighLevel no esté conectado o no responda: en ese caso el formulario vuelve a los ids manuales y te dice por qué.

Los clientes importados llegan activos y sin calendario propio: reservan en el calendario predeterminado del agente que los llama (editor del agente → Identidad y enrutamiento), buscado por nombre en cada subcuenta — una sola elección cubre a todos los clientes del mismo snapshot. Abre un cliente solo para darle un calendario distinto, o para desactivarlo. Un cliente aparece «por configurar» solo cuando no tiene calendario y ningún agente saliente activo tiene uno predeterminado.

A partir de aquí la conexión se mantiene al día con GoHighLevel por sí sola, sin esperar el pase diario y sin conectar ningún workflow: una subcuenta nueva se importa como cliente en cuanto la creas, una renombrada se renombra también aquí, y una eliminada o que desinstala la app se desactiva (su ficha, sus leads y su historial de llamadas se conservan, y las llamadas que quedaban en cola para ella se descartan). Lo mismo con los contactos: si cambias el teléfono, el nombre o la zona horaria de un contacto en el CRM, el lead se actualiza solo — una llamada que ya estaba en cola marca el número corregido, no el que traía cuando nació.

Cuándo hay que reconectar

Los permisos que lleva tu conexión quedan congelados en el momento del consentimiento. Si más adelante GodSetter añade funciones que necesitan permisos nuevos, tu conexión existente no los tendrá hasta que vuelvas a dar el consentimiento: usa «Reconectar GoHighLevel» en la misma tarjeta para ejecutar el flujo otra vez y recoger los permisos nuevos. Reconectar no afecta a tus clientes importados ni a tu historial de llamadas.

Hay un segundo motivo, y este te viene a buscar: tu Panel muestra «Conexión con GoHighLevel interrumpida - reconéctala desde Conexiones» bajo Atención requerida. GodSetter lo levanta cuando ha intentado renovar el token de tu CRM y GoHighLevel lo ha rechazado — normalmente porque la app se desinstaló de la cuenta de agencia, se revocó la autorización, o el token guardado ya no es válido.

Hay una tercera señal, y es la más rápida: si la app se elimina en GoHighLevel, es GoHighLevel quien avisa a GodSetter de inmediato — no hay que esperar a que falle la siguiente renovación del token. La tarjeta pasa a no conectado y tu Panel muestra «La app de GodSetter fue eliminada de GoHighLevel - vuelve a conectarla desde Conexiones» bajo Atención requerida. Cuando es una sola subcuenta la que elimina la app, solo se desactiva ese cliente: su ficha, sus leads y su historial de llamadas se quedan donde están, listos para una reinstalación.

Hasta que reconectes:

• Las llamadas en curso no se interrumpen, y el marcador sigue llamando para los clientes que tienen calendario propio.
• Todo lo que toca el CRM falla: reservar, cancelar y reprogramar durante la llamada, las etiquetas de resultado y las notas, el write-back posterior a la llamada en los custom fields, y la importación diaria de subcuentas.
• Los clientes sin calendario propio — los que reservan en el calendario predeterminado del agente que llama, buscado por nombre dentro de la subcuenta — no pueden resolver ningún calendario, así que sus leads se aparcan y se reintentan en lugar de marcarse.

Se arregla con el mismo botón: «Reconectar GoHighLevel» en la tarjeta de Conexiones, eligiendo otra vez la cuenta de agencia. Dos cosas que no hay que malinterpretar: la tarjeta sigue diciendo conectado (las credenciales están guardadas, es GoHighLevel quien las rechaza), y el banner no es un piloto en tiempo real — desaparece 24 horas después del último fallo y las repeticiones están limitadas, así que confirma la reparación con una reserva real o un lead de prueba, no viendo desaparecer el banner.

Próximos pasos

1. Conecta el workflow de tu CRM a un agente — la configuración que realmente pone en marcha las llamadas.
2. La lista de onboarding explicada — comprueba en qué punto estás en conjunto.