Conecta tu cuenta de GoHighLevel

Inicia sesión en Calligence y abre Integraciones en el menú lateral. Pulsa + Nueva conexión y rellena el formulario:

• Nombre — un nombre para identificarla en la lista, por ejemplo GHL — cuenta principal.
• Proveedor — GoHighLevel.
• Token — el token de integración privada que crearás en el paso 2. Puedes dejar la ventana abierta y volver aquí con el token copiado. Se cifra en el servidor y no se vuelve a mostrar.
• Location ID — el identificador de tu sub-cuenta en GoHighLevel. Lo encuentras en la URL del navegador dentro de tu sub-cuenta: es el código que aparece justo después de /location/. Tiene que ser la misma sub-cuenta en la que crearás el token del paso 2: Calligence lo comprueba al guardar.
• Calendario de citas (opcional) — el ID del calendario de GoHighLevel donde quieres que Calligence cree las citas que tu agente acuerde por teléfono. Déjalo vacío si no quieres citas; puedes configurarlo más adelante desde la lista de Integraciones, en el menú ⋯ (Más acciones) de la conexión → Calendario. Detalles y requisitos en la sección Citas en tu calendario.

Deberías ver la conexión en la lista, con estado activo y el token enmascarado (solo los últimos 4 caracteres).

Qué lee el agente de cada contacto se configura después, sobre la conexión ya creada: en la lista de Integraciones, abre el menú ⋯ de la conexión y pulsa Mapeo. Ahí indicas de qué campo sale el producto por el que se interesó el contacto (su nombre y, si lo tenéis, su código) y qué otros campos debe conocer el agente, con el nombre con el que los recibirá. En GoHighLevel los campos personalizados viajan identificados por su id, nunca por su nombre, así que es el id lo que hay que escribir. Solo llegan al agente los campos que nombres; el resto del contacto no sale de GHL. Déjalo vacío si no lo necesitas: el contacto se llama igual.

El campo personalizado donde escribimos el resultado de la llamada es otra cosa y no se configura desde ahí: dinos el id del campo (status en nuestra configuración) y lo dejamos puesto nosotros. Si no lo pides, las etiquetas de resultado se sincronizan igual.

Dentro de tu sub-cuenta de GoHighLevel:

1. Ve a Settings → Private Integrations. Si no ves esa opción, actívala primero en Settings → Labs.
2. Pulsa Create new Integration y ponle un nombre, por ejemplo Calligence.
3. En los permisos (scopes), marca estos dos: View Contacts y Edit Contacts. Si además vas a usar las citas en tu calendario, marca también los permisos de eventos de calendario (View Calendar Events y Edit Calendar Events). No necesita ningún otro permiso.
4. Crea la integración y copia el token ahora — GoHighLevel solo lo muestra una vez.

Vuelve a Calligence y pega el token (y el Location ID) en el formulario del paso 1. Al guardar, Calligence comprueba las credenciales contra GoHighLevel antes de crear nada: si el token no es válido, ha caducado o pertenece a otra sub-cuenta distinta de la del Location ID, verás un error en el formulario y la conexión no se creará. Si todo encaja, la verás creada y activa en la lista de Integraciones.

En Calligence, abre Campañas y crea una campaña nueva (o edita una existente). En el campo Conexión (CRM), selecciona la conexión que acabas de crear y guarda.

Al guardar, Calligence te muestra la URL de webhook de esa campaña — "Conexión asociada. Pega esta URL en tu workflow de GoHighLevel" — con un botón Copiar. Si editas la campaña más adelante, la misma URL aparece como URL actual.

• Cada campaña tiene su propia URL: los contactos que lleguen por ella entran en esa campaña. Si usas varias campañas, repite este paso en cada una.
• La URL es permanente — no cambia aunque edites la campaña. Solo cambia si la rotas a propósito o si desvinculas la conexión (Editar → Desvincular): eso la anula y, si vuelves a vincularla, la campaña recibe una URL nueva.

De vuelta en tu sub-cuenta de GoHighLevel:

1. Ve a Automation → Workflows y crea un workflow nuevo.
2. Como disparador (trigger), añade Contact Tag con la condición Tag added y una etiqueta dedicada, por ejemplo calligence. Así controlas exactamente qué contactos entran en la campaña: etiquetas un contacto, y Calligence le llama.
3. Añade una acción de tipo Webhook, método POST, y pega en el campo URL la URL de tu campaña (paso 3). No necesitas configurar cabeceras ni cuerpo: el envío estándar del webhook ya incluye la información del contacto que Calligence necesita.
4. Guarda y — esto es lo que más se olvida — publica el workflow (Publish). En borrador, el botón de prueba funciona, pero los contactos reales no disparan nada.

Deberías ver el workflow como Published en la lista de workflows.

La mejor prueba es una de verdad, contigo al otro lado del teléfono:

1. Crea en GoHighLevel un contacto de prueba con tu propio móvil en formato internacional, por ejemplo +34600111222.
2. Añádele la etiqueta del workflow (calligence). El workflow se dispara y envía el contacto a Calligence.
3. En Calligence, abre la campaña: deberías ver el contacto como lead en unos segundos.
4. Espera la llamada. Se realiza dentro de la ventana horaria configurada en tu organización y en la disponibilidad del lead — si estás fuera de ventana, quedará programada.
5. Al terminar la llamada, abre el contacto en GoHighLevel: deberías ver la nota Calligence — resumen de la llamada: en su timeline y, si el lead quedó cerrado, la etiqueta Calligence: … con el resultado.

Si algo no cuadra, GoHighLevel te dice mucho: abre el workflow y mira sus Execution Logs — ahí verás si el webhook se disparó y qué respondió.

Si un lead se resuelve por otra vía — el comercial lo cerró por teléfono, la oportunidad se ganó o se cerró en GoHighLevel — puedes avisar a Calligence desde ese mismo workflow para que no siga llamando. Al recibir el aviso, Calligence:

• Deja de llamar a ese lead — cancela cualquier intento de llamada pendiente.
• Lo marca como "Trabajado fuera" — un estado neutro: no cuenta como éxito ni como fracaso. Los minutos ya consumidos en llamadas previas sí se facturan.
• Escribe una nota de confirmación en la ficha del contacto: "Calligence dejó de llamar a este lead." (si añades un motivo, también aparece ahí).

De vuelta en tu sub-cuenta de GoHighLevel:

1. Ve a Automation → Workflows y crea un workflow nuevo (o edita uno existente).
2. Como disparador (trigger), usa el que marque para ti el cierre del lead — por ejemplo Opportunity Status Changed a Ganado o Cerrado.
3. Añade una acción de tipo Webhook, método POST, y pega en el campo URL la URL para DETENER llamadas — tu URL de campaña (paso 3) con /stop-lead al final. Nunca la URL de inscripción.
4. Opcional: añade un campo de Custom Data llamado reason con el motivo del cierre, por ejemplo Cerrado por el comercial. Se muestra como Motivo en Calligence y en la nota del CRM — máximo 64 caracteres, si escribes más se recorta.
5. Guarda y publica el workflow (Publish). En borrador no se dispara con contactos reales.

El aviso es idempotente: repetirlo no hace nada nuevo. Si el lead ya había llegado a un estado final por su cuenta — éxito, no interesado o inválido — su estado no cambia; "Trabajado fuera" solo se aplica a leads que seguían activos.

Esto no es una lista de exclusión permanente: detiene la llamada dentro de la campaña actual. Si más adelante vuelves a subir el mismo contacto a una campaña nueva, Calligence le llamará de nuevo.

Cuando tu agente de Calligence acuerda una cita con el cliente — día y hora concretos, o «lo antes posible» — por teléfono o por WhatsApp, Calligence puede crearla como cita real en un calendario de GoHighLevel, igual que si la añadieras a mano con "Add appointment". Y aquí está la gracia: quién atiende esa cita lo decide tu CRM, no Calligence. Si el calendario es de tipo round-robin, GoHighLevel reparte cada cita automáticamente entre los comerciales del calendario; para cambiar el reparto (altas, bajas, vacaciones) editas el calendario en GoHighLevel y ya está. Si es un calendario personal (o de cualquier otro tipo), la cita se asigna a la persona que tiene ese calendario. Los dos casos funcionan: elige el que encaje con cómo trabajáis.

1. En GoHighLevel, crea (o elige) el calendario donde quieres las citas y copia su ID de calendario (en los ajustes del propio calendario, dentro de Calendars → Calendar Settings). Vale cualquier tipo: uno Round Robin con tus comerciales como miembros si quieres reparto automático, o uno personal si las citas son siempre para la misma persona. Copia el ID del calendario, no el de un grupo de calendarios — en esa pantalla aparecen juntos y es la confusión más habitual.
2. Asegúrate de que tu token de integración privada tiene los permisos de eventos de calendario (View/Edit Calendar Events, paso 2). Si tu token es anterior a esta función, edita sus permisos en Settings → Private Integrations — o crea uno nuevo y actualízalo en Calligence con Rotar token, en el menú ⋯ de la conexión. Añade también View Calendars: Calligence lo usa para comprobar el ID cuando lo guardas y para saber a quién asignar la cita: en un calendario que no es Round Robin, o en uno con un solo miembro, la cita va a esa persona. Sin ese permiso GoHighLevel puede rechazar las citas en esos calendarios.
3. En Calligence, abre Integraciones y, en el menú ⋯ de tu conexión, pulsa Calendario (o rellena el campo al crearla). Pega el ID y guarda. Al guardar, Calligence le pregunta a GoHighLevel si ese calendario existe y pertenece a esta sub-cuenta: si no lo reconoce, verás el error en el formulario y el calendario no se guardará. Para desactivar las citas, deja el campo vacío y guarda.

A partir de ahí, cada vez que una llamada termine con una cita acordada verás en GoHighLevel una cita titulada Cita Calligence — {nombre del cliente} (o Cita Calligence a secas si no conocemos su nombre) sobre ese contacto, a la hora acordada, con el resumen de la llamada en la descripción (empieza por "Cita agendada por Calligence en una llamada.").