SparkPost Mail Transport 3.1.1

Добавляет возможность использования почтового транспорта SparkPost для отправки всех писем через вашу учетную запись SparkPost.

Этот аддон полностью поддерживает обработку отклоненных писем и писем от неподписавшихся пользователей с помощью SparkPost Events API — почтовый ящик не требуется.

Обновление

Важно: перед обновлением сайта до XenForo 2.3 необходимо отключить аддон SparkPost Mail Transport v2.x на сайте XF 2.2. Если этого не сделать, после обновления до XF 2.3 сайт может перестать работать.

Если после обновления до XenForo 2.3 ваш сайт перестал работать, отключите аддоны, установив следующее значение в файле config.php: - затем обновите аддон SparkPost до версии XF 2.3 (SparkPost Mail Transport v3.x) - затем удалите настройку из файла config.php:

$config['enableListeners'] = false;

Setup

Если вы еще этого не сделали, вам нужно будет настроить домен отправки для вашего форума в учетной записи SparkPost. Настоятельно рекомендуется также настроить домен возврата.

Затем вам нужно будет создать ключ API со следующими разрешениями:

• Поиск событий: только чтение
• Передачи: чтение/запись

После создания ключа API измените способ отправки электронной почты на странице настроек электронной почты на "SparkPost" и вставьте ключ API в соответствующее поле.





Конфигурация

Как видно на скриншоте выше, при настройке SparkPost можно задать некоторые параметры транспорта.

• Отслеживание кликов включает отслеживание кликов по всем ссылкам в отправленных электронных письмах
• Отслеживание открытий добавляет изображение для отслеживания во все отправленные электронные письма, чтобы отслеживать открытия
• Тестовый режим добавляет '.sink.sparkpostmail.com' ко всем адресам электронной почты получателей, чтобы мы могли протестировать связь со SparkPost, не отправляя электронные письма получателям.

Обратите внимание, что перед включением отслеживания кликов или открытий настоятельно рекомендуется настроить собственный домен отслеживания.

Существует дополнительная страница конфигурации под заголовком опции SparkPost Mail.:

• Размер пакета событий позволяет настроить, сколько событий система будет пытаться получить в каждом пакете. Как правило, нет необходимости менять значение по умолчанию.

Тестирование

Вы можете протестировать функциональность дополнения, используя встроенную в XenForo систему тестирования электронной почты - перейдите в интерфейс администратора> Инструменты> Протестировать исходящую электронную почту.



Обратите внимание, что класс транспортировки электронной почты должен быть \Hampel\Symfony\Mailer\SparkPost\Transport\SparkPostApiTransport - если это не так, значит, вы неправильно установили или активировали дополнение.

Существует также второе средство тестирования, которое позволяет вам указать, отправлять электронные письма с транзакциями или без транзакций. Перейдите в интерфейс администратора> Инструменты> Протестировать SparkPost



Установите флажок для отправки транзакционного электронного письма - отключите его для отправки нетранзакционного.

В любом случае вам следует проверять заголовки получаемых писем, чтобы убедиться, что они действительно отправлены через SparkPost, а также наличие или отсутствие заголовка List-Unsubscribe (этот заголовок должен присутствовать в письмах, не связанных с транзакциями, и отсутствовать в транзакционных письмах).

Транзакционные и нетранзакционные электронные письма

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

Примеры транзакционных электронных писем:

• письма для создания и активации учетной записи
• сбросы пароля и двухфакторная аутентификация
• безопасность и оповещения об учетной записи
• уведомления, связанные с выбранными пользователем подписками или оповещениями
• уведомления о покупках и доставке
• юридические и важные уведомления на сайте

Нетранзакционные электронные письма (также называемые коммерческими) обычно рассылаются группе пользователей массово (хотя они могут быть и персонализированными) и содержат рекламные или маркетинговые материалы. Обычно их получают только те пользователи, которые дали согласие на получение таких материалов от вас.

Примеры не транзакционных писем:

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

На сайте SparkPost можно найти дополнительную информацию о транзакционных и коммерческих письмах.

По умолчанию SparkPost помечает все письма, отправленные через их API, как «не транзакционные». Этот аддон меняет это поведение и делает все письма на форуме транзакционными, за исключением:

• Электронные письма, отправляемые через пользовательский интерфейс администратора - Общение> Электронная почта пользователям
• Приветственные электронные письма

Между транзакционными и не транзакционными письмами, отправленными через SparkPost, есть два существенных различия:

1. К нетранзакционным письмам добавляется заголовок List-Unsubscribe (переопределяет заголовок, добавляемый XenForo) для запросов на отписки в один клик в некоторых почтовых клиентах. Транзакционные письма не содержат этого заголовка.
2. Существуют отдельные списки для транзакционных и нетранзакционных писем. Если кто-то отписался от нетранзакционных писем, вы все равно можете отправлять ему важные транзакционные письма, например о подписке на форум или сбросе пароля. Однако если кто-то отписался от вас или заблокировал вас в транзакционных письмах, вам следует удалить его аккаунт, поскольку вы больше не сможете отправлять ему письма с важной информацией с форума.

Подробнее о списках подавления см. ниже.

Обработка отказов от подписки и отписок

Функция автоматической обработки возвратов и отписок в дополнении проверяет все стандартные жесткие и мягкие возвраты, которые могут быть получены в результате отправки электронных писем. Эти возвращенные письма перехватываются SparkPost, и мы можем выполнить запрос, чтобы определить, какое действие нужно предпринять.

Вам НЕ нужно настраивать «адрес для возвращенных писем» (если только у вас не настроен домен по умолчанию для возвращенных писем) или «адрес для писем с отписками» в настройках электронной почты. Вам также не нужно включать параметры «Автоматическое обращение к обработчику электронной почты» или «Включить автоматическое обращение к обработчику электронной почты» — SparkPost не пересылает возвращенные письма или уведомления об отписке по электронной почте. Мы запрашиваем информацию о возврате письма или отписке через их API.

Обработка отписки немного сложнее, чем в стандартной системе XenForo, поскольку мы различаем транзакционные и нетранзакционные письма и обрабатываем их по-разному.

Обратите внимание, что если мы получим жесткий возврат транзакционных писем, учетная запись пользователя будет заблокирована, чтобы предотвратить дальнейшую отправку писем.

Списки для подавления

Если SparkPost получает жесткий отказ от доставки отправленного письма или запрос на отмену подписки, он помещает этот адрес электронной почты в список блокировки, то есть вы больше не сможете отправлять письма этому пользователю. Это делается для защиты вашей репутации отправителя, поскольку отправка писем на недействительный адрес или адрес, с которого пользователь отписался, является признаком спама и может привести к блокировке вашего аккаунта некоторыми почтовыми сервисами.

Следует иметь в виду, что если учетная запись пользователя на форуме была заблокирована из-за возвращенных писем, то, скорее всего, она также была добавлена в список блокировки SparkPost. Если вы снова активируете учетную запись, не меняя адрес электронной почты, пользователь может не получать письма с вашего сайта, поскольку их отправка заблокирована SparkPost.

Если вы уверены, что адрес электронной почты действителен, вы можете удалить его из списка блокировки SparkPost в консоли администратора SparkPost — https://app.sparkpost.com/lists/suppressions.

Просто помните, что есть два отдельных списка: один для транзакционных писем, другой — для не транзакционных.