> For the complete documentation index, see [llms.txt](https://prometheo.gitbook.io/prometheo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prometheo.gitbook.io/prometheo/integraciones/kommo.md).

# Kommo

Kommo es un CRM que podés conectar con Prometheo para gestionar tus leads directamente desde las conversaciones que entran por tus canales.

***

### Qué podés hacer con esta integración

* Crear leads en Kommo desde Prometheo
* Actualizar información de leads existentes
* Asociar un tag de Prometheo con un pipeline y estado de Kommo
* Apagar el bot automáticamente cuando se alcance un tag específico
* Enviar atributos adicionales a la ficha del lead o del contacto en Kommo
* Mover leads entre pipelines dentro de Kommo

***

### Cómo funciona la lógica general

La integración no actúa sola. Funciona a partir de los tags que configurás en Prometheo.

1. El lead escribe por WhatsApp, Instagram, Facebook u otro canal conectado.
2. El asistente conversa y Prometheo clasifica la conversación.
3. Cuando esa conversación alcanza un tag específico, se dispara la acción hacia Kommo.
4. Prometheo crea o actualiza el lead en Kommo.
5. Ese lead se guarda en el pipeline y estado que hayas configurado.

{% hint style="warning" %}
**La clave está en los tags**

Sin una lógica de clasificación bien definida, la integración no va a funcionar como esperás. Antes de conectar, definí qué tag va a disparar cada acción.
{% endhint %}

***

### Qué tenés que definir antes de conectarlo

#### 1. Qué conversaciones querés mandar a Kommo

Ejemplos:

* Solo consultas comerciales
* Solo leads calientes
* Solo quienes piden presupuesto
* Solo quienes quieren agendar
* Todos los leads nuevos

#### 2. Qué tag va a disparar la acción

Ejemplos:

* Nuevo lead
* Interesado
* Solicitud de presupuesto
* Visita agendada
* Oportunidad calificada

#### 3. En qué pipeline de Kommo va a entrar

Ejemplos:

* Pipeline Ventas
* Pipeline Postventa
* Pipeline Soporte
* Pipeline Reservas

#### 4. En qué estado de ese pipeline se va a guardar

{% hint style="warning" %}
El estado tiene que existir previamente en Kommo. Prometheo no lo crea: lo selecciona sobre algo que ya esté configurado.
{% endhint %}

Ejemplo: si en Kommo tenés el pipeline "Ventas" con estados como *Nuevo contacto*, *Contactado*, *Interesado*, *Propuesta enviada* o *Cerrado*, Prometheo va a guardar el lead en el estado que vos elijas — pero ese estado ya tiene que estar creado.

***

### Cómo se configura paso a paso

**Paso 1 — Conectar Kommo con Prometheo**

Para conectar tu cuenta de Kommo necesitás ingresar los siguientes datos:

* **Subdominio** — Es la parte de tu URL de Kommo antes de `.kommo.com`. Por ejemplo, si tu cuenta es `miempresa.kommo.com`, el subdominio es `miempresa`.
* **Integration ID** — Lo encontrás dentro de Kommo en **Configuración → Integraciones → tu integración → pestaña Keys & Scopes**.
* **Secret** — En la misma pantalla que el Integration ID.
* **Access Token** — También en la sección de integraciones de Kommo. Puede requerirse generarlo manualmente según el tipo de acceso configurado.

{% hint style="info" %}
Si no encontrás estos datos, revisá que tengas permisos de administrador dentro de tu cuenta de Kommo. Sin esos permisos, es posible que no veas la sección de integraciones.
{% endhint %}

***

**Paso 2 — Definir la lógica en Prometheo**

Indicale a Prometheo qué tag va a disparar la acción sobre Kommo.

***

**Paso 3 — Asociar tags con pipelines y estados**

Una vez conectado, podés configurar qué pasa en Kommo cuando se alcanza un tag en Prometheo. Para cada tag podés definir:

* **Pipeline** — A qué pipeline de Kommo se manda el lead.
* **Estado** — En qué estado dentro de ese pipeline cae el lead.
* **Apagar el bot** — Podés indicar si querés que el asistente se apague automáticamente cuando esa conversación llegue a ese tag.

Ejemplo de configuración:

| Tag en Prometheo     | Pipeline en Kommo | Estado en Kommo     | Apagar bot |
| -------------------- | ----------------- | ------------------- | ---------- |
| Lead calificado      | Ventas            | Nuevo ingreso       | No         |
| Solicita presupuesto | Oportunidades     | Propuesta pendiente | Sí         |
| Listo para cierre    | Ventas            | Cierre              | Sí         |

{% hint style="warning" %}
El pipeline y el estado tienen que existir previamente en Kommo. Prometheo no los crea: los selecciona sobre lo que ya esté configurado.
{% endhint %}

***

**Paso 4 — Configurar atributos adicionales**

Prometheo te permite enviar información de variables de la conversación directamente a Kommo. Esto es útil para completar la ficha del lead o del contacto con datos que el asistente haya recolectado.

Para cada atributo podés definir:

* **Qué variable** de Prometheo querés compartir.
* **Dónde mostrarlo en Kommo** — En la ficha del **Lead** o en la ficha del **Contacto**.

Una vez que definís los atributos, guardás la configuración y esa información va a viajar a Kommo cada vez que se dispare la integración.

{% hint style="success" %}
**Ejemplo de uso**

Si el asistente recolecta el nombre, el teléfono y el producto de interés del usuario, podés mapear esas variables para que aparezcan directamente en la ficha del contacto dentro de Kommo, sin tener que cargarlas a mano.
{% endhint %}

***

**Paso 5 — Probar el flujo**

Hacé una prueba real desde un canal conectado y verificá:

* que se asigne bien el tag
* que se cree o actualice el lead en Kommo
* que entre en el pipeline correcto
* que caiga en el estado correcto
* que los atributos adicionales lleguen a la ficha correspondiente
* que el bot se apague si así lo configuraste

***

### Crear vs. actualizar un lead

| Situación                      | Qué hace Prometheo       |
| ------------------------------ | ------------------------ |
| El contacto no existe en Kommo | Lo crea como nuevo lead  |
| El contacto ya existe en Kommo | Actualiza su información |

Esto evita duplicados y le da continuidad al historial del lead dentro de Kommo.

***

### Ejemplos de uso

#### Caso 1 — Ventas simples

El asistente atiende consultas, detecta intención de compra y aplica el tag `Interesado`. Prometheo crea el lead en el pipeline `Ventas` con estado `Nuevo lead`.

#### Caso 2 — Leads calificados

El asistente hace preguntas de precalificación. Si el usuario cumple ciertas condiciones, aplica el tag `Lead calificado`. Prometheo crea o actualiza el lead en el pipeline `Oportunidades` con estado `Calificado`.

#### Caso 3 — Distintos momentos del embudo

Podés usar tags distintos para diferentes etapas del proceso comercial:

* `Pidió catálogo`
* `Quiere llamada`
* `Solicita presupuesto`
* `Listo para cierre`

Cada tag puede mapear a una etapa distinta en Kommo, según cómo tengas configurado tu proceso.

***

### Qué revisar en Kommo antes de conectarlo

* Que tengas creados los pipelines que vas a usar
* Que los estados dentro de esos pipelines ya existan
* Que estén bien ordenados según tu proceso comercial
* Que tengas claro qué tag de Prometheo va a impactar en cada etapa

***

### Ventajas de integrar Kommo con Prometheo

1. **Orden comercial** — Los leads no quedan solo en el chat. Pasan también a tu CRM.
2. **Menos carga manual** — Si el tag se asigna automáticamente, no tenés que pasar leads a mano.
3. **Mejor seguimiento** — Tu equipo comercial trabaja desde Kommo con una estructura más clara.
4. **Actualización de leads** — No solo crea nuevos, también actualiza los existentes.
5. **Alineación entre conversación y CRM** — La conversación en Prometheo alimenta tu operación comercial.

***

### Cómo empezar sin complicarte

{% hint style="success" %}
**Recomendación para arrancar**

Empezá con un flujo simple antes de complejizar la lógica:

* **Tag en Prometheo:** `Lead calificado`
* **Pipeline en Kommo:** `Ventas`
* **Estado en Kommo:** `Nuevo ingreso`

Cuando confirmes que el flujo funciona bien, podés sumar más tags, pipelines y estados.
{% endhint %}