Kommo Talks API

The Talks API from Kommo — 5 operation(s) for talks.

GitHub OpenAPI

Operations 5

GET /api/v4/talks Obtener conversaciones #
GET /api/v4/talks/{talk_id}/messages Obtener mensajes de una conversación #
POST /api/v4/talks/{talk_id}/send_message Enviar un mensaje a una conversación #
GET /api/v4/talks/{id} Get conversation by ID #
POST /api/v4/talks/{id}/close Close conversation #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kommo:kommo-talks-api"
All apis
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.

Get an API 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 Specification

kommo-talks-api-openapi.yml Raw ↑
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