# Kommo

Conecta Kommo (amoCRM) para que el agente reconozca a quien llama por su teléfono, cree contactos y leads, y registre cada llamada como nota

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Kommo (amoCRM) se conecta con un token de larga duración de una integración privada que creas en tu cuenta. Una vez vinculado, el agente saluda por su nombre a los clientes conocidos teniendo a mano su último lead, crea un contacto y un lead cuando alguien deja una solicitud, y escribe el resultado de cada llamada en la ficha del cliente.

## Qué puede hacer el agente [#what-the-assistant-can-do]

* **Reconocer a quien llama**: al inicio de una llamada busca el número de teléfono en Kommo y obtiene el nombre, email y empresa del contacto, y su último lead (nombre, etapa, presupuesto).
* **Crear un lead**: encuentra el contacto por teléfono o crea uno nuevo, y luego crea un lead en el pipeline y la etapa que elijas. La solicitud, la dirección de entrega, los productos y el anuncio que trajo al cliente van al lead como nota.
* **Registrar llamadas**: tras cada llamada añade una nota al lead abierto del cliente (o al contacto): dirección, duración, resultado, resumen, el enlace a la grabación y, si quieres, la transcripción completa.

## Antes de empezar [#before-you-start]

* **Administrador de Kommo**: solo un administrador puede crear el token.
* **Espacio de trabajo de HAPP** con al menos un agente.
* **Kommo activado para tu espacio de trabajo**: la integración se activa por empresa. Pide al soporte de HAPP que la active.

## Crear el token [#create-the-token]

1. En Kommo abre **Settings > Integrations** y haz clic en **Create integration**.
2. Elige una integración privada, ponle el nombre `HAPP` y guarda. La Redirect URL y el webhook de revocación pueden quedar vacíos.
3. En la pestaña **Keys and scopes** haz clic en **Generate long-lived token**, elige la caducidad (hasta 5 años) y copia el token: Kommo lo muestra solo una vez.

## Conectar [#connect]

1. En HAPP abre **Integraciones** y busca Kommo en **Añadir un CRM**.
2. Haz clic en **Conectar**, introduce la dirección de tu cuenta (`acme`, `acme.kommo.com` o la dirección `amocrm.ru`) y pega el token.
3. Kommo aparece en **Mis integraciones** con el nombre de tu cuenta.

## Configuración [#settings]

Abre el icono de engranaje de la tarjeta en la pestaña **Integraciones** del agente.

* **Buscar**: reconocer a quien llama por su teléfono.
* **Crear**: leads. Elige el **pipeline**, la **etapa** y el **responsable**; sin ellos, el lead va a tu pipeline principal, primera etapa. **Incoming leads**, **Closed – won** y **Closed – lost** no se ofrecen como etapa.
* **Notas de llamada**: una nota tras cada llamada. **Transcripción completa** añade el texto de la conversación.

## Límites [#limits]

* Kommo guarda los números de teléfono tal como se escribieron; el agente compara los últimos 9 dígitos, así que `050 111 22 33` y `+380501112233` son el mismo cliente.
* Un número que no está en Kommo no recibe nota de llamada: no hay registro al que adjuntarla.
* El token deja de funcionar en la fecha de caducidad que elegiste: genera uno nuevo antes.

## Solución de problemas [#troubleshooting]

| Problema                                                       | Causa                                                           | Solución                                                                       |
| -------------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| "Enter the Kommo account address, e.g. acme or acme.kommo.com" | La dirección no es de una cuenta de Kommo o amoCRM              | Copia la dirección del navegador mientras estás en Kommo.                      |
| "Kommo account not found"                                      | Error tipográfico en la dirección                               | Comprueba la dirección de la cuenta.                                           |
| "Kommo: the token is invalid or expired"                       | El token caducó o se eliminó la integración                     | Genera un nuevo token de larga duración y vuelve a hacer clic en **Conectar**. |
| "Kommo: the account is not paid"                               | La suscripción terminó: Kommo cierra la API                     | Renueva la suscripción.                                                        |
| "Kommo: no access"                                             | El usuario del token perdió permisos o la cuenta está bloqueada | Genera el token como administrador.                                            |

## Desconectar [#disconnect]

Desconecta la tarjeta en HAPP y elimina la integración privada en **Settings > Integrations**. Los contactos, leads y notas que ya están en Kommo se mantienen.

## Siguiente [#next]

* [CRM](/docs/integrations/crm): todas las integraciones de CRM
* [Herramientas](/docs/agents/tools): lo que el agente llama durante las conversaciones