📌 ¿Qué vamos a lograr?
En este artículo aprenderás a configurar una integración que permita enviar automáticamente nuevos contactos desde Zolutium hacia Kommo.
Cuando un contacto sea creado, una automatización enviará sus datos a Kommo mediante un Webhook personalizado.
El flujo funcionará de esta manera:
Nuevo contacto en Zolutium ↓ Se activa la automatización ↓ Webhook personalizado ↓ API de Kommo ↓ Creación del Lead ↓ Creación del contacto asociado
Los datos que enviaremos serán:
👤 Nombre
📞 Teléfono
✉️ Correo electrónico
De esta manera podrás automatizar el ingreso de contactos a Kommo y reducir procesos manuales.
✅ Antes de comenzar
Asegúrate de tener:
Acceso a tu cuenta de Zolutium.
Acceso administrativo a Kommo.
Permisos para crear automatizaciones.
Permisos para crear una integración privada en Kommo.
Acceso a la acción Webhook personalizado.
Un contacto de prueba con nombre, teléfono y correo electrónico.
⚠️ Importante: El uso del Webhook personalizado puede generar cargos adicionales por ejecución dependiendo de la configuración o plan de tu cuenta.
1. 🔐 Crear una integración privada en Kommo
Primero necesitamos generar una credencial que permita a Zolutium comunicarse con Kommo.
Ingresa a tu cuenta de Kommo y dirígete a:
Ajustes → Integraciones → Crear integración
Crea una nueva integración privada.
Puedes utilizar un nombre como:
ZLT - KOMMO LEADS
Y una descripción como:
Integración privada para enviar automáticamente nuevos contactos de Zolutium hacia Kommo.
Completa la información solicitada por Kommo y guarda la integración.
Dependiendo de tu cuenta, Kommo puede solicitar una verificación mediante un código enviado a tu correo electrónico.
Ingresa el código para completar la creación de la integración.
2. 🔑 Generar el token de Kommo
Una vez creada la integración, ingresa en:
Llaves y alcances
Busca la opción:
Generar token de larga duración
Selecciona la fecha de expiración que deseas utilizar y genera el token.
Una vez generado, cópialo.
🚨 Este token es una credencial privada.
No debes compartirlo públicamente ni incluirlo en capturas de pantalla, tutoriales o artículos de soporte.
En nuestros ejemplos utilizaremos:
TU_TOKEN_DE_KOMMO
Guárdalo porque lo utilizaremos más adelante dentro de Zolutium.
3. ⚙️ Crear la automatización en Zolutium
Ahora regresa a Zolutium y crea una nueva automatización.
Puedes utilizar un nombre como:
RECEPTOR INTERMEDIARIO
Dentro del flujo agrega el disparador:
Contacto Creado
La estructura inicial deberá verse de forma similar a:
Contacto Creado ↓ Webhook personalizado ↓ Final
💡 ¿Necesitas enviar solamente ciertos contactos?
Si no quieres enviar todos los contactos nuevos hacia Kommo, puedes agregar filtros al disparador.
Por ejemplo:
Contacto Creado + Origen = Facebook
o:
Contacto Creado + Etiqueta = Enviar a Kommo
Esto dependerá de la lógica de tu negocio.
4. 🌐 Agregar el Webhook personalizado
Después del disparador Contacto Creado, agrega una nueva acción.
Selecciona:
Webhook personalizado
Configura los siguientes valores:
Evento: CUSTOM Método: POST Tipo de contenido: application/json
📌 Es importante seleccionar POST, ya que vamos a enviar información hacia Kommo para crear un nuevo registro.
5. 🔗 Configurar la URL de la API de Kommo
En el campo URL del Webhook coloca:
https://TU_SUBDOMINIO.kommo.com/api/v4/leads/complex
Debes reemplazar:
TU_SUBDOMINIO
por el subdominio correspondiente a tu cuenta de Kommo.
Por ejemplo:
https://miempresa.kommo.com/api/v4/leads/complex
⚠️ No copies exactamente el ejemplo. Cada cuenta de Kommo puede tener un subdominio diferente.
6. 🔒 Configurar la autorización
Dentro de la sección de autorización del Webhook selecciona:
Bearer Token
Ahora debes utilizar el token de larga duración que generaste anteriormente en Kommo.
Recomendación de seguridad
En lugar de colocar directamente el token dentro del Webhook, es recomendable almacenarlo como una clave segura.
Puedes crear una clave con el nombre:
Kommo_token
En el valor de la clave debes colocar:
TU_TOKEN_DE_KOMMO
Luego selecciona esa clave dentro de la configuración del Bearer Token.
De esta forma, tu credencial estará mejor protegida. 🔐
7. 🧩 Configurar el cuerpo JSON
Ahora debemos indicar qué información queremos enviar a Kommo.
En el cuerpo del Webhook agrega:
[ { "name": "Lead - {{contact.name}}", "_embedded": { "contacts": [ { "name": "{{contact.name}}", "custom_fields_values": [ { "field_code": "PHONE", "values": [ { "value": "{{contact.phone}}", "enum_code": "MOB" } ] }, { "field_code": "EMAIL", "values": [ { "value": "{{contact.email}}", "enum_code": "WORK" } ] } ] } ] } } ]8. 🧠 ¿Qué información estamos enviando?
El JSON utiliza variables dinámicas de Zolutium.
Nombre
{{contact.name}}Tomará automáticamente el nombre del contacto.
Teléfono
{{contact.phone}}Enviará el número de teléfono registrado.
Correo electrónico
{{contact.email}}Enviará el correo electrónico del contacto.
9. 👤 ¿Qué se creará en Kommo?
Cuando el Webhook se ejecute correctamente, Kommo recibirá la información y generará un Lead.
Por ejemplo, si el contacto se llama:
Juan Pérez
el Lead tendrá un nombre similar a:
Lead - Juan Pérez
Dentro de ese Lead se asociará un contacto con:
Nombre: Juan Pérez Teléfono: +XXXXXXXXXXX Correo: [email protected]
10. 🧪 Crear un contacto de prueba
Antes de activar la automatización para todos tus contactos, recomendamos realizar una prueba.
Crea un contacto ficticio con datos como:
Nombre: Contacto Prueba Teléfono: +XXXXXXXXXXX Correo: [email protected]
Evita utilizar inicialmente información real de clientes.
11. ▶️ Probar la automatización
Dentro de Zolutium utiliza la opción:
Probar flujo de trabajo
Selecciona el contacto que acabas de crear y ejecuta la prueba.
Después revisa los:
Registros de ejecución
Si todo funciona correctamente, deberías observar algo similar a:
Contacto Creado → Added To Workflow Webhook personalizado → Ejecutado End Of Workflow → Finished
✅ Esto indica que el Webhook pudo ejecutarse correctamente.
12. 🔎 Confirmar el contacto en Kommo
Ahora ingresa nuevamente a Kommo.
Busca el contacto utilizando:
Nombre
Teléfono
Correo electrónico
Si la integración funcionó correctamente, deberías encontrar el nuevo contacto junto con el Lead creado.
🎉 ¡Listo! Zolutium ya está enviando información correctamente hacia Kommo.
🛠️ Solución de problemas
A continuación encontrarás algunos de los errores más comunes y cómo solucionarlos.
❌ Problema: “Ha omitido algunos campos”
Si Zolutium muestra un mensaje indicando que faltan campos, revisa la configuración del Webhook.
Comprueba:
URL.
Método HTTP.
Bearer Token.
Clave del token.
Tipo de contenido.
Cuerpo JSON.
Variables dinámicas.
La configuración principal debe tener:
Método: POST Content-Type: application/json Autorización: Bearer Token
❌ Problema: “Introduzca una URL válida”
Comprueba que la URL tenga la estructura correcta:
https://TU_SUBDOMINIO.kommo.com/api/v4/leads/complex
Verifica que:
Comience con
https://El subdominio sea correcto.
No existan espacios.
No existan caracteres adicionales.
El endpoint termine correctamente en
/api/v4/leads/complex.
🔐 Problema: No sé si el token está funcionando
Puedes probar primero únicamente la autenticación.
Configura temporalmente:
Método: GET
Y utiliza:
https://TU_SUBDOMINIO.kommo.com/api/v4/account
Mantén configurado el mismo Bearer Token.
Ejecuta nuevamente la prueba.
Si recibes:
Request success with status: 200
✅ Significa que:
El token es válido.
El subdominio es correcto.
La autenticación funciona.
Zolutium puede comunicarse con Kommo.
Después de comprobarlo, recuerda regresar a la configuración original:
Método: POST
URL: https://TU_SUBDOMINIO.kommo.com/api/v4/leads/complex
❌ Problema: Error 405
Si recibes:
Request failed with status: 405
revisa el método HTTP.
Si estás intentando crear un Lead utilizando:
/api/v4/leads/complex
debes utilizar:
POST
Si dejaste accidentalmente:
GET
cámbialo nuevamente a:
POST
y vuelve a ejecutar la prueba.
⚠️ Problema: Error 402
Si aparece:
Request failed with status: 402
o:
Payment Required
revisa el estado de tu cuenta de Kommo.
Puedes dirigirte a:
Ajustes → Facturas
Comprueba el estado de:
Suscripción.
Licencias.
Facturación.
Restricciones de la cuenta.
Después vuelve a ejecutar la prueba.
📌 Importante: un código 402 indica que Kommo está rechazando la solicitud por una condición relacionada con la cuenta o servicio. Revisa también los detalles de la respuesta antes de modificar otros elementos de la integración.
❌ Problema: El Webhook aparece como “Failed”
Ingresa en:
Registros de ejecución
Abre la ejecución que presentó el error y revisa específicamente la acción:
Custom Webhook
Comprueba primero si la autenticación funciona utilizando:
GET /api/v4/account
Si obtienes un código 200, el problema probablemente se encuentra en:
El endpoint utilizado.
El método HTTP.
El JSON.
Alguno de los campos enviados.
🧩 Problema: No sé si el error está en el JSON
Puedes simplificar temporalmente el cuerpo de la solicitud.
Utiliza un JSON básico como:
[ { "name": "Prueba ZLT" } ]Ejecuta nuevamente el Webhook.
Si esta versión funciona, entonces la conexión con Kommo está correcta y debes revisar progresivamente los campos adicionales de tu JSON.
Después vuelve a colocar el JSON completo.
💡 Esta técnica permite identificar errores sin modificar toda la integración al mismo tiempo.
🔎 Problema: El contacto no aparece en Kommo
Si Zolutium indica que la ejecución fue correcta pero no encuentras el contacto, revisa:
Que estés ingresando a la cuenta correcta de Kommo.
Que el contacto tenga nombre.
Que el teléfono tenga un formato válido.
Que exista correo electrónico.
Que el Webhook haya finalizado correctamente.
Que la respuesta de Kommo no contenga errores.
Que no tengas filtros activos dentro de Kommo.
También puedes buscar directamente utilizando el correo electrónico o teléfono del contacto.
👥 Problema: Se están creando contactos duplicados
Durante las pruebas es posible ejecutar varias veces el mismo Webhook.
Esto puede provocar que Kommo genere múltiples registros del mismo contacto.
Por ejemplo:
Contacto Prueba Contacto Prueba
Si deseas evitar duplicados en producción, será necesario implementar una lógica adicional para:
Buscar si el contacto ya existe.
Identificarlo mediante correo o teléfono.
Actualizarlo si existe.
Crear uno nuevo solamente si no existe.
⚠️ El flujo descrito en este artículo está diseñado principalmente para crear contactos y Leads nuevos, no para realizar una sincronización bidireccional completa.
🔐 Recomendaciones de seguridad
Nunca publiques dentro de artículos, videos o capturas de pantalla:
Tokens.
Contraseñas.
Secretos.
Credenciales.
Datos personales reales.
Información sensible de clientes.
Utiliza siempre ejemplos como:
TU_TOKEN_DE_KOMMO
TU_SUBDOMINIO
+XXXXXXXXXXX
✅ Checklist antes de publicar la automatización
Antes de activar el flujo definitivamente, confirma:
La integración privada de Kommo fue creada.
El token de larga duración está activo.
El token está almacenado de forma segura.
El disparador es
Contacto Creado.La URL contiene el subdominio correcto.
El método utilizado es
POST.La autorización utiliza
Bearer Token.El tipo de contenido es
application/json.El JSON contiene las variables correctas.
El contacto de prueba llegó a Kommo.
El Webhook aparece como ejecutado correctamente.
Se revisaron posibles duplicados.
Se agregaron filtros si son necesarios.
Cuando todos estos puntos estén completos, podrás publicar o activar tu automatización. 🚀
🎯 Resultado final
Una vez terminada la configuración, el proceso será automático:
Se crea un contacto ↓ Zolutium detecta el contacto ↓ Ejecuta el Webhook ↓ Envía nombre, teléfono y correo ↓ Kommo recibe la información ↓ Crea el Lead ↓ Asocia el contacto
De esta manera puedes conectar Zolutium con Kommo sin utilizar una plataforma intermediaria adicional, automatizando el envío de nuevos contactos y facilitando el seguimiento comercial. 🚀