Conecta tu cuenta de GoHighLevel

Paso 1 — Crea la conexión en Calligence

Inicia sesión en Calligence y abre Integraciones en el menú lateral. Pulsa + Crear 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.
• Mapeo de campos (avanzado, opcional) — solo si además de la etiqueta quieres el resultado en un campo personalizado de tus contactos. El formato que Calligence lee es exactamente este: {"status": "<id del campo personalizado en GHL>"}, el mismo que verás de ejemplo en el formulario. Si no lo necesitas, déjalo vacío: las etiquetas de resultado se sincronizan igual.

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

Paso 2 — Crea el token en GoHighLevel

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 exactamente estos dos: View Contacts y Edit Contacts. 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.

Paso 3 — Asocia la conexión a una campaña y copia tu URL

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.

Paso 4 — Configura el workflow en GoHighLevel

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.

Paso 5 — Prueba el circuito completo

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ó.

Detener llamadas desde tu CRM

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.