Chatonio

Обновление диалога

7 июля 2026 г. ПросмотрыChatonio API

Обновить диалог

Измените статус и/или приоритет диалога. Смена статуса подчиняется тем же правилам, что и в панели оператора.

PATCH/api/v1/conversations/{id}/

Обновить статус и/или приоритет.

Запрос

Тело
{
  "status": "RESOLVED"
}

Ответы

200Успех
{
  "id": "3f2b1c9a-7d4e-4b21-9c33-0a1b2c3d4e5f",
  "status": "PROCESSING",
  "priority": "HIGH",
  "subject": "Refund request",
  "source": "CHANNEL",
  "channel_id": "9a1c5f30-2b6d-4c71-8e42-1a2b3c4d5e6f",
  "channel_type": "TELEGRAM",
  "ticket_number": 1042,
  "detected_language": "en",
  "message_count": 7,
  "contact": { "id": "7c4e9b02-1a55-4e88-b0d1-2f3a4b5c6d7e", "display_name": "Jane Doe" },
  "created_at": "2026-07-01T10:12:00+00:00",
  "updated_at": "2026-07-01T10:40:00+00:00",
  "last_message_at": "2026-07-01T10:40:00+00:00"
}
400Недопустимый переход
{ "detail": "Cannot transition from NEW to WAITING" }

Поля тела

  • status — необязательно; целевой статус.
  • priority — необязательно; LOW / MEDIUM / HIGH / URGENT.
  • escalation_reason — обязательно при установке статуса ESCALATING.

Правила

  • PROCESSING здесь установить нельзя — он достигается только назначением оператора (400 use_assignment_to_reach_processing).
  • Установка ESCALATING требует непустого escalation_reason и уведомляет операторов.
  • Разрешены только допустимые переходы; недопустимый возвращает 400 с пояснением.
  • Лимит: 60 запросов/минуту на API-ключ.

Вебхук conversation.status_changed срабатывает при любой смене статуса — включая сделанные через этот эндпоинт.

Эта статья была полезной?