Kommo Talks API
The Talks API from Kommo — 5 operation(s) for talks.
The Talks API from Kommo — 5 operation(s) for talks.
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-talks-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 Talks API
version: '1.0'
description: 'Operations tagged Talks across 2 of this provider''s published API definitions: kommo-api-openapi.yml, kommo-api-references-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{subdominio}.kommo.com
variables:
subdominio:
default: subdominio
- url: https://{subdomain}.kommo.com
variables:
subdomain:
default: subdomain
security:
- sec0: []
tags:
- name: Talks
paths:
/api/v4/talks:
get:
responses:
'200':
description: Solicitud realizada correctamente
content:
application/hal+json:
examples:
Solicitud realizada correctamente:
summary: Solicitud realizada correctamente
value:
_total_items: 1
_embedded:
talks:
- talk_id: 249
created_at: 1773754561
updated_at: 1773762171
rate: 0
contact_id: 24602666
chat_id: 307d7d92-6d7c-4f14-aa4f-795b403e9fc5
entity_id: 20139824
entity_type: lead
status: in_work
is_in_work: true
is_read: false
origin: kommo_origin
source_id: 43444
account_id: 2921238
_links:
self:
href: https://subdomain.kommo.com/api/v4/talks/249?page=1&limit=1
_embedded:
contacts:
- id: 24602666
_links:
self:
href: https://subdomain.kommo.com/api/v4/contacts/24602666?page=1&limit=1
leads:
- id: 20139824
_links:
self:
href: https://subdomain.kommo.com/api/v4/leads/20139824?page=1&limit=1
customers: []
schema:
type: object
properties:
_total_items:
type: integer
example: 1
default: 0
_embedded:
type: object
properties:
talks:
type: array
items:
type: object
properties:
talk_id:
type: integer
example: 249
default: 0
created_at:
type: integer
example: 1773754561
default: 0
updated_at:
type: integer
example: 1773762171
default: 0
rate:
type: integer
example: 0
default: 0
contact_id:
type: integer
example: 24602666
default: 0
chat_id:
type: string
example: 307d7d92-6d7c-4f14-aa4f-795b403e9fc5
entity_id:
type: integer
example: 20139824
default: 0
entity_type:
type: string
example: lead
status:
type: string
example: in_work
is_in_work:
type: boolean
example: true
default: true
is_read:
type: boolean
example: false
default: true
origin:
type: string
example: kommo_origin
source_id:
type: integer
example: 43444
default: 0
account_id:
type: integer
example: 2921238
default: 0
_links:
type: object
properties:
self:
type: object
properties:
href:
type: string
example: https://subdomain.kommo.com/api/v4/talks/249?page=1&limit=1
_embedded:
type: object
properties:
contacts:
type: array
items:
type: object
properties:
id:
type: integer
example: 24602666
default: 0
_links:
type: object
properties:
self:
type: object
properties:
href:
type: string
example: https://subdomain.kommo.com/api/v4/contacts/24602666?page=1&limit=1
leads:
type: array
items:
type: object
properties:
id:
type: integer
example: 20139824
default: 0
_links:
type: object
properties:
self:
type: object
properties:
href:
type: string
example: https://subdomain.kommo.com/api/v4/leads/20139824?page=1&limit=1
customers:
type: array
items:
type: object
properties: {}
'204':
content:
text/html:
schema:
type: object
properties: {}
examples:
Sin contenido:
summary: Sin contenido
value: Sin contenido
description: Sin contenidodd
'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
'402':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Pago requerido:
summary: Pago requerido
value: "{\n \"title\": \"Payment Required\",\n \"type\": \"https://httpstatus.es/402\",\n \"status\": 402,\n \"detail\": \"Pago requerido\"\n}"
description: Pago requerido
parameters:
- in: query
name: page
schema:
type: integer
description: Página de la respuesta
- in: query
name: limit
schema:
type: integer
description: 'Número de entidades retornadas por solicitud (límite: 250)'
- in: query
name: filter[talk_id][]
schema:
type: array
items:
type: integer
description: Filtrar por ID de conversación. Acepta un único ID o un arreglo de IDs
- in: query
name: filter[contact_id][]
schema:
type: array
items:
type: integer
description: Filtrar por ID de contacto. Acepta un único ID o un arreglo de IDs
- in: query
name: filter[entity_id][]
schema:
type: array
items:
type: integer
description: Filtrar por ID de entidad (lead). Acepta un único ID o un arreglo de IDs. Debe utilizarse junto con `filter[entity_type]`
- in: query
name: filter[entity_type]
schema:
type: string
enum:
- lead
description: 'Tipo de entidad para filtrar por `entity_id`. Valores posibles: `lead`'
- in: query
name: filter[only_in_work]
schema:
type: string
description: Este parámetro es opcional y no requiere un valor. Si está presente, solo se devuelven las conversaciones abiertas
summary: Obtener conversaciones
description: Este método retorna una colección de conversaciones de la cuenta.
operationId: get_api-v4-talks
tags:
- Talks
servers:
- url: https://{subdominio}.kommo.com
variables:
subdominio:
default: subdominio
/api/v4/talks/{talk_id}/messages:
get:
responses:
'200':
description: Solicitud realizada correctamente
content:
application/hal+json:
examples:
Solicitud realizada correctamente:
summary: Solicitud realizada correctamente
value: "{\n \"_page\": 1,\n \"_links\": {\n \"self\": {\n \"href\": \"https://subdomain.kommo.com/api/v4/talks/123/messages?page=1&limit=250\"\n }\n },\n \"_embedded\": {\n \"messages\": [\n {\n \"id\": \"213sda-308d-417b-das2-2b9c345b439c\",\n \"chat_id\": \"bb64b9c5-fd21-l9l2-999e-8908e8ad8c41\",\n \"type\": \"outgoing\",\n \"message_type\": \"picture\",\n \"author\": {\n \"id\": \"231babf6-daa8-42a5-8cf5-3e918b84e859\",\n \"type\": \"external\",\n \"name\": \"John\",\n \"avatar_url\": \"http://amojo.kommo.com/attachments/profiles/c06bf32a-das2-2231-k8i2-78db178474bd/image-100-100.jpg\"\n },\n \"recipient\": {\n \"id\": \"c06bf32a-b6e6-4261-a150-78db178474bd\",\n \"type\": \"external\",\n \"name\": \"John\",\n \"avatar_url\": \"http://amojo.kommo.com/attachments/profiles/c06bf32a-das2-2231-k8i2-78db178474bd/image-100-100.jpg\"\n },\n \"text\": \"Hello\",\n \"created_at\": 1762446507,\n \"sec_created_at\": 1762446507538,\n \"origin\": \"kommo_origin\",\n \"delivery_status\": \"delivered\",\n \"attachment\": {\n \"type\": \"picture\",\n \"link\": \"https://drive-c.kommo.com/download/1d7dff1e-dw12-5996-8dda-7c55db97f528/76ec5d70-daw1-23f2-b368-b285372c1449/5d526004-dbef-4c8e-9474-64e542201089/data.png\",\n \"file_name\": \"data.png\"\n }\n }\n ]\n }\n}"
schema:
type: object
properties:
_page:
type: integer
example: 1
default: 0
_links:
type: object
properties:
self:
type: object
properties:
href:
type: string
example: https://subdomain.kommo.com/api/v4/talks/123/messages?page=1&limit=250
_embedded:
type: object
properties:
messages:
type: array
items:
type: object
properties:
id:
type: string
example: 213sda-308d-417b-das2-2b9c345b439c
chat_id:
type: string
example: bb64b9c5-fd21-l9l2-999e-8908e8ad8c41
type:
type: string
example: outgoing
message_type:
type: string
example: picture
author:
type: object
properties:
id:
type: string
example: 231babf6-daa8-42a5-8cf5-3e918b84e859
type:
type: string
example: external
name:
type: string
example: John
avatar_url:
type: string
example: http://amojo.kommo.com/attachments/profiles/c06bf32a-das2-2231-k8i2-78db178474bd/image-100-100.jpg
recipient:
type: object
properties:
id:
type: string
example: c06bf32a-b6e6-4261-a150-78db178474bd
type:
type: string
example: external
name:
type: string
example: John
avatar_url:
type: string
example: http://amojo.kommo.com/attachments/profiles/c06bf32a-das2-2231-k8i2-78db178474bd/image-100-100.jpg
text:
type: string
example: Hello
created_at:
type: integer
example: 1762446507
default: 0
sec_created_at:
type: integer
example: 1762446507538
default: 0
origin:
type: string
example: kommo_origin
delivery_status:
type: string
example: delivered
attachment:
type: object
properties:
type:
type: string
example: picture
link:
type: string
example: https://drive-c.kommo.com/download/1d7dff1e-dw12-5996-8dda-7c55db97f528/76ec5d70-daw1-23f2-b368-b285372c1449/5d526004-dbef-4c8e-9474-64e542201089/data.png
file_name:
type: string
example: data.png
'402':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Suscripción caducada:
summary: Suscripción caducada
value: "{\n \"title\": \"Payment Required\",\n \"type\": \"https://httpstatus.es/402\",\n \"status\": 402,\n \"detail\": \"Pago requerido\"\n}"
description: Pago requerido
'403':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
El cliente no tiene el alcance requerido:
summary: El cliente no tiene el alcance requerido
value: "{\n \"title\": \"Forbidden\",\n \"type\": \"https://httpstatus.es/403\",\n \"status\": 403,\n \"detail\": \"Alcance no válido\"\n}"
description: Prohibido
'404':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
No se encontró la conversación:
summary: No se encontró la conversación
value: "{\n \"title\": \"Not Found\",\n \"type\": \"https://httpstatus.es/404\",\n \"status\": 404,\n \"detail\": \"No se encontró la conversación\"\n}"
description: No se encontró la conversación
parameters:
- in: path
name: talk_id
schema:
type: integer
required: true
description: ID de la conversación
- in: query
name: page
schema:
type: integer
description: Página de resultados
- in: query
name: limit
schema:
type: integer
description: 'Cantidad de entidades retornadas por solicitud (límite: 250)'
- in: query
name: filter[created_at][from]
schema:
type: integer
required: false
description: Filtra por la fecha de envío del mensaje en formato Unix Timestamp. Retorna los mensajes enviados desde esta fecha.
- in: query
name: filter[created_at][to]
schema:
type: integer
description: Filtra por la fecha de envío del mensaje en formato Unix Timestamp. Retorna los mensajes enviados hasta esta fecha.
summary: Obtener mensajes de una conversación
operationId: get_api-v4-talks-1
description: El método permite recuperar los mensajes de una conversación.
tags:
- Talks
servers:
- url: https://{subdominio}.kommo.com
variables:
subdominio:
default: subdominio
/api/v4/talks/{talk_id}/send_message:
post:
responses:
'202':
content:
application/json:
schema:
type: object
properties:
id:
type: string
example: ec1cadc7-4963-4c53-81c4-7e6ed05b92db
examples:
Solicitud aceptada:
summary: Solicitud aceptada
value:
id: ec1cadc7-4963-4c53-81c4-7e6ed05b92db
description: Aceptado
'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\": \"NotBlank\",\n \"path\": \"text\",\n \"detail\": \"Este valor no debe estar vacío.\"\n }\n ]\n }\n ],\n \"title\": \"Bad Request\",\n \"type\": \"https://httpstatus.es/400\",\n \"status\": 400,\n \"detail\": \"La validación de la solicitud falló\"\n}"
description: Solicitud incorrecta
'402':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
Se excedió el límite de la API de Chats:
summary: Se excedió el límite de la API de Chats
value: "{\n \"title\": \"Payment Required\",\n \"type\": \"https://httpstatus.es/402\",\n \"status\": 402,\n \"detail\": \"Se excedió el límite de la API de Chats\"\n}"
Plan de suscripción insuficiente:
summary: Plan de suscripción insuficiente
value: "{\n \"title\": \"Payment Required\",\n \"type\": \"https://httpstatus.es/402\",\n \"status\": 402,\n \"detail\": \"El endpoint no está disponible para el plan actual de la cuenta\"\n}"
Suscripción caducada:
summary: Suscripción caducada
value: "{\n \"title\": \"Payment Required\",\n \"type\": \"https://httpstatus.es/402\",\n \"status\": 402,\n \"detail\": \"Pago requerido\"\n}"
description: Pago requerido
'403':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
El cliente no tiene el alcance requerido:
summary: El cliente no tiene el alcance requerido
value: "{\n \"title\": \"Forbidden\",\n \"type\": \"https://httpstatus.es/403\",\n \"status\": 403,\n \"detail\": \"Alcance no válido\"\n}"
description: Prohibido
'404':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
No se encontró la conversación:
summary: No se encontró la conversación
value: "{\n \"title\": \"Not Found\",\n \"type\": \"https://httpstatus.es/404\",\n \"status\": 404,\n \"detail\": \"No se encontró la entidad solicitada\"\n}"
description: No encontrado
'422':
content:
application/problem+json:
schema:
type: object
properties: {}
examples:
La conversación está cerrada:
summary: La conversación está cerrada
value: "{\n \"title\": \"Unprocessable Entity\",\n \"type\": \"https://httpstatus.es/422\",\n \"status\": 422,\n \"detail\": \"La conversación está cerrada\"\n}"
description: Entidad no procesable
parameters:
- in: path
name: talk_id
schema:
type: integer
required: true
description: ID de la conversación
summary: Enviar un mensaje a una conversación
operationId: post_api-v4-talks-talk-id-send-message
requestBody:
content:
application/json:
schema:
type: object
properties:
text:
type: string
description: Texto del mensaje
attachment:
type: object
properties:
type:
type: string
description: Tipo de archivo adjunto
enum:
- file
- video
- picture
drive_uuid:
type: string
description: UUID del archivo en Kommo Drive (https://es-developers.kommo.com/reference/m%C3%A9todos-de-api-de-archivos)
drive_version_uuid:
type: string
description: UUID de la versión del archivo en Kommo Drive (https://es-developers.kommo.com/reference/m%C3%A9todos-de-api-de-archivos)
required:
- type
- drive_uuid
- drive_version_uuid
description: Objeto del archivo adjunto
description: El método permite enviar un mensaje a una conversación.
tags:
- Talks
servers:
- url: https://{subdominio}.kommo.com
variables:
subdominio:
default: subdominio
/api/v4/talks/{id}:
get:
summary: Get conversation by ID
description: The method allows you to obtain data for a specific conversation by its ID
operationId: get-conversation
parameters:
- name: id
in: path
description: Conversation ID
schema:
type: integer
format: int32
required: true
responses:
'200':
description: Request Successful
content:
application/hal+json:
examples:
Request Successful:
value: "{\n \"talk_id\": 111,\n \"created_at\": 1631018291,\n \"updated_at\": 1631035929,\n \"rate\": 9,\n \"contact_id\": 28374713,\n \"chat_id\": \"1111111-bbbb-2222-cccc-121345678hj\",\n \"entity_id\": 37262129,\n \"entity_type\": \"lead\",\n \"is_in_work\": true,\n \"is_read\": true,\n \"origin\": \"telegram\",\n \"missed_at\": null,\n \"account_id\": 17029541,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.kommo.com/api/v4/talks/117\"\n }\n },\n \"_embedded\": {\n \"contacts\": [\n {\n \"id\": 28374713,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.kommo.com/api/v4/contacts/3372695\"\n }\n }\n }\n ],\n \"leads\": [\n {\n \"id\": 37262129,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.kommo.com/api/v4/leads/667999637\"\n }\n }\n }\n ],\n \"customers\": []\n }\n}"
summary: Request Successful
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
'401':
description: '401'
content:
text/plain:
examples:
Result:
value: ''
'402':
description: '402'
content:
text/plain:
examples:
Result:
value: ''
'403':
description: '403'
content:
text/plain:
examples:
Result:
value: ''
'404':
description: '404'
content:
text/plain:
examples:
Conversation not found:
value: ''
tags:
- Talks
servers:
- url: https://{subdomain}.kommo.com
variables:
subdomain:
default: subdomain
/api/v4/talks/{id}/close:
post:
summary: Close conversation
description: Method allows you to launch a NPS bot or close a conversation by its ID. NPS bot is being launched only when it is enabled in the account settings, available in your plan and no force_close parameter is supplied.
operationId: close-conversation
parameters:
- name: id
in: path
description: Conversation ID
schema:
type: integer
format: int32
required: true
- name: Content-Type
in: header
description: Request header
schema:
type: string
default: application/json
requestBody:
content:
application/json:
schema:
type: object
properties:
force_close:
type: boolean
description: In order to close a conversation without a NPS bot launch it is required to pass a force_close parameter with value of true. It is false by default
examples:
Request Example:
value:
force_close: true
responses:
'202':
description: '202'
content:
application/json:
examples:
Successful request:
value: '{}'
schema:
type: object
properties: {}
'401':
description: '401'
content:
application/json:
examples:
User is unauthorized:
value: '{}'
schema:
type: object
properties: {}
'402':
description: '402'
content:
text/plain:
examples:
Unpaid account:
value: ''
'403':
description: '403'
content:
text/plain:
examples:
Result:
value: ''
'404':
description: '404'
content:
text/plain:
examples:
Conversation not found:
value: ''
'422':
description: '422'
content:
text/plain:
examples:
Conversation has already been closed/ is being closed:
value: ''
tags:
- Talks
servers:
- url: https://{subdomain}.kommo.com
variables:
subdomain:
default: subdomain
components:
securitySchemes:
sec0:
type: oauth2
flows: {}
x-refined-from:
- kommo-api-openapi.yml
- kommo-api-references-api-openapi.yml
x-readme-fauxas: true
x-provenance:
method: searched
source: https://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://developers.kommo.com/reference/ai-add-source-file.md
- https://developers.kommo.com/reference/ai-add-source-text.md
- https://developers.kommo.com/reference/ai-add-source-url.md
- https://developers.kommo.com/reference/launch-import-of-products-from-crm-to-ai.md
- https://pt-developers.kommo.com/reference/ai-add-source-file.md
- https://pt-developers.kommo.com/reference/ai-add-source-text.md
- https://pt-developers.kommo.com/reference/ai-add-source-url.md
- https://pt-developers.kommo.com/reference/launch-import-of-products-from-crm-to-ai.md
merge:
pages: 8
deduped: 7
conflicts_kept_first: 4