> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convertixapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Kommo

> Guía simple para conectar Kommo con Convertix (token y webhooks).

Kommo es un CRM para gestionar clientes y mensajes. Esta guía explica cómo conectar Kommo con Convertix de forma simple usando un token de larga duración y webhooks.

Realizarás 3 pasos:

* Crear una integración privada en Kommo
* Crear una integración en Convertix para Kommo
* Configurar webhooks (notificaciones) de Kommo hacia Convertix (**IMPORTANTE: Hace falta tener una cuenta paga de Kommo para poder hacer esto**)

Tiempo estimado: 2-5 minutos.

## Crear una integración privada en Kommo

<Note>
  Necesitas permisos de administrador en Kommo.
</Note>

<Steps>
  <Step title="Ir a Integraciones y crear una integración">
    Inicia sesión como administrador. Ve a Settings (Configuración) → Integrations (Integraciones) y haz clic en "Create integration".

    <img src="https://mintcdn.com/convertix/PiZQniSN7gKQ4eeM/images/kommo/kommo-integration-1.gif?s=9454c792c244625badb222847d4d6e66" alt="Kommo integración paso 1" title="Kommo integración paso 1" style={{ width:"78%" }} width="600" height="302" data-path="images/kommo/kommo-integration-1.gif" />
  </Step>

  <Step title="Elegir tipo Private (si aplica)">
    Si usas una cuenta técnica, elige el tipo "Private" para crear una integración privada.

    <img src="https://mintcdn.com/convertix/PiZQniSN7gKQ4eeM/images/kommo/kommo-integration-2.png?fit=max&auto=format&n=PiZQniSN7gKQ4eeM&q=85&s=5831553591ca4db2d5d925b7f62efe70" alt="Kommo integración paso 2" title="Kommo integración paso 2" style={{ width:"78%" }} width="694" height="552" data-path="images/kommo/kommo-integration-2.png" />
  </Step>

  <Step title="Completar propiedades">
    Completa el formulario:

    * Nombre: "Convertix"
    * Descripción: "Integración con la plataforma Convertix"
    * Permisos (scopes): "Access to account data" y "Access to files"
    * Icono: opcional
    * Redirect URL: dejar en blanco
    * Access revoked notification webhook: dejar en blanco
    * Duplicate control / Multiple sources: dejar en blanco (si aparece)

    <img src="https://mintcdn.com/convertix/PiZQniSN7gKQ4eeM/images/kommo/kommo-integration-filled-app.png?fit=max&auto=format&n=PiZQniSN7gKQ4eeM&q=85&s=b267ad8e41057ea9b9d31f0f5d3bd386" alt="Kommo integración paso 3" title="Kommo integración paso 3" style={{ width:"78%" }} width="922" height="697" data-path="images/kommo/kommo-integration-filled-app.png" />

    Haz clic en "Save" y verás la integración creada.

    <img src="https://mintcdn.com/convertix/PiZQniSN7gKQ4eeM/images/kommo/kommo-integration-saved-app.png?fit=max&auto=format&n=PiZQniSN7gKQ4eeM&q=85&s=fa1bb1df372a7e485fcb6b828f1f5b6d" alt="Kommo integración paso 4" title="Kommo integración paso 4" style={{ width:"78%" }} width="928" height="611" data-path="images/kommo/kommo-integration-saved-app.png" />
  </Step>

  <Step title="Obtener token de larga duración">
    En la pestaña "Keys and scopes", haz clic en "Generate long-lived token".

    <img src="https://mintcdn.com/convertix/PiZQniSN7gKQ4eeM/images/kommo/kommo-integration-long-lived-token.png?fit=max&auto=format&n=PiZQniSN7gKQ4eeM&q=85&s=019a974202b6291ce78a7ac9dab7f291" alt="Kommo integración paso 5" title="Kommo integración paso 5" style={{ width:"78%" }} width="922" height="611" data-path="images/kommo/kommo-integration-long-lived-token.png" />

    Elige la vigencia (de 1 día a 5 años) y copia el token. Sugerimos un token con al menos 1 año de vigencia.
  </Step>
</Steps>

<Warning>
  Guarda el token en un lugar seguro. No podrás verlo nuevamente después de crearlo. No lo compartas.
</Warning>

## Crear una Integración en Convertix para Kommo

Antes de empezar, asegúrate de haber hecho el paso anterior. Vas a necesitar:

* Subdominio
* Token de larga duración (long-lived token)

<Steps>
  <Step title="Abrir Integraciones en Convertix">
    En Convertix, ve a Integraciones.

    <img src="https://mintcdn.com/convertix/PiZQniSN7gKQ4eeM/images/kommo/kommo-convertix-integration-1.png?fit=max&auto=format&n=PiZQniSN7gKQ4eeM&q=85&s=88d895cbe2e8503454af5ff5281fd8db" alt="Kommo → Convertix paso 1" title="Kommo → Convertix paso 1" style={{ width:"78%" }} width="1919" height="471" data-path="images/kommo/kommo-convertix-integration-1.png" />
  </Step>

  <Step title="Crear integración y pegar datos">
    Crea una nueva integración con Kommo y pega el subdominio y el token que obtuviste en el paso anterior.

    <img src="https://mintcdn.com/convertix/PalgtURwPPZ4_NYG/images/WhatsAppImage2026-02-03at12.46.34.jpeg?fit=max&auto=format&n=PalgtURwPPZ4_NYG&q=85&s=77c1e0184bdc0ad08d44afc9919510fa" alt="Whats App Image2026 02 03at12 46 34" title="Whats App Image2026 02 03at12 46 34" style={{ width:"75%" }} width="1600" height="1005" data-path="images/WhatsAppImage2026-02-03at12.46.34.jpeg" />

    <img src="https://mintcdn.com/convertix/PiZQniSN7gKQ4eeM/images/kommo/kommo-convertix-integration-2.png?fit=max&auto=format&n=PiZQniSN7gKQ4eeM&q=85&s=d16778f39e4ad8aa1507aa8200734850" alt="Kommo → Convertix paso 2" title="Kommo → Convertix paso 2" style={{ width:"78%" }} width="579" height="348" data-path="images/kommo/kommo-convertix-integration-2.png" />

    <Note>
      Subdominio: si tu URL es acme.kommo.com, tu subdominio es "acme".
    </Note>
  </Step>

  <Step title="Guardar y copiar URL de webhook">
    Después de guardar, Convertix te mostrará una URL. Úsala en el próximo paso.

    <img src="https://mintcdn.com/convertix/n2chrkAeN-Dp1liM/images/kommo/kommo-convertix-integration-3.png?fit=max&auto=format&n=n2chrkAeN-Dp1liM&q=85&s=cd9afb79f49218870c419dc66d4cced5" alt="Kommo → Convertix paso 3" title="Kommo → Convertix paso 3" style={{ width:"78%" }} width="2514" height="1024" data-path="images/kommo/kommo-convertix-integration-3.png" />
  </Step>

  <Step title="Agregar números de WhatsApp">
    Agrega los números de WhatsApp que deseas conectar.

    <img src="https://mintcdn.com/convertix/n2chrkAeN-Dp1liM/images/kommo/kommo-convertix-integration-4.png?fit=max&auto=format&n=n2chrkAeN-Dp1liM&q=85&s=abfefbe47c5fc6998816debf8b25a144" alt="Kommo → Convertix paso 4" title="Kommo → Convertix paso 4" style={{ width:"78%" }} width="2514" height="1024" data-path="images/kommo/kommo-convertix-integration-4.png" />

    <Warning>
      Muy importante: este número tiene que estar conectado en Kommo, si no las métricas no funcionarán.
    </Warning>
  </Step>

  <Step title="Activar la línea">
    Hacemos clic en "Activar".

    <img src="https://mintcdn.com/convertix/n2chrkAeN-Dp1liM/images/kommo/kommo-convertix-integration-9.png?fit=max&auto=format&n=n2chrkAeN-Dp1liM&q=85&s=b7dd976b9953c0a92bad1d0d64bf8e6d" alt="Kommo → Convertix paso 9" title="Kommo → Convertix paso 9" style={{ width:"78%" }} width="982" height="1070" data-path="images/kommo/kommo-convertix-integration-9.png" />

    <Note>
      Si la línea no está activa, la landing no redirigirá a los leads a los números de WhatsApp.
    </Note>
  </Step>
</Steps>

<Note>
  <ul>
    <li>Convertix distribuye los leads entre todos los números de WhatsApp conectados. </li>
    <li>Si la misma persona entra más de una vez a la misma landing page, Convertix la considerará el mismo lead y, cuando sea posible, la redirigirá al mismo número de WhatsApp.</li>
  </ul>
</Note>

## Configurar webhooks (notificaciones) en Kommo hacia Convertix

Convertix usa estas notificaciones para:

* Crear leads en el momento en que llegan.
* Leer comprobantes de pago recibidos.
* Actualizar el monto de venta en Kommo según los comprobantes de pago.
* Tener métricas claras de chats y conversiones en Convertix.

<Steps>
  <Step title="Abrir Webhooks">
    Ve a Settings → Integrations → Web hooks.
  </Step>

  <Step title="Agregar webhook">
    Pega la URL de Convertix y selecciona el evento "Incoming message received".
  </Step>

  <Step title="Probar">
    Envía un mensaje de prueba y verifica que el lead aparezca en Convertix.
  </Step>
</Steps>

<Note>
  Convertix solo trackea leads enviados desde la landing al WhatsApp. Mensajes iniciados manualmente no se trackean.
</Note>