Как отправить рассылку с вложением

Отправить рассылку с вложением можно через вызов операции.

Сначала файл загружается на отдельный сервер — в ответ получаем его уникальный идентификатор. Дальше, при отправке рассылки через операцию, указываем в вызове этот идентификатор, благодаря чему к письму прикрепляется нужное вложение.

Рассмотрим шаги подробнее.

1. Загрузите вложение на сервер

Инструкция

В результате успешной загрузки должен быть получен уникальный идентификатор файла.

Например,


{
    "fileId": "4d238d4e-20a8-4a44-9388-b16bf206978a"
}

2. Создайте автоматическую email-рассылку

Инструкция

Снимок экрана 2022-11-02 в 19.32.41.png

3. Добавьте операцию с шагом отправки созданной рассылки

Инструкция

Пример настройки:

Снимок экрана 2022-10-27 в 00.08.51.png

Соберите вызов

При использовании в операции шага «Отправить Email», в спецификацию его запроса добавляется контракт для прикрепления файла:

Снимок экрана 2022-10-27 в 00.14.08.png

  • fileId — идентификатор файла, полученный на первом шаге;
  • fileName — как файл будет называться в отправленном письме.

Оба поля обязательны для отправки вложения.

Пример тела запроса:

<operation>
  <customer>
    <email>test@mindbox.ru</email>
  </customer>
  <emailMailing>
    <attachments>
      <attachment>
        <fileName>Док</fileName>
        <body>
          <fileId>4d238d4e-20a8-4a44-9388-b16bf206978a</fileId>
        </body>
      </attachment>   
    </attachments>
  </emailMailing>
</operation>

Отображение в почтовом сервисе:

Снимок экрана 2022-11-02 в 19.31.18.png

Какие файлы можно прикреплять?

Поддерживаются форматы:

application/msword
application/pdf
application/rtf
application/vnd.ms-excel
application/vnd.ms-powerpoint
application/vnd.oasis.opendocument.graphics
application/vnd.oasis.opendocument.presentation
application/vnd.oasis.opendocument.spreadsheet
application/vnd.oasis.opendocument.text
application/vnd.openxmlformats-officedocument.presentationml.presentation
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
application/vnd.openxmlformats-officedocument.wordprocessingml.document
application/x-7z-compressed
application/x-rar-compressed
application/zip
image/gif
image/jpeg
image/pjpeg
image/png
image/svg+xml
image/tiff
image/vnd.microsoft.icon
text/calendar
text/html
text/plain
video/mp4
video/mpeg

Есть ли ограничения по размеру файла?

Максимальный размер письма вместе со всеми вложениями — 25Мб.

Есть ли ограничения по количеству файлов?

Количество вложений не ограничено.

Как посмотреть вложения в отправленных письмах

Просмотр вложений из интерфейса проекта невозможен. Для этого нужно переслать себе письмо из карточки клиента:

Снимок экрана 2022-11-02 в 17.43.36.png

Переслать рассылку с вложением можно только при наличии пермиссии «Переотправка вложений из писем». Изначально она есть только у группы «Владельцы», можно выдать дополнительно.

При отсутствии прав у персонала письмо будет отправлено без вложения.

4 сервиса для тестирования HTML-писем — узнайте, как будет выглядеть письмо у подписчиков