Новый черновик

POST/drafts

Кладёт черновик в беседу, тред или личную переписку. В интерфейсе Пачки он появляется в поле ввода этого чата, где сотрудник его допишет и отправит. Этим же методом создаётся отложенное сообщение: с полем schedule черновик уходит сам в назначенное время, без него просто лежит. Сам метод ничего не отправляет: черновик отправляют методом POSTНовое сообщение, передав в него content и parent_message_id черновика, а у каждого файла из files — key, name и file_type. Отправка сообщения черновик не удаляет: приложение Пачки убирает его само, а через API — методом DELETEУдаление черновика, иначе текст останется в поле ввода.

Черновик виден только своему автору — его не видит ни собеседник, ни администратор пространства. Обычный черновик в чате может быть только один. Повторный вызов отвечает 409 с кодом already_exists и номером существующего в payload.draft_id. Дописывают его методом PUTРедактирование черновика. Отложенных сообщений на один чат — не больше 50.

Для треда в entity_id передают идентификатор самого треда, а не сообщения, под которым он висит. Личной переписки с сотрудником может ещё не быть — тогда она заводится сама, как при обычной отправке сообщения.

Пустой черновик создать нельзя: нужен либо текст, либо вложения.

Токенам ботов метод недоступен.

Тело запроса

application/json

Собранный объект параметров черновика

Куда пишется черновик: в беседу или канал, в тред либо в личную переписку с сотрудником

Возможные значения

Пример:discussion

Идентификатор того, что названо в entity_type: беседы или канала, треда либо сотрудника

Пример:334

Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. Поддерживает упоминания, как текст в методе POSTНовое сообщение. <@user_id> остаётся в тексте черновика как передан, а при отправке становится @nickname. До 40 000 байт в UTF-8.

Пример:Отчёт за неделю: продажи выросли на 10%

Идентификатор сообщения, ответом на которое уйдёт черновик. Сообщение должно быть в том же чате.

Пример:196093

Прикрепляемые файлы, не больше десяти

Количество:

<= 10 элементов

Идентификатор уже прикреплённого файла. Передаётся при редактировании, чтобы сохранить вложение как есть. У нового файла не указывается.

Пример:3560

Путь к файлу, полученный в методе POSTЗагрузка файла

Пример:attaches/files/93746/e354fd79-4f3e-4b5a-9c8d-1a2b3c4d5e6f/logo.png

Длина:

<= 1000 символов

Название файла, которое вы хотите отображать пользователю. Действует для нового файла: расширение должно совпадать с расширением файла в key, иначе ответ будет 422 с кодом wrong_params.

Пример:logo.png

Длина:

<= 255 символов

Тип файла

Возможные значения

Пример:image

Размер файла в байтах, отображаемый пользователю. Если не передан или равен 0, Пачка возьмёт размер из хранилища вскоре после сохранения.

Пример:12345

Ширина изображения в пикселях

Пример:800

Высота изображения в пикселях

Пример:600

Длительность в миллисекундах: обязательна у голосового сообщения (voice), по желанию у видео (video), у остальных типов не сохраняется. Файл с длительностью без file_type считается голосовым. Голосовое сообщение длиннее 30 минут (1 800 000 мс) отклоняется с 422 и кодом wrong_params.

Пример:5400

Диапазон:

>= 1

Форма волны для визуализации. Обязательна для голосового сообщения (file_type — voice).

Пример:4,8,12,20,16,10,6,3

Длина:

<= 256 символов

Расписание отправки. С ним создаётся отложенное сообщение, без него — обычный черновик.

Первая отправка (ISO-8601). Из неё берутся время суток, число месяца и день недели, по которым дальше строится повтор. У разовой отправки (once) смещение вида +03:00 учитывается, а время без смещения считается UTC. У повтора время суток, число и день недели берутся как записаны и отсчитываются по UTC: 10:00+03:00 уходит в 10:00 UTC. Поэтому повтор задают в UTC, с Z, переведя в него местное время, и сверяют next_send_at в ответе.

Пример:2026-09-17T12:00:00.000Z

Дата, после которой повтор прекращается (ISO-8601). Без неё повтор идёт бессрочно.

Пример:2026-12-31T12:00:00.000Z

Правило повтора

Периодичность

Возможные значения

Пример:weekly

Дни недели, по которым уходит сообщение: 0 — воскресенье, 6 — суббота, без повторов. Учитывается только при периодичности weekly, а если не передать, берётся день недели из start_date.

Пример:[1,3]

Количество:

<= 7 элементов

Какой по счёту день недели в месяце: от 1 до 4 — первый, второй, третий, четвёртый, 5 — последний. Учитывается только при периодичности по месяцам, а без него повтор идёт по числу месяца из start_date.

Пример:2

Диапазон:

1 — 5

Ответ

201Created

The request has succeeded and a new resource has been created as a result.

Черновик или отложенное сообщение

Идентификатор черновика

Пример:4821

Куда уйдёт сообщение: в беседу или канал, в тред либо в личную переписку с сотрудником

Возможные значения

Пример:discussion

Идентификатор того, что названо в entity_type: беседы или канала, треда либо сотрудника

Пример:334

Идентификатор чата, в котором лежит черновик. У черновика треда это чат самого треда.

Пример:334

Текст черновика. У черновика из одних вложений приходит пустая строка, а не null.

Пример:Отчёт за неделю: продажи выросли на 10%

Идентификатор сообщения, ответом на которое уйдёт черновик. null, если это не ответ.

Пример:196093

Прикреплённые файлы

Идентификатор файла

Пример:3560

Путь к файлу

Пример:attaches/files/12/21zu7934-02e1-44d9-8df2-0f970c259796/congrat.png

Название файла с расширением

Пример:congrat.png

Тип файла

Возможные значения

Пример:image

Ссылка на скачивание файла. Обычно ведёт прямо в хранилище и действует до 7 дней, а оставшийся срок может быть меньше — если такая ссылка вернула 403, запросите сообщение заново и получите свежую. Если в пространстве включено шифрование или задан безопасный контур, ссылка ведёт на GETСкачивание файла: забирать такой файл нужно с заголовком Authorization, а токену нужен скоуп files:read.

Пример:

https://files.example.com/attaches/files/12/21zu7934-02e1-44d9-8df2-0f970c259796/congrat.png?X-Amz-Expires=604800&X-Amz-Signature=98765asgfadsfdSaDSd4sdfg35asdf67sadf8

Ширина изображения в пикселях. null для файлов, не являющихся изображением, а также если размер не был передан при загрузке.

Пример:1920

Высота изображения в пикселях. null для файлов, не являющихся изображением, а также если размер не был передан при загрузке.

Пример:1080

Длительность в миллисекундах у голосового сообщения и видеофайла. null у остальных файлов и если длительность не была передана при загрузке.

Пример:5400

Голосовое сообщение. null, если голосового вложения нет. Расшифровка в transcript и её статус в transcript_status у черновика всегда null — она запускается после отправки.

Длительность голосового сообщения в миллисекундах

Пример:5400

Форма волны (амплитуды) для визуализации голосового сообщения

Пример:4,8,12,20,16,10,6,3

Расшифровка голосового сообщения в текст. null, пока расшифровка не готова или недоступна.

Пример:Привет, посмотри пожалуйста последний отчёт

Статус расшифровки. null, если расшифровка не запрашивалась: она выключена в пространстве, файл зашифрован, это черновик или сообщение отправлено до появления этого поля и расшифровки у него нет. При success текст лежит в transcript, а пустая строка в нём означает, что речи в записи нет. Статусом failed приходит и расшифровка, которая долго не завершается, поэтому он ещё может смениться на success.

Возможные значения

Пример:success

Расписание отправки. null у обычного черновика.

Первая отправка (ISO-8601). Из неё берутся время суток, число месяца и день недели, по которым дальше строится повтор.

Пример:2026-09-17T12:00:00.000Z

Дата, после которой повтор прекращается (ISO-8601). null, если конец не задан.

Пример:2026-12-31T12:00:00.000Z

Правило повтора

Периодичность

Возможные значения

Пример:weekly

Дни недели, по которым уходит сообщение: 0 — воскресенье, 6 — суббота. Приходит только при периодичности weekly.

Пример:[1,3]

Какой по счёту день недели в месяце: от 1 до 4 — первый, второй, третий, четвёртый, 5 — последний. Приходит только при периодичности по месяцам, а null в ней означает повтор по числу месяца из start_date.

Пример:2

Ближайшая отправка (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ. null у обычного черновика.

Пример:2026-09-17T12:00:00.000Z

Дата и время создания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ

Пример:2026-09-16T10:00:00.000Z

Дата и время последнего изменения (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ

Пример:2026-09-16T10:00:00.000Z

Новый черновик

pachca drafts create \  --entity-type=discussion \  --entity-id=334 \  --content='Отчёт за неделю: продажи выросли на 10%' \  --json \  --token YOUR_ACCESS_TOKEN

Ответ 201

{  "data": {    "id": 4821,    "entity_type": "discussion",    "entity_id": 334,    "chat_id": 334,    "content": "Отчёт за неделю: продажи выросли на 10%",    "parent_message_id": 196093,    "files": [      {        "id": 3560,        "key": "attaches/files/12/21zu7934-02e1-44d9-8df2-0f970c259796/congrat.png",        "name": "congrat.png",        "file_type": "image",        "url": "https://files.example.com/attaches/files/12/21zu7934-02e1-44d9-8df2-0f970c259796/congrat.png?X-Amz-Expires=604800&X-Amz-Signature=98765asgfadsfdSaDSd4sdfg35asdf67sadf8",        "width": 1920,        "height": 1080,        "duration_ms": 5400      }    ],    "voice_content": {      "duration_ms": 5400,      "waveform": "4,8,12,20,16,10,6,3",      "transcript": "Привет, посмотри пожалуйста последний отчёт",      "transcript_status": "success"    },    "schedule": {      "start_date": "2026-09-17T12:00:00.000Z",      "end_date": "2026-12-31T12:00:00.000Z",      "repetition": {        "interval": "weekly",        "days": [          1,          3        ],        "nth_day": 2      }    },    "next_send_at": "2026-09-17T12:00:00.000Z",    "created_at": "2026-09-16T10:00:00.000Z",    "updated_at": "2026-09-16T10:00:00.000Z"  }}