> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# HighLevel

HighLevel también se conoce como GoHighLevel, y su API funciona con el nombre LeadConnector. Con una [herramienta webhook](/docs/es/reception-ai/integrations/webhooks), 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](/docs/es/reception-ai/receptionist/testing) 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.

> **Warning**
>
> 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.

> **Tip**
>
> 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.                                |