Drafts

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

Кладёт черновик в беседу, тред или личную переписку. В интерфейсе Пачки он появляется в поле ввода этого чата, где сотрудник его допишет и отправит. Этим же методом создаётся отложенное сообщение: с полем schedule черновик уходит сам в назначенное время, без него просто лежит. Сам метод ничего не отправляет, для отправки есть [Новое сообщение](POST /messages).

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

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

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

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

post/drafts

Request

  • Base URL: https://api.pachca.com/api/shared/v1
  • URL: https://api.pachca.com/api/shared/v1/drafts
  • Auth: HTTP bearer

Request body

Example request

{
  "draft": {
    "entity_id": 334,
    "content": "Отчёт за неделю: продажи выросли на 10%",
    "parent_message_id": 196093,
    "files": [
      {
        "id": 3560,
        "key": "attaches/files/93746/e354fd79-4f3e-4b5a-9c8d-1a2b3c4d5e6f/logo.png",
        "name": "logo.png",
        "size": 12345,
        "width": 800,
        "height": 600,
        "duration_ms": 5400,
        "waveform": "4,8,12,20,16,10,6,3"
      }
    ],
    "schedule": {
      "start_date": "2026-09-17T12:00:00.000Z",
      "end_date": "2026-12-31T12:00:00.000Z",
      "repetition": {
        "days": [
          1,
          3
        ],
        "nth_day": 2
      }
    }
  }
}

Response

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

Example response

{
  "data": {
    "id": 4821,
    "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",
        "url": "https://pachca-prod-uploads.s3.storage.selcloud.ru/attaches/files/12/21zu7934-02e1-44d9-8df2-0f970c259796/congrat.png?response-cache-control=max-age%3D3600%3B&response-content-disposition=attachment&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=142155_staply%2F20231107%2Fru-1a%2Fs3%2Faws4_request&X-Amz-Date=20231107T160412&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&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": "Привет, посмотри пожалуйста последний отчёт"
    },
    "schedule": {
      "start_date": "2026-09-17T12:00:00.000Z",
      "end_date": "2026-12-31T12:00:00.000Z",
      "repetition": {
        "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"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.