Chat

Идемпотентно отправить текстовое сообщение

Один client_message_id с другим canonical body возвращает 409 без echo исходного текста. При создании сообщения сервер в той же транзакции отмечает для автора прочитанной предшествующую ленту до new_seq - 1; повтор запроса watermark заново не двигает. mention_user_ids — только участники беседы: упоминание постороннего отклоняет сообщение целиком (422, code=mention_not_member), уведомление не уходит. Исключение — беседа задачи: упомянутый до отправки становится наблюдателем задачи и участником беседы и получает уведомление (CHAT.md § 3.3).

post/api/v1/chat/conversations/{id}/messages

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/chat/conversations/{id}/messages
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)

Request body

client_message_idstring uuid required
bodystring

Текст сообщения; без attachment_ids обязателен, с ними — подпись к вложениям и может быть пустым. Предел считается в кодовых точках, а не в байтах: сервер режет по 10 000 кодовых точек

reply_to_message_idstring uuid
mention_user_idsinteger[]
attachment_idsUUID[]

Готовые вложения этой беседы — id из завершения сессии загрузки или из списка вложений. Не сочетаются с mention_user_ids в одном сообщении

reply_quotestring

Цитата части исходного сообщения, как в Телеграме: дословный кусок его текста, не длиннее 1024 кодовых точек. Только вместе с reply_to_message_id; фрагмента нет в исходном — 404. Пустая строка — ответ на сообщение целиком

support_reportboolean

Сообщение формы «Сообщить об ошибке». В чате поддержки открывает новое обращение и новую заявку, даже если в беседе уже есть открытое; обычное сообщение продолжает открытое. В любой другой беседе — 400

Response

Повтор ранее зафиксированной отправки

createdboolean required

Example response

{
  "message": {
    "attachments": [
      {
        "content_url": "/api/v1/chat/attachments/00000000-0000-0000-0000-000000000001/content"
      }
    ]
  }
}

Changes

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