Вложения
Вложения
Отправка и приём файлов агентами.
Что такое Attachments?
Attachment — файл, связанный с Message. Это может быть счёт PDF, отчёт CSV или изображение (хотя в первом письме изображения лучше не слать — подробнее в разделе доставляемости). Агенты могут и отправлять Attachments в исходящих Messages, и обрабатывать вложения во входящих Messages.
Отправка Attachments
Чтобы отправить файл, передайте массив Attachments при отправке Message. Каждый элемент — один файл; обязательно поле content.
content(обязательно): содержимое файла в Base64.filename(необязательно): имя файла (напримерinvoice.pdf).content_type(необязательно): MIME-тип (напримерapplication/pdf).
Получение Attachments
Нужен attachment_id из массива attachments объекта Message. По ID можно скачать файл.
Ответ API при получении вложения — сырые байты файла; их можно сохранить на диск или обработать в памяти.
Из конкретного Message
Если известны inbox, сообщение и вложение — запрос напрямую.
Из конкретного Thread
То же, если известны inbox, тред и вложение — удобно для длинных переписок.
Скопировать в Cursor / Claude
Скопируйте один из блоков ниже для полного контекста по вложениям.
