---
title: "Obter conversas"
method: GET
path: "/api/v4/talks"
---

# Obter conversas

`GET /api/v4/talks`

## Request

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

Este método retorna uma coleção de conversas existentes na conta.

## Query parameters

- `page` integer
- `limit` integer
- `filter[talk_id][]` integer[]
- `filter[contact_id][]` integer[]
- `filter[entity_id][]` integer[]
- `filter[entity_type]` string
- `filter[only_in_work]` string

## Response `200`

Requisição bem-sucedida

- object
  - `_total_items` integer
  - `_embedded` object
    - `talks` object[]
      - `talk_id` integer
      - `created_at` integer
      - `updated_at` integer
      - `rate` integer
      - `contact_id` integer
      - `chat_id` string
      - `entity_id` integer
      - `entity_type` string
      - `status` string
      - `is_in_work` boolean
      - `is_read` boolean
      - `origin` string
      - `source_id` integer
      - `account_id` integer
      - `_links` object
        - `self` object
          - `href` string
      - `_embedded` object
        - `contacts` object[]
          - `id` integer
          - `_links` object
            - `self` object
              - …
        - `leads` object[]
          - `id` integer
          - `_links` object
            - `self` object
              - …
        - `customers` object[]

## Other responses

- `204`: Sem conteúdo
- `401`: Usuário não autorizado
- `402`: Pagamento necessário

---

[API](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo.md) - [All operations](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/revisions/55101699dddb?raw)