Kommo Bots API
The Bots API from Kommo — 5 operation(s) for bots.
The Bots API from Kommo — 5 operation(s) for bots.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/kommo:kommo-bots-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: kommo-api Bots API
version: '1.0'
servers:
- url: https://{subdominio}.kommo.com
variables:
subdominio:
default: subdominio
security:
- sec0: []
tags:
- name: Bots
paths:
/api/v4/bots:
get:
description: ''
responses:
'200':
description: Solicitud exitosa
content:
application/hal+json:
examples:
Solicitud exitosa:
summary: Solicitud exitosa
value:
_total_items: 1
_page: 1
_page_count: 1
_links:
self:
href: https://subdomain.kommo.com/api/v4/bots/?page=1&limit=250
_embedded:
items:
- id: 250704
name: 'Salesbot #1'
type_functionality: regular
is_visual_editor: true
settings:
active: true
_links:
self:
href: https://subdomain.kommo.com/api/v4/bots/250704/?page=1&limit=250
schema:
type: object
properties:
_total_items:
type: integer
example: 1
default: 0
_page:
type: integer
example: 1
default: 0
_page_count:
type: integer
example: 1
default: 0
_links:
type: object
properties:
self:
type: object
properties:
href:
type: string
example: https://subdomain.kommo.com/api/v4/bots/?page=1&limit=250
_embedded:
type: object
properties:
items:
type: array
items:
type: object
properties:
id:
type: integer
example: 250704
default: 0
name:
type: string
example: 'Salesbot #1'
type_functionality:
type: string
example: regular
is_visual_editor:
type: boolean
example: true
default: true
settings:
type: object
properties:
active:
type: boolean
example: true
default: true
_links:
type: object
properties:
self:
type: object
properties:
href:
type: string
example: https://subdomain.kommo.com/api/v4/bots/250704/?page=1&limit=250
'204':
content:
text/html:
schema:
type: object
properties: {}
examples:
No se encontraron Salesbots:
summary: No se encontraron Salesbots
value: Sin contenido
description: No se encontraron Salesbots
'400':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Se enviaron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.:
summary: Se enviaron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.
value: "{\n \"validation-errors\": [\n {\n \"request_id\": \"0\",\n \"errors\": [\n {\n \"code\": \"FieldNotExpected\",\n \"path\": \"filter.example\",\n \"detail\": \"No se esperaba este campo.\"\n }\n ]\n }\n ],\n \"title\": \"Bad Request\",\n \"type\": \"https://httpstatus.es/400\",\n \"status\": 400,\n \"detail\": \"Solicitud incorrecta\"\n}"
description: Se enviaron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.
'401':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
El usuario no está autorizado:
summary: El usuario no está autorizado
value: "{\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatus.es/401\",\n \"status\": 401,\n \"detail\": \"Nombre de usuario o contraseña no válidos\"\n}"
description: El usuario no está autorizado
parameters:
- in: query
name: page
schema:
type: integer
description: Página de la respuesta
- in: query
name: limit
schema:
type: integer
description: 'Cantidad de entidades devueltas por solicitud (límite: 250)'
- in: query
name: filter[type_functionality][]
schema:
type: array
items:
type: string
description: 'Filtrar por tipo de funcionalidad del Salesbot. Valores posibles: `regular` – Salesbot de flujo básico, `greeting` – bot de mensaje de bienvenida, `marketing` – bot para envío de mensajes de difusión, `nps` – bot para realizar encuestas NPS'
- in: query
name: filter[id][]
schema:
type: array
items:
type: integer
description: Filtrar por IDs de Salesbots
- in: query
name: with
schema:
type: string
description: Este parámetro acepta una cadena que puede contener varios valores (consulte la tabla anterior) separados por comas.
operationId: get_api-v4-bots
tags:
- Bots
summary: Get api v4 bots
x-summary-source: derived
/api/v4/bots/run:
post:
description: ''
responses:
'202':
content:
text/html:
schema:
type: object
properties: {}
examples:
Solicitud exitosa:
summary: Solicitud exitosa
value: ' '
description: Solicitud exitosa
'400':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Solicitud incorrecta:
summary: Solicitud incorrecta
value:
validation-errors:
- request_id: '0'
errors:
- code: TooLow
path: bot_id
detail: Este valor debe ser positivo.
- code: InvalidType
path: entity_type
detail: Este valor debe ser de tipo string.
- code: NotSupportedChoice
path: entity_type
detail: El valor seleccionado no es una opción válida.
title: Solicitud incorrecta
type: https://httpstatus.es/400
status: 400
detail: Falló la validación de la solicitud
description: Solicitud incorrecta
'401':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Usuario no autorizado:
summary: Usuario no autorizado
value:
title: Unauthorized
type: https://httpstatus.es/401
status: 401
detail: Nombre de usuario o contraseña no válidos
description: Usuario no autorizado
'403':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Entidad no encontrada o sin permisos:
summary: Entidad no encontrada o sin permisos
value:
title: Access denied
type: https://developers.amocrm.ru/v4/errors/ProblemDetail
status: 403
detail: 'Entidad no encontrada o sin permisos: 169217809'
description: Entidad no encontrada o sin permisos
'404':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Salesbot no encontrado:
summary: Salesbot no encontrado
value:
title: Not found
type: https://developers.amocrm.ru/v4/errors/ProblemDetail
status: 404
detail: 'Bots no encontrados: 85321'
description: Salesbot no encontrado
parameters: []
operationId: post_api-v4-bots-run
requestBody:
content:
application/json:
schema:
type: array
items:
type: object
properties:
bot_id:
type: integer
description: ID del Salesbot que se va a lanzar
format: int32
entity_id:
type: integer
description: ID de la entidad para la cual se lanzará el Salesbot
format: int32
entity_type:
type: string
description: Tipo de entidad. Puede ser `leads` o `contacts
enum:
- leads
- contacts
required:
- bot_id
- entity_type
- entity_id
summary: Lanzar Salesbots
tags:
- Bots
/api/v4/bots/{id}:
get:
responses:
'200':
description: La solicitud fue exitosa
content:
application/hal+json:
examples:
La solicitud fue exitosa:
summary: La solicitud fue exitosa
value:
id: 12345
name: Salesbot
type_functionality: regular
is_visual_editor: true
settings:
active: false
_links:
self:
href: https://subdomain.kommo.com/api/v4/bots/12345/
schema:
type: object
properties:
id:
type: integer
example: 12345
default: 0
name:
type: string
example: Salesbot
type_functionality:
type: string
example: regular
is_visual_editor:
type: boolean
example: true
default: true
settings:
type: object
properties:
active:
type: boolean
example: false
default: true
_links:
type: object
properties:
self:
type: object
properties:
href:
type: string
example: https://subdomain.kommo.com/api/v4/bots/12345/
'204':
content:
text/html:
schema:
type: object
properties: {}
examples:
El Salesbot con el ID especificado no existe:
summary: El Salesbot con el ID especificado no existe
value: Sin contenido
description: El Salesbot con el ID especificado no existe
'400':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Se transmitieron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.:
summary: Se transmitieron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.
value: ''
description: Se transmitieron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.
'401':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
El usuario no está autorizado:
summary: El usuario no está autorizado
value:
title: Unauthorized
type: https://httpstatus.es/401
status: 401
detail: Nombre de usuario o contraseña no válidos
description: El usuario no está autorizado
parameters:
- in: path
name: id
schema:
type: integer
required: true
description: ID del Salesbot
- in: query
name: with
schema:
type: string
description: Este parámetro acepta una cadena que puede contener varios valores separados por comas
summary: Obtener un Salesbot por su ID
description: El método permite obtener un Salesbot por su ID.
operationId: get_api-v4-bots-id
tags:
- Bots
/api/v4/bots/{id}/run:
post:
description: ''
responses:
'202':
content:
text/html:
schema:
type: object
properties: {}
examples:
Se creó correctamente la tarea para iniciar un bot:
summary: Se creó correctamente la tarea para iniciar un bot
value: ' '
description: Se creó correctamente la tarea para iniciar un bot
'400':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Se enviaron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.:
summary: Se enviaron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.
value:
validation-errors:
- request_id: '0'
errors:
- code: NotSupportedChoice
path: entity_type
detail: El valor seleccionado no es una opción válida.
title: Solicitud incorrecta
type: https://httpstatus.es/400
status: 400
detail: Falló la validación de la solicitud
description: Se enviaron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.
'401':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
El usuario no está autorizado:
summary: El usuario no está autorizado
value: "{\n \"title\": \"No autorizado\",\n \"type\": \"https://httpstatus.es/401\",\n \"status\": 401,\n \"detail\": \"Nombre de usuario o contraseña no válidos\"\n}"
description: El usuario no está autorizado
'403':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
No hay permisos suficientes para llamar a este método en la entidad especificada:
summary: No hay permisos suficientes para llamar a este método en la entidad especificada
value:
title: Acceso denegado
type: https://developers.amocrm.ru/v4/errors/ProblemDetail
status: 403
detail: 'Entidad no encontrada o sin permisos: 3552552'
description: No hay permisos suficientes para llamar a este método en la entidad especificada
'404':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
El Salesbot con el ID especificado no fue encontrado:
summary: El Salesbot con el ID especificado no fue encontrado
value: "{\n \"title\": \"No encontrado\",\n \"type\": \"https://developers.amocrm.ru/v4/errors/ProblemDetail\",\n \"status\": 404,\n \"detail\": \"Bots no encontrados: 6691202\"\n}"
description: El Salesbot con el ID especificado no fue encontrado
parameters:
- in: path
name: id
schema:
type: integer
format: int32
required: true
description: ID del Salesbot que se va a lanzar
operationId: post_api-v4-bots-id-run
requestBody:
content:
application/json:
schema:
type: object
properties:
entity_id:
type: integer
description: ID de la entidad a la que está vinculado el contacto del chat, o ID del propio contacto del chat.
format: int32
entity_type:
type: string
description: Tipo de entidad cuyo ID fue proporcionado. Puede ser `leads` y `contacts`.
enum:
- leads
- contacts
required:
- entity_id
- entity_type
summary: Lanzar un Salesbot
tags:
- Bots
/api/v4/bots/{id}/stop:
post:
description: Este método permite detener un Salesbot para la entidad utilizando el ID del bot.
responses:
'202':
content:
text/html:
schema:
type: object
properties: {}
examples:
Se han creado con éxito tareas para detener bots:
summary: Se han creado con éxito tareas para detener bots
value: ' '
description: Se han creado con éxito tareas para detener bots
'400':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Se transmitieron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.:
summary: Se transmitieron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.
value:
validation-errors:
- request_id: '0'
errors:
- code: NotSupportedChoice
path: entity_type
detail: El valor seleccionado no es una opción válida.
title: Solicitud incorrecta
type: 'https://httpstatus.es/400 '
status: 400
detail: Falló la validación de la solicitud
description: Se transmitieron datos incorrectos. Los detalles están disponibles en el cuerpo de la respuesta.
'401':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Usuario no autorizado:
summary: Usuario no autorizado
value:
title: No autorizado
type: https://httpstatus.es/401
status: 401
detail: Nombre de usuario o contraseña no válidos
description: Usuario no autorizado
'403':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
No hay suficientes derechos para llamar a este método en la entidad especificada:
summary: No hay suficientes derechos para llamar a este método en la entidad especificada
value:
title: Prohibido
type: https://httpstatus.es/403
status: 403
detail: Permisos insuficientes
description: No hay suficientes derechos para llamar a este método en la entidad especificada
parameters:
- in: path
name: id
schema:
type: integer
format: int32
required: true
description: ID del Salesbot que se va a detener
operationId: post_api-v4-bots-id-stop
requestBody:
content:
application/json:
schema:
type: object
properties:
entity_id:
type: integer
format: int32
description: ID de la entidad para la cual se detendrá el Salesbot
entity_type:
type: string
description: Tipo de entidad. Puede ser `leads`
required:
- entity_id
- entity_type
summary: Detener un Salesbot
tags:
- Bots
components:
securitySchemes:
sec0:
type: oauth2
flows: {}
x-readme-fauxas: true
x-provenance:
method: searched
source: https://es-developers.kommo.com/reference
harvested: '2026-11-15'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://es-developers.kommo.com/reference/aceptar-leads-entrantes.md
- https://es-developers.kommo.com/reference/activar-usuarios.md
- https://es-developers.kommo.com/reference/actualizar-campo-personalizado.md
- https://es-developers.kommo.com/reference/actualizar-campos-personalizados-de-lista.md
- https://es-developers.kommo.com/reference/actualizar-campos-personalizados.md
- https://es-developers.kommo.com/reference/actualizar-contactos.md
- https://es-developers.kommo.com/reference/actualizar-fuentes.md
- https://es-developers.kommo.com/reference/actualizar-un-campo-personalizado-de-una-lista.md
- https://es-developers.kommo.com/reference/actualizar-un-solo-contacto.md
- https://es-developers.kommo.com/reference/actualizar-una-fuente.md
- https://es-developers.kommo.com/reference/crear-etiquetas-para-tipo-de-entidad-en-particular.md
- https://es-developers.kommo.com/reference/datos-de-las-etapas-del-pipeline.md
- https://es-developers.kommo.com/reference/desactivar-usuarios.md
- https://es-developers.kommo.com/reference/desfijar-una-nota.md
- https://es-developers.kommo.com/reference/desinstalar-el-widget.md
- https://es-developers.kommo.com/reference/desvincular-entidades.md
- https://es-developers.kommo.com/reference/detener-un-salesbot.md
- https://es-developers.kommo.com/reference/editar-elementos-de-lista.md
- https://es-developers.kommo.com/reference/editar-estado-de-plantilla-whatsapp.md
- https://es-developers.kommo.com/reference/editar-listas.md
- https://es-developers.kommo.com/reference/editar-notas.md
- https://es-developers.kommo.com/reference/editar-plantillas.md
- https://es-developers.kommo.com/reference/editar-roles.md
- https://es-developers.kommo.com/reference/editar-sola-tarea.md
- https://es-developers.kommo.com/reference/editar-tareas.md
- https://es-developers.kommo.com/reference/editar-un-elemento-de-lista.md
- https://es-developers.kommo.com/reference/editar-un-grupo-de-campos.md
- https://es-developers.kommo.com/reference/editar-un-pipeline.md
- https://es-developers.kommo.com/reference/editar-una-etapa-del-pipeline.md
- https://es-developers.kommo.com/reference/editar-una-lista.md
- https://es-developers.kommo.com/reference/editar-una-nota.md
- https://es-developers.kommo.com/reference/eliminar-campo-personalizado.md
- https://es-developers.kommo.com/reference/eliminar-fuentes.md
- https://es-developers.kommo.com/reference/eliminar-plantillas.md
- https://es-developers.kommo.com/reference/eliminar-un-grupo-de-campos.md
- https://es-developers.kommo.com/reference/eliminar-un-pipeline.md
- https://es-developers.kommo.com/reference/eliminar-un-rol.md
- https://es-developers.kommo.com/reference/eliminar-un-webhook.md
- https://es-developers.kommo.com/reference/eliminar-una-etapa-del-pipeline.md
- https://es-developers.kommo.com/reference/eliminar-una-fuente.md
- https://es-developers.kommo.com/reference/eliminar-una-plantilla.md
- https://es-developers.kommo.com/reference/entidades-vinculadas.md
- https://es-developers.kommo.com/reference/enviar-mensaje-a-conversacion.md
- https://es-developers.kommo.com/reference/fijar-una-nota.md
- https://es-developers.kommo.com/reference/get-a-website-chat-button.md
- https://es-developers.kommo.com/reference/instalar-widget-en-cuenta.md
- https://es-developers.kommo.com/reference/lanzar-salesbot.md
- https://es-developers.kommo.com/reference/lanzar-salesbots.md
- https://es-developers.kommo.com/reference/lista-de-campos-personalizados-de-una-lista.md
- https://es-developers.kommo.com/reference/lista-de-campos-personalizados.md
- https://es-developers.kommo.com/reference/lista-de-contactos.md
- https://es-developers.kommo.com/reference/lista-de-entidades-vinculadas.md
- https://es-developers.kommo.com/reference/lista-de-etiquetas-de-entidad.md
- https://es-developers.kommo.com/reference/lista-de-eventos.md
- https://es-developers.kommo.com/reference/lista-de-grupos-de-campos-de-entidad.md
- https://es-developers.kommo.com/reference/lista-de-leads-entrantes.md
- https://es-developers.kommo.com/reference/lista-de-leads.md
- https://es-developers.kommo.com/reference/lista-de-notas-por-tipo-de-entidad.md
- https://es-developers.kommo.com/reference/lista-de-pipelines.md
- https://es-developers.kommo.com/reference/lista-de-roles-de-usuario.md
- https://es-developers.kommo.com/reference/lista-de-salesbots.md
- https://es-developers.kommo.com/reference/lista-de-tareas.md
- https://es-developers.kommo.com/reference/lista-de-usuarios.md
- https://es-developers.kommo.com/reference/lista-de-webhooks.md
- https://es-developers.kommo.com/reference/lista-de-widgets.md
- https://es-developers.kommo.com/reference/motivo-de-perdida-por-id.md
- https://es-developers.kommo.com/reference/obtener-campo-de-entidad-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-campo-de-lista-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-conversaciones.md
- https://es-developers.kommo.com/reference/obtener-datos-de-rol-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-elemento-de-lista.md
- https://es-developers.kommo.com/reference/obtener-elementos-de-lista.md
- https://es-developers.kommo.com/reference/obtener-evento-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-fuente-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-lista-de-fuentes.md
- https://es-developers.kommo.com/reference/obtener-lista-de-notas-de-entidad-particular-por-id-de-entidad.md
- https://es-developers.kommo.com/reference/obtener-los-chats-de-un-contacto.md
- https://es-developers.kommo.com/reference/obtener-los-datos-de-una-etapa-del-pipeline-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-mensajes-de-conversacion.md
- https://es-developers.kommo.com/reference/obtener-nota-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-suscriptores-de-leads.md
- https://es-developers.kommo.com/reference/obtener-tarea-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-tipos-de-eventos.md
- https://es-developers.kommo.com/reference/obtener-un-contacto-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-un-grupo-de-campos-de-entidad-por-id.md
- https://es-developers.kommo.com/reference/obtener-un-lead-entrante-por-su-uid.md
- https://es-developers.kommo.com/reference/obtener-un-lead-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-un-pipeline-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-un-salesbot-por-su-id.md
- https://es-developers.kommo.com/reference/obtener-una-lista-de-listas.md
- https://es-developers.kommo.com/reference/obtener-una-lista-de-plantillas.md
- https://es-developers.kommo.com/reference/obtener-una-lista.md
- https://es-developers.kommo.com/reference/obtener-una-plantilla-por-su-id.md
- https://es-developers.kommo.com/reference/obteniendo-datos-del-usuario-por-su-id.md
- https://es-developers.kommo.com/reference/paso-4-vincular-el-chat-a-un-contacto.md
- https://es-developers.kommo.com/reference/rechazar-leads-entrantes.md
- https://es-developers.kommo.com/reference/token-de-acceso.md
- https://es-developers.kommo.com/reference/vincular-leads-entrantes.md
merge:
pages: 98
deduped: 97
conflicts_kept_first: 0