Guía de Conexión: Kommo + n8n
Desarrollador: Ing. Raúl De Jesús Villanueva Méndez
Especialidad: Automatización, Desarrollo Web y Backend (10 años de experiencia).
Esta guía detalla el flujo de integración para capturar mensajes entrantes de Kommo y procesarlos a través de flujos de trabajo en n8n.
1. Acceso a la Plataforma
Para iniciar, es indispensable contar con credenciales de administrador en la cuenta de Kommo del cliente. Una vez dentro, sitúate en el panel principal para visualizar las opciones de configuración de la cuenta.
2. Configuración del Webhook en n8n
Antes de configurar Kommo, debemos preparar el receptor en n8n:
- Crea un nuevo flujo en n8n y añade un nodo Webhook.
- Configura el método (usualmente
POST). - Importante: Copia la URL de producción. Evita usar la URL de test para la implementación final, ya que esta solo funciona cuando el nodo está en modo de escucha manual.
3. Vinculación del Webhook en Kommo
Dirígete a la interfaz de integraciones de Kommo y localiza el campo de Webhooks:
- Pega la URL de producción obtenida en n8n.
- Selecciona el activador (Trigger):
Mensaje entrante recibido. - Al activar este evento, Kommo enviará automáticamente un paquete de datos a n8n cada vez que un cliente escriba.
Identificación de Datos Relevantes
Al recibir la información en n8n, los campos clave para mapear son:
chat_id: El identificador único de la conversación en Kommo.text: El contenido textual del mensaje enviado por el cliente.entity_id: El ID del pipeline (embudo). Representa la columna o etapa específica donde se encuentra el lead, funcionando como un indicador de estatus dentro del proceso de ventas.
4. Restricciones de Mensajería (Nota Importante)
Kommo presenta limitaciones críticas en la recepción de mensajes mediante bots que deben gestionarse en n8n para evitar errores de entrega:
- Emojis: No se pueden enviar emojis en la respuesta del bot. Si el mensaje contiene un emoji, el texto se truncará (se cortará) en ese punto, entregando un mensaje incompleto.
- Saltos de línea: En ciertos casos, los saltos de línea provocan el mismo error de truncado.
- Segmentación: Kommo no permite enviar múltiples mensajes fragmentados de forma consecutiva; toda la respuesta debe consolidarse en un único bloque de texto.
Solución Técnica: Se recomienda utilizar nodos Code al final del flujo en n8n para limpiar la salida del agente, eliminando emojis y normalizando los saltos de línea antes de realizar la petición de respuesta a Kommo.
5. Creación de la Integración y Obtención de Token
Para que n8n tenga permisos de escritura y lectura, es necesario crear una "Aplicación" interna:
- Haz clic en el botón azul "Crear integración" en la parte superior de la interfaz de Kommo.
- Redirect URL: Coloca la URL de producción de tu webhook de n8n.
- Nombre: Asigna un nombre descriptivo a la integración.
- Vigencia: Al generar el token, selecciona la fecha de vencimiento más lejana permitida (1 a 3 años, dependiendo del plan de Kommo).
- Seguridad: Una vez generado el token, cópialo y guárdalo de inmediato en un lugar seguro (ej. Bloc de notas o gestor de secretos), ya que podría no ser visible nuevamente.
6. Pruebas y Uso de la API
Puedes validar el funcionamiento y explorar los campos disponibles del CRM utilizando la documentación oficial:
- Referencia: Kommo API - Get Lead by ID
Para realizar pruebas en esta interfaz, necesitarás:
- Token: El código generado en el paso anterior.
- Subdominio: Se encuentra en la URL de tu instancia de Kommo.
- Ejemplo: Si tu URL es
empresa.kommo.com, el subdominio esempresa.