Аутентификация API

REST API Chato аутентифицируется через API-ключ рабочего пространства — отдельный от вашей личной сессии в браузере. Ключ действует от имени владельца рабочего пространства и даёт полный доступ к REST API.

Получение ключа

Ключ создаётся в личном кабинете: Настройки → API-ключ → «Сгенерировать». Chato показывает сырой ключ только один раз, сразу после генерации — сохраните его сразу, повторно посмотреть не получится. Перевыпуск ключа немедленно отзывает предыдущий: все интеграции, использующие старый ключ, перестанут работать.

Базовый адрес

https://chato.kz/api/v1

Как использовать

Передавайте ключ в заголовке Authorization в каждом запросе:

GET /workspaces
Authorization: Bearer chato_sk_...

Этот запрос вернёт список ваших рабочих пространств вместе с их id — он понадобится почти во всех остальных запросах как :workspaceId.

Основные эндпоинты

Список каналов:

GET /workspaces/:workspaceId/channels

Список диалогов (фильтры: status, assigned=me|none, пагинация через cursor/limit):

GET /workspaces/:workspaceId/conversations?status=OPEN&limit=30

Начать диалог с новым номером на конкретном канале:

POST /workspaces/:workspaceId/conversations/start
Content-Type: application/json

{ "channelId": "clx...", "phone": "77011234567" }

Сообщения диалога:

GET /workspaces/:workspaceId/conversations/:conversationId/messages

Отправить сообщение:

POST /workspaces/:workspaceId/conversations/:conversationId/messages
Content-Type: application/json

{ "content": "Здравствуйте!" }

Ограничения

Ключ действует, пока не отозван вручную в кабинете. Он не имеет собственного времени жизни (в отличие от JWT-сессии браузера) — отзыв или перевыпуск через кабинет остаются единственным способом деактивировать его.