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

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

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

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

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-писем — узнайте, как будет выглядеть письмо у подписчиков