Mail messages

Отправить письмо или сохранить черновик

При save_as_draft равном true письмо только СОХРАНЯЕТСЯ в «Черновиках» и ждёт человека — получателю оно не уходит. Без этого признака письмо встаёт в очередь отправки; после принятия SMTP-сервером его нельзя отозвать, но это принятие не подтверждает доставку или прочтение получателем. Для агента черновик — единственный способ подготовить ответ, не отправив его от чужого имени без подтверждения. В одном письме не больше 200 получателей и не больше 20 файлов. С send_at письмо откладывается: ждёт в «Исходящих» до этого времени, пока его не отправят сразу (send-now) или не вернут в черновики (cancel-send). Замена черновика (replace_draft_id) атомарна: прежняя версия удаляется той же записью. Устаревший replace_draft_id (вторая вкладка, повтор) заменяет живого преемника этого черновика, а не создаёт второй; если преемник уже отправлен — 409 mail.draft_sent, и ничего не сохраняется. Отправленное или чужое письмо по replace_draft_id не заменяется — 404.

post/api/v1/mail/accounts/{id}/messages

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/mail/accounts/{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

subjectstring
tostring[]

Одна строка может содержать несколько адресов через запятую

ccstring[]
bccstring[]
body_textstring
body_htmlstring
in_reply_to_idstring uuid
forward_of_idstring uuid
upload_idsUUID[]

Идентификаторы заранее загруженных файлов

save_as_draftboolean

Значение true СОХРАНЯЕТ письмо в «Черновиках» и не отправляет его; без признака письмо встаёт в очередь, а принятие SMTP-сервером не подтверждает доставку или прочтение получателем

replace_draft_idstring uuid
keep_attachment_idsUUID[]

Вложения заменяемого черновика, которые остаются в письме; только вместе с replace_draft_id

send_atstring date-time nullable

Отложенная отправка: письмо ждёт в «Исходящих» до этого времени. Время в прошлом — 400 mail.schedule_past, дальше года — 400 mail.schedule_too_far, вместе с save_as_draft — 400 mail.schedule_draft

Response

Созданное письмо и его запись в очереди отправки

Changes

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