Разговоры
Список обращений, карточка разговора, закрытие. Поля объекта conversation.
Список разговоров #
GET /api/v1/conversations conversations:read
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| status | string | нет | open, pending, resolved или closed |
| since | RFC 3339 | нет | только изменённые после этого времени |
| cursor | RFC 3339 | нет | продолжение предыдущей страницы |
| limit | int | нет | 1…100, по умолчанию 25 |
curl -s "https://api.widgetchat.ru/api/v1/conversations?status=open&since=2026-08-22T00:00:00Z" -H "Authorization: Bearer wck_…"{"data": [ /* объекты conversation */ ], "nextCursor": "…", "hasMore": true}Один разговор #
GET /api/v1/conversations/{id} conversations:read
Номер разговора — UUID. Разговор чужого сайта отвечает 404, а не 403: существование чужих номеров тоже сведения.
Объект conversation #
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| id | uuid | да | номер разговора |
| status | string | да | open, pending, resolved, closed |
| channel | string | да | всегда app: обращение приходит из виджета |
| visitor.id | string | да | постоянный номер посетителя |
| visitor.name | string | нет | имя, если сайт его передал |
| visitor.email | string | нет | почта, если сайт её передал |
| visitor.organization | string | нет | организация из подписанного токена |
| visitor.accountId | string | нет | ваш номер клиента из подписанного токена |
| visitor.role | string | нет | роль посетителя из подписанного токена |
| source | string | нет | откуда пришло обращение |
| createdAt | RFC 3339 | да | когда заведено |
| lastMessageAt | RFC 3339|null | нет | время последнего сообщения |
| lastReadAt | RFC 3339|null | нет | до какого момента посетитель прочитал |
В visitor попадают только сведения, которые сайт сам передал подписанным токеном. Служебные пометки разговора — номер темы Telegram, чат открытой линии — наружу не отдаются.
Закрыть разговор #
POST /api/v1/conversations/{id}/close conversations:write
Закрытый разговор перестаёт принимать ответы: следующее сообщение посетителя заведёт новое обращение. Повторное закрытие ошибкой не считается и события не порождает.
{"data": {"id": "6c82f8e2-…", "status": "closed"}}