KOkommo

Get conversations

The method returns a collection of conversations in the account.

get/api/v4/talks

Request

  • Base URL
    https://subdomain.kommo.com
  • URL
    https://subdomain.kommo.com/api/v4/talks
  • Auth
    OAuth 2

Query parameters

pageinteger

Page of response

limitinteger

Number of entities returned per request (limit – 250)

filter[talk_id][]integer[]

Filter by conversation ID. Accepts either a single ID or an array of IDs

filter[contact_id][]integer[]

Filter by contact ID. Accepts either a single ID or an array of IDs

filter[entity_id][]integer[]

Filter by entity ID (lead). Accepts either a single ID or an array of IDs. Must be used together with filter[entity_type]

filter[entity_type]'lead'

Entity type for filtering by entity_id. Possible values: lead

filter[only_in_work]string

The parameter is optional and does not require a value. If present, only open conversations are returned

Response

Request successful

_total_itemsinteger

Example response

{
  "_total_items": 1,
  "_embedded": {
    "talks": [
      {
        "talk_id": 249,
        "created_at": 1773754561,
        "updated_at": 1773762171,
        "contact_id": 24602666,
        "chat_id": "307d7d92-6d7c-4f14-aa4f-795b403e9fc5",
        "entity_id": 20139824,
        "entity_type": "lead",
        "status": "in_work",
        "is_in_work": true,
        "origin": "com.amocrm.amocrmwa",
        "source_id": 43444,
        "account_id": 34355163,
        "_links": {
          "self": {
            "href": "https://chatapi1.kommo.com/api/v4/talks/249?page=1&limit=1"
          }
        },
        "_embedded": {
          "contacts": [
            {
              "id": 24602666,
              "_links": {
                "self": {
                  "href": "https://chatapi1.kommo.com/api/v4/contacts/24602666?page=1&limit=1"
                }
              }
            }
          ],
          "leads": [
            {
              "id": 20139824,
              "_links": {
                "self": {
                  "href": "https://chatapi1.kommo.com/api/v4/leads/20139824?page=1&limit=1"
                }
              }
            }
          ]
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.