POST /tickets/{id}/messages — ответ и заметка

Ответ клиенту (reply) уходит тем же путём, что из кабинета: в мессенджер или виджет тикета и письмом, если у клиента есть почта. Заметка (note) видна только команде. Право — tickets:write.

Запрос

curl https://app.deskus.ru/api/v1/tickets/T-1042/messages \
  -H "Authorization: Bearer $DESKUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "reply",
    "text": "Мария, посылка уже в пути — **трек** придёт письмом.\n\nЕсли не придёт до пятницы:\n- напишите номер заказа\n- мы отправим зёрна заново"
  }'

Ответ 201

{
  "data": {
    "id": "1f9b3d7e-8a2c-4e5f-b6d1-9c0a4e2f7b38",
    "ticket_id": "0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10",
    "kind": "reply",
    "author": { "name": "Дарья Ветрова", "user_id": "d4e1b7a2-9c3f-4e6d-a5b8-0f2c7e9d1a35" },
    "body": "<p>Мария, посылка уже в пути — <strong>трек</strong> придёт письмом.</p>",
    "text": "Мария, посылка уже в пути — трек придёт письмом.",
    "delivery_status": "sent",
    "created_at": "2026-10-21T09:42:17.031Z"
  }
}

Поля

Как оформить текст

Пишите обычным текстом — Дескус превратит его в разметку ленты, а в мессенджеры отправит как принято там:

Что происходит

• Ответ подписан сотрудником ключа. Первый ответ переводит тикет из «Новый» в «В работе», ответ в закрытый — открывает его снова.

• Ничей тикет достаётся ответившему сотруднику.

• Не доставлено в канал — у сообщения delivery_status: failed, в ленте — запись с причиной.

• Подписчики получат message.created с kind: reply или note (события).

Ошибки

• 422 — нет текста, неизвестный type, close у заметки, в тексте остались пометки Нейтрона «[уточнить: …]».

• 422 с details.missing_fields — для close: true не заполнены обязательные поля тикета.

• 404 — тикета нет.