# Kommo

## ¿Qué es Kommo?

Kommo (antes amoCRM) es un CRM de ventas pensado para vender por chat y por teléfono, con embudos, etapas y tareas para el equipo comercial. La integración con Anunzi hace que todo lo que hablan tus agentes —de voz y de WhatsApp— quede en tu Kommo, y que tus agentes puedan trabajar sobre tu CRM durante la conversación.

La integración está **incluida** en Anunzi y tiene **dos partes complementarias**:

1. **Sincronización automática:** cada llamada y cada conversación de tus agentes aparece en Kommo como contacto, lead y nota, sin que el agente tenga que hacer nada.
2. **Funciones de agente:** el agente busca y guarda contactos, deja notas, etiqueta, abre leads, los mueve de etapa, crea tareas y agenda citas en Kommo mientras conversa.

***

## Parte 1 — Sincronización automática

### Llamadas de voz

Al terminar cada llamada de un agente de voz:

1. Anunzi busca el **contacto** en Kommo por su teléfono. Si no existe, lo crea.
2. Usa el **lead abierto** del contacto o, si no tiene uno, crea un lead nuevo en el embudo y la etapa que elegiste.
3. Registra la **llamada en el historial** del lead, con su duración, el resumen de la conversación y la **grabación**, que se escucha desde Kommo con el botón **Escuchar** (sin entrar a Anunzi).
4. Agrega una **nota** con los datos que extrajo el agente, la transcripción (si la activaste) y un enlace a la llamada en el panel de Anunzi.
5. Etiqueta el contacto y el lead (por ejemplo, «Llamada entrante» o «Llamada saliente»).

> Las llamadas de prueba desde el navegador («Probar agente de voz») no tienen número de teléfono. En ese caso Anunzi usa el teléfono, el email o el nombre que el agente haya extraído durante la conversación; si no hay ninguno, la llamada no se envía a Kommo.

### Conversaciones de WhatsApp

Cuando una conversación de WhatsApp queda **quieta** (30 minutos sin mensajes, o el tiempo que elijas), Anunzi agrega los mensajes nuevos como una **nota** en el lead del contacto, indicando quién dijo cada cosa: el contacto, el agente de IA o un asesor de tu equipo. Cada mensaje se envía una sola vez: si la conversación sigue otro día, solo se agregan los mensajes nuevos.

> Este envío se hace cada 10 minutos, así que la nota puede tardar unos minutos en aparecer después de que la conversación queda quieta.

### Nuevo contacto de WhatsApp

La primera vez que alguien escribe a tu agente de WhatsApp, Anunzi crea el **contacto** en Kommo. Si lo eliges, también le abre un lead.

### Lead de WhatsApp calificado

Cuando el agente de WhatsApp termina de calificar a un contacto, Anunzi crea o actualiza el **contacto**, abre su **lead** (o usa el que ya tenía) y agrega una **nota** con los datos capturados.

***

## Parte 2 — Funciones de agente

Además de la sincronización, puedes activar funciones de Kommo en un agente —de voz o de WhatsApp— para que consulte y escriba en tu CRM **durante la conversación**. Se activan desde la ficha del agente → **Funciones del agente** → **+ Agregar función** → pestaña **CRM** → grupo **Kommo**. La función para agendar citas está en la pestaña **Citas**.

Las funciones se activan **una por una**: elige solo las que necesitas.

| Función                     | Qué hace                                                                                  |
| --------------------------- | ----------------------------------------------------------------------------------------- |
| `kommo_buscar_contacto`     | Busca al contacto por teléfono o email y devuelve su lead abierto, con el embudo y la etapa |
| `kommo_guardar_contacto`    | Crea o actualiza el contacto (nombre, teléfono, email, etiquetas) sin duplicarlo           |
| `kommo_agregar_nota`        | Deja una nota en el lead abierto del contacto (o en el contacto, si no tiene lead)          |
| `kommo_agregar_etiqueta`    | Agrega una o más etiquetas al lead del contacto, sin borrar las que ya tenía              |
| `kommo_crear_lead`          | Abre un lead en el embudo (si el contacto ya tiene uno abierto, no crea otro)              |
| `kommo_mover_etapa`         | Mueve el lead a otra etapa, **por nombre**                                                 |
| `kommo_crear_tarea`         | Crea una tarea de seguimiento para tu equipo (si no se indica fecha, para mañana a las 10:00) |
| `kommo_agendar_cita`        | Agenda una cita como tarea de **reunión** en Kommo, con fecha, hora y duración             |

> 💡 **`kommo_mover_etapa` funciona por nombre.** El agente puede decir «Negociación» o «negociacion» (sin importar tildes ni mayúsculas) y la integración busca la etapa en tus embudos reales. Si no encuentra ninguna parecida, el agente recibe la lista de etapas disponibles.
>
> 💡 **Las fechas se toman en la zona horaria de tu cuenta de Kommo.** Si el agente agenda una cita para las 15:30, en Kommo aparece a las 15:30 de tu zona horaria.
>
> 💡 **Kommo no tiene un calendario con disponibilidad.** `kommo_agendar_cita` crea la reunión en el día y la hora que acordó el agente, pero no revisa si ese horario está libre. Si necesitas ofrecer solo horarios disponibles, combínala con la Agenda de Citas de Anunzi o con Google Calendar.

**Requisito:** la integración de Kommo debe estar conectada en **Integraciones** para que las funciones del agente funcionen. El agente usa la misma conexión, el embudo y el responsable que configuraste ahí.

***

## Cómo activarla

En este video te mostramos el paso a paso completo: crear la integración en Kommo, conectarla en Anunzi y activar las funciones del agente.

{% embed url="https://www.youtube.com/watch?v=GUlJb-8pfbk" %}

### 1. Crea una integración privada en Kommo

Lo hace un **administrador** de tu cuenta de Kommo.

1. En Kommo, ve a **Ajustes** → **Centro de integraciones**.
2. Pulsa **+ Crear integración** (arriba a la derecha).
3. Completa el formulario:

| Campo                                          | Qué poner                                                                 |
| ---------------------------------------------- | ------------------------------------------------------------------------- |
| **URL de redireccionamiento**                  | La dirección de tu panel, por ejemplo `https://panel.anunzi.net`. Kommo la pide, pero esta conexión no la usa |
| **Acceso webhook de notificación revocada**    | Déjalo vacío                                                              |
| **Permitir acceso**                            | Deja marcado **Todos**                                                    |
| **Subir / Integración con código personalizado** | No subas nada                                                           |
| **Control de duplicados** y **Fuentes múltiples** | Déjalos sin marcar                                                     |
| **Nombre de integración**                      | Por ejemplo, `Anunzi`                                                     |
| **Descripción**                                | Por ejemplo, `Agentes de IA de Anunzi`                                    |

4. Pulsa **Guardar**.
5. Abre la integración. Si no se abre sola, está en **Centro de integraciones**, en la sección **Integración privada**.
6. Ve a la pestaña **Llaves y alcances** y pulsa **Generar token de larga duración**. Elige el vencimiento más lejano que te permita (hasta 5 años).
7. Copia el token.

> Guarda el token en ese momento: Kommo lo muestra una sola vez. Si lo pierdes o vence, genera uno nuevo y vuelve a pegarlo en Anunzi.

### 2. Conéctala en Anunzi

1. En el panel, ve a **Integraciones** → **Kommo**.
2. Completa la **Conexión**:

| Campo                         | Descripción                                                    | Ejemplo        |
| ----------------------------- | -------------------------------------------------------------- | -------------- |
| **Subdominio**                | Lo que va antes de `.kommo.com` en la dirección de tu cuenta   | `miempresa`    |
| **Token de larga duración**   | El token que generaste en Kommo                                 | `eyJ0eXAi...`  |

3. Pulsa **Probar conexión**. Si todo está bien, la conexión queda guardada y la pantalla carga tus embudos, etapas, usuarios y campos de Kommo.
4. En **Leads**, elige el **Embudo** y la **Etapa inicial** donde se crearán los leads, y si quieres que se cree un lead cuando el contacto no tiene uno abierto.
5. En **Responsable y etiquetas**, elige el usuario de Kommo que quedará como responsable de lo que cree Anunzi y, si quieres, cambia las etiquetas de llamada entrante, llamada saliente y WhatsApp.
6. _(Opcional)_ En **Campos personalizados**, envía los datos que extraen tus agentes a campos de Kommo: a la izquierda escribe el nombre del dato en el agente (por ejemplo, `motivo_llamada`) y a la derecha elige el campo de Kommo. El teléfono, el email y el nombre se cargan solos; no hace falta mapearlos.
7. En **Agentes**, marca los agentes cuyas llamadas y conversaciones quieres en Kommo. Si no marcas ninguno, se usan todos.
8. En **¿Qué se manda a Kommo?**, activa lo que quieras enviar: llamadas de voz, conversaciones de WhatsApp, nuevo contacto de WhatsApp y lead de WhatsApp calificado. También eliges si las notas de las llamadas llevan la transcripción.
9. Pulsa **Guardar configuración**.

***

## ¿Qué se puede hacer en Kommo y qué no?

| Qué                              | Disponible | Notas                                                                     |
| -------------------------------- | :--------: | ------------------------------------------------------------------------- |
| Contactos                        | ✅         | Buscar (por teléfono o email), crear, actualizar, etiquetar                |
| Leads                            | ✅         | Crear, mover de etapa (por nombre), etiquetar                              |
| Llamadas en el historial         | ✅         | Con duración, resumen y grabación para escuchar desde Kommo               |
| Notas                            | ✅         | Datos, transcripción y conversaciones de WhatsApp                         |
| Tareas y reuniones               | ✅         | Seguimiento y citas, en la zona horaria de tu cuenta                      |
| Campos personalizados            | ✅         | Del lead o del contacto: texto, número, fecha, casilla y listas           |
| Disponibilidad de agenda         | ❌         | Kommo no tiene calendario con disponibilidad; usa la Agenda de Citas o Google Calendar |
| Chat de WhatsApp dentro de Kommo | ❌         | Por ahora las conversaciones llegan como nota en el lead                  |

***

## Que el agente llame a tus leads desde Kommo

Hay dos formas:

* **El widget de Anunzi** (recomendado): tus vendedores piden a un agente que llame o escriba sin salir de Kommo, y también puedes usarlo en las automatizaciones del embudo y en Salesbot. Ver abajo.
* **El enlace del agente**: en las automatizaciones de una etapa, agrega la acción de webhook con el enlace. Anunzi toma el teléfono del contacto de tu Kommo conectado. Ver [Llamar con un agente desde otras apps](llamar-desde-otras-apps.md).

### El widget de Anunzi

En este video te mostramos cómo instalar el widget y cómo usarlo (es la continuación del video de conexión).

{% embed url="https://www.youtube.com/watch?v=ih_JLd-eFDY" %}

| Dónde | Qué puedes hacer |
| --- | --- |
| **Ficha del lead, del contacto o de la empresa** (columna derecha) | Llamar o escribir ahora, programar un seguimiento, sumar a una campaña y ver qué pasó con ese lead en Anunzi. |
| **Al hacer clic en un teléfono** | **Llamar con agente** a ese número. |
| **Lista de leads o de contactos** (marca varios y pulsa **Más**) | Lo mismo para todos los marcados a la vez. |
| **Automatizaciones del embudo** | Una acción propia **Anunzi: agente de IA** en la etapa: llamar o escribir (en el momento o un tiempo después) o sumar a una campaña. |
| **Salesbot** | Los pasos **Anunzi: llamar o escribir con un agente** y **Anunzi: sumar a una campaña**. |

* **Llamar o escribir ahora:** el agente contacta a la persona en el momento. En los agentes de WhatsApp sale la plantilla que elegiste en su ficha.
* **Programar un seguimiento:** el agente la contacta en el momento que elijas (en 1 hora, mañana a las 9, en una semana…). Puedes agregar un **motivo**: el agente lo recibe como `{{motivo}}`. Mientras no salga, puedes cancelarlo desde la ficha del lead.
* **Sumar a una campaña:** el lead entra a una campaña tuya con origen **Ingesta dinámica** (por ejemplo, una campaña en modo IA que hace el seguimiento por WhatsApp y llamada).

El widget muestra los agentes que tienen activo **Llamar desde otras apps** en su ficha (en los de WhatsApp, con la plantilla elegida). Cada llamada o mensaje respeta los límites del agente y tiene el costo normal. Las automatizaciones del embudo y Salesbot dependen de tu plan de Kommo.

#### Cómo instalarlo

Lo hace un **administrador** de Kommo, con Kommo ya conectado en Anunzi:

1. En Anunzi, entra en **Integraciones → Kommo** y pulsa **Descargar el widget**. Es un archivo `.zip`: no lo descomprimas.
2. En Kommo, abre **Ajustes → Centro de integraciones**, entra en la integración privada que creaste para Anunzi y pulsa **Editar**.
3. En **Subir / Integración con código personalizado**, sube el archivo y guarda.
4. Abre la integración de nuevo y pulsa **Instalar**. No hace falta completar la clave: ya viene incluida en el archivo.

> 🔒 El archivo incluye una clave de tu cuenta. Si crees que se filtró, pulsa **Cambiar la clave del widget** en Integraciones → Kommo y sube el archivo nuevo: el anterior deja de funcionar.

En Salesbot, escribe el **nombre del agente** (o de la campaña) tal como figura en Anunzi. En **Cuándo**, `0` es ahora, o puedes poner minutos (`30`), horas (`2h`) o días (`1d`).

***

## Preguntas frecuentes

**¿Necesito activar las dos partes?**\
No. Puedes usar solo la sincronización automática o sumarle funciones de agente en los agentes que quieras. Las funciones de agente requieren que la integración esté conectada.

**¿Qué pasa si el contacto ya existe en Kommo?**\
Anunzi lo encuentra por su teléfono (aunque esté escrito con otro formato, con o sin código de país) o por su email, y lo actualiza sin crear un duplicado. Si tiene un lead abierto, usa ese.

**¿Qué pasa si la misma llamada se envía dos veces?**\
No se duplica: cada llamada se registra una sola vez en Kommo.

**¿Dónde escucho la grabación?**\
En el historial del lead, en la llamada, con el botón **Escuchar**. El enlace es privado de esa llamada y no requiere entrar a Anunzi.

**¿Por qué no veo una conversación de WhatsApp en Kommo?**\
La conversación se envía cuando lleva 30 minutos sin mensajes (o el tiempo que configuraste), y el envío se hace cada 10 minutos. Revisa también que el agente esté marcado en **Agentes** y que **Conversaciones de WhatsApp** esté activado.

**¿Qué pasa si vence el token?**\
Kommo deja de aceptar los envíos. Genera un token nuevo en la integración privada (pestaña **Llaves y alcances**) y pégalo en **Integraciones → Kommo**.

**¿Qué pasa si falla el envío a Kommo?**\
La llamada o la conversación se guarda igualmente en Anunzi. El error queda registrado en los registros internos del sistema.