Контекстные переменные

С помощью использования контекста, вы можете создавать персонализированные рассылки. Для этого вы можете использовать простой синтаксис шаблонизации: переменные в письме выделяются символами #, например, #username#.

При отправке переменные, выделенные таким образом, будут заменены на значения переменных из context. В сопутствующем примере, #username# будет заменено на John Doe, а #balance# - на 1000 RUB.

Существуют зарезервированные переменные:

  • #unsubscribe_url# - переменная должна быть помещена в каждое отправляемое письмо в случае массовой (BULK) рассылки. Без данной переменной в теле письма, в случае массовой (BULK) рассылки, отправка запрещена (см. Анти-спам соглашение). Рекомендуется размещать в нижней части письма, после основного содержания. Вы не должны передавать значение этой переменной в контексте письма, достаточно только разместить тег #unsubscribe_url# в теле вашего письма.

  • #unsubscribe_message# - В качестве значения данной переменной вы можете передать текст, который будет отображен пользователю в сообщении, которое он увидит после перехода по данной ссылке. Текст не должен содержать html разметку.

Пример данных запроса с использованием контекстных переменных:

{
"type":"BULK",
"subject":"Hello world!",
"html_body":"Hello dear #username#. How are you? Please click on this link! <a href=\"http://mailhandler.ru\">Click click</a>. To unsubscribe from these emails, click here - <a href=\"#unsubscribe_url#\">unsubscribe</a>.",
"reply_to":["[email protected]"],
"bcc":["[email protected]"],
"tag":"Sample tag",
"headers":{"Foo":"Bar"},
"context":{"username":"Bob"},
"disable_inline":true
}

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

{
"type":"BULK",
"subject":"Hello world!",
"html_body":"Hello dear #username#. How are you? Please click on this link! <a href=\"http://mailhandler.ru\">Click click</a>. To unsubscribe from these emails, click here - <a href=\"#unsubscribe_url#\">unsubscribe</a>.",
"reply_to":["[email protected]"],
"bcc":["[email protected]"],
"tag":"Sample tag",
"headers":{"Foo":"Bar"},
"context":{"[email protected]": {"username":"Bob"}, "[email protected]": {"username": "Alice"}},
"disable_inline":true
}