Перейти к основному содержимому

Сервисное письмо по событию

Трек-номер, смена статуса заказа, напоминание об оплате: ваша система делает один запрос, Mailganer сразу отправляет письмо покупателю. Пример ниже для трек-номера, остальные сценарии настраиваются так же.

1. Триггер в личном кабинете​

  1. В разделе Триггеры создайте триггер и выберите список.
  2. Событие: "Вызов API метода" (группа "События, связанные с API"), время отправки "Сразу".
  3. Сверстайте письмо. Данные из запроса подставляются переменными:
<p>Здравствуйте, {{ first_name }}!</p>
<p>Заказ № {{ order_id }} передан в доставку.</p>
<p>Трек-номер: <a href="{{ track_url }}">{{ track_number }}</a></p>
  1. Запустите триггер. После модерации он начнёт принимать запросы.

ID триггера есть в адресе страницы: https://mailganer.com/app/trigger/12345/.

2. Запрос из вашей системы​

Как только у заказа появился трек-номер, отправьте POST /api/v2/triggers/{trigger_id}/send/:

curl --location 'https://mailganer.com/api/v2/triggers/12345/send/' \
--header 'Authorization: CodeRequest ВАШ_API_КЛЮЧ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "buyer@example.com",
    "variables": {
        "first_name": "Анна",
        "order_id": 10482,
        "track_number": "80081234567890",
        "track_url": "https://example.com/track/80081234567890"
    }
}'

Ответ при успешной отправке:

{
    "status": 1,
    "updated_variables": [],
    "status_text": "Success. Complete <TriggerEmail[191015674]> on 0.453127 sec.",
    "result": 191015674
}

result это ID отправки. Если status не равен 1, причина будет в поле error, список ошибок есть в описании метода. Частота: не больше 300 запросов в минуту.

Если покупатель отписался от рассылок​

По умолчанию письмо не уйдёт адресу со статусом "Отписался". Для сервисных писем можно включить параметр ignore_unsubscribed: true. Параметр doi_ok: true добавит покупателя в список активным подписчиком перед отправкой. Оба параметра подключает поддержка.

Чтобы письма попадали во входящие​

  • Только сервисное содержание: номер заказа, трек-номер, ссылка на отслеживание. Акции и баннеры отправляйте отдельной рассылкой.
  • Отправитель на вашем домене с настроенными SPF и DKIM.

SMS​

Тот же сценарий работает с SMS-триггером: добавьте в запрос phone.