HighLevel | ElevenLabs Documentation

HighLevel también se conoce como GoHighLevel, y su API funciona con el nombre LeadConnector. Con una herramienta webhook, tu recepcionista puede guardar a cada persona que llama como contacto en tu subcuenta de HighLevel. Si quien llama ya es un contacto, HighLevel actualiza el registro existente en lugar de crear un duplicado.

Configuración

Crea un token de integración privada

En tu subcuenta de HighLevel, abre Settings → Private Integrations y selecciona Create New Integration. Ponle un nombre, selecciona solo los permisos para ver y editar contactos, y créala. Copia el token de inmediato: HighLevel solo lo muestra una vez.

Si Private Integrations no aparece en tu configuración, pide al administrador de tu agencia que te dé acceso.

Busca tu ID de ubicación

Abre Settings → Business Profile en la misma subcuenta y copia el Location ID.

Crea la herramienta webhook

En Reception.ai, ve a Integrations, selecciona Add integration y elige Webhook Tool.

Campo	Valor
Nombre	`save_highlevel_contact`
Descripción	”Guarda a quien llama como contacto en nuestro CRM cuando sepas su nombre y número de teléfono. Úsala en todas las llamadas de clientes nuevos o recurrentes.”
Método	POST
URL	`https://services.leadconnectorhq.com/contacts/upsert`
Encabezados de la solicitud	`Authorization`: `Bearer` seguido de tu token `Version`: `2021-07-28`
Parámetros del cuerpo	`locationId` (cadena, obligatorio): “Siempre el valor exacto `LOCATION_ID`.” `firstName` (cadena, obligatorio): “El nombre de quien llama.” `lastName` (cadena): “El apellido de quien llama, si lo ha dado.” `phone` (cadena, obligatorio): “El número de teléfono de quien llama en formato internacional; por ejemplo, +14155550123.” `email` (cadena): “La dirección de correo electrónico de quien llama, si la ha dado.” `source` (cadena, obligatorio): “Siempre el valor exacto `Reception.ai phone call`.”
Asignar a agentes	Receptionist

Sustituye LOCATION_ID por el ID que copiaste. Selecciona Enable.

Pruébala

Prueba tu recepcionista con una llamada en la que des tu nombre y número. El contacto aparecerá en HighLevel, en Contacts. Vuelve a llamar con el mismo número: HighLevel actualizará ese contacto en lugar de añadir uno nuevo.

El token puede leer y modificar tus contactos. No lo incluyas en documentos compartidos y elimina la integración privada en HighLevel si se filtra.

HighLevel determina si quien llama ya es un contacto mediante el ajuste Allow Duplicate Contact de la subcuenta. Si ese ajuste busca coincidencias tanto por correo electrónico como por teléfono, los comprueba en el orden indicado en el ajuste.

Para hacer más cosas después de una llamada, como abrir una oportunidad o avisar a tu equipo, crea un workflow de HighLevel que empiece con el activador Inbound Webhook. Dirige una segunda herramienta webhook a la URL del workflow con los campos que necesites y, después, asigna esos campos dentro del workflow. Considera la URL del workflow como un secreto. HighLevel indica que Inbound Webhook es un activador prémium, así que consulta tu plan para conocer los cargos por uso.

Limitaciones

El servidor MCP de HighLevel requiere iniciar sesión con OAuth, algo que Reception.ai no admite, así que usa la herramienta webhook.
Las etiquetas y los campos personalizados son listas en la API de HighLevel, y las herramientas webhook envían valores simples. Configúralos mediante un workflow.
Añadir notas o tareas requiere el ID del contacto en la URL, que una herramienta webhook no puede completar durante una llamada. Usa un workflow Inbound Webhook para ello.

Resolución de problemas

Problema	Qué comprobar
401 de HighLevel	El encabezado `Authorization` debe ser `Bearer` seguido del token, con un espacio después de `Bearer`.
403 de HighLevel	El token necesita los permisos de contacto y `locationId` debe ser la subcuenta en la que se creó el token.
HighLevel rechaza la versión	El encabezado `Version` debe ser exactamente `2021-07-28`. Si la documentación de la API de HighLevel indica un valor obligatorio más reciente, usa ese.
Se duplican quienes vuelven a llamar	Comprueba el ajuste Allow Duplicate Contact y que los números de teléfono se guarden con el mismo formato internacional.
El contacto no tiene nombre	Haz que la descripción de la herramienta indique a la recepcionista que pida el nombre de quien llama antes de guardarlo.