Свои разговоры в компании, свежие сверху

curl --request GET \
  --url https://api.tungo.kz/v1/companies/{co}/chat \
  --cookie tungo.session_token=

const options = {method: 'GET', headers: {cookie: 'tungo.session_token='}};

fetch('https://api.tungo.kz/v1/companies/{co}/chat', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "6f1c2b9e-0000-4000-8000-000000000000",
      "title": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "message_count": 123,
      "running": true
    }
  ],
  "next_cursor": "aud_01jz8x3m4n5p6q7r8s9t0v1w2x"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

GET

companies

{co}

chat

Свои разговоры в компании, свежие сверху

curl --request GET \
  --url https://api.tungo.kz/v1/companies/{co}/chat \
  --cookie tungo.session_token=

const options = {method: 'GET', headers: {cookie: 'tungo.session_token='}};

fetch('https://api.tungo.kz/v1/companies/{co}/chat', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "6f1c2b9e-0000-4000-8000-000000000000",
      "title": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "message_count": 123,
      "running": true
    }
  ],
  "next_cursor": "aud_01jz8x3m4n5p6q7r8s9t0v1w2x"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

{
  "type": "error",
  "error": {
    "type": "payment_required_error",
    "message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
    "code": "balance_exhausted",
    "permission": "proposals.approve",
    "resets_at": "2026-11-01T19:00:00.000Z",
    "retry_after_seconds": 42,
    "next_request_at": "2026-11-12T09:30:42.000Z",
    "allowed_methods": [
      "email_otp"
    ],
    "role": "<string>",
    "permissions": [
      "<string>"
    ],
    "fields": [
      {
        "path": "bin",
        "code": "invalid_format",
        "message": "БИН/ИИН — 12 цифр"
      }
    ]
  },
  "request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}

Авторизации

tungo.session_token

string

обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Параметры пути

string

обязательно

id компании, co_… — из GET /v1/companies

Параметры запроса

cursor

string

next_cursor из ответа прошлой страницы; без него — первая (самая свежая) страница. Остальные фильтры — те же, что у первой страницы.

limit

integer

Сколько на странице: 1–100, по умолчанию 50

Требуемый диапазон: 1 <= x <= 100

Ответ

Разговоры

Свои разговоры, свежие сверху

data

object[]

обязательно

Разговоры этой страницы, свежие сверху

Show child attributes

next_cursor

string | null

обязательно

Курсор следующей страницы. Чтобы получить её — тот же запрос (с теми же фильтрами) и ?cursor=<это значение>. null — страниц больше нет (кнопку «Ещё» спрятать). Курсор непрозрачный: не разбирать и не собирать самому, хранить только до следующего запроса. Пустой data с не-null курсором не бывает.

Пример:

"aud_01jz8x3m4n5p6q7r8s9t0v1w2x"