POST /tickets — обращение клиента

Заводит обращение от клиента — как заявка с формы сайта или письмо. Клиент узнаётся по почте и телефону, команда получает уведомление, срабатывают правила автоматизаций, а Нейтрон отвечает, если он включён. Право — tickets:write, у сотрудника ключа — право создавать тикеты.

Запрос

curl https://app.deskus.ru/api/v1/tickets \
  -H "Authorization: Bearer $DESKUS_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4821" \
  -d '{
    "subject": "Не пришёл заказ №4821",
    "message": "Заказала кило эфиопии три дня назад, посылки нет.",
    "client": { "name": "Мария Котова", "email": "maria@example.com", "phone": "+7 900 123-45-67" },
    "priority": "high"
  }'

Ответ 201

{
  "data": {
    "id": "0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10",
    "number": "T-1042",
    "subject": "Не пришёл заказ №4821",
    "status": "new",
    "priority": "high",
    "channel": "API",
    "client_id": "5f1a9e7c-2b3d-4e8f-a0c1-7d6b5e4f3a21",
    "assignee_id": null,
    "team_id": null,
    "merged_into_id": null,
    "snoozed_until": null,
    "created_at": "2026-10-21T09:15:04.218Z",
    "updated_at": "2026-10-21T09:15:04.218Z",
    "last_activity_at": "2026-10-21T09:15:04.218Z",
    "closed_at": null,
    "url": "https://app.deskus.ru/tickets/0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10"
  }
}

Поля

Как узнаётся клиент

• Почта — без учёта регистра, телефон — по последним цифрам: +7 (900) 123-45-67 и 89001234567 — один клиент.

• Карточку объединили с другой — тикет попадёт к основной. Удалённые карточки не подхватываем.

• Нет ни почты, ни телефона — заводим карточку «Клиент» или с именем из client.name.

• Каждый запрос — новый тикет, даже от того же клиента. Чтобы не завести дубль при повторе, передавайте Idempotency-Key (подробнее).

Ошибки

Ответ 422

{
  "error": {
    "code": "validation_error",
    "message": "client.email — не похоже на адрес почты.",
    "details": { "field": "client.email" },
    "request_id": "req_3f9c2a7d1e6b4a8c0d2e5f71"
  }
}

• 422 validation_error — нет message, поле длиннее предела, неизвестный приоритет, client_id не найден.

• 403 forbidden — у сотрудника ключа нет права создавать тикеты.