Отправка триггера (v1)
POST https://mailganer.com/api/v1/trigger/send/
Это устаревший метод и в скором времени он будет отключен. Воспользуйтесь второй версией: https://mailganer.com/documentation/trigger/send/v2
Список параметров запроса (form-data)
Отправлять по API можно любой триггер, не только с событием "Вызов API метода"
Триггер можно отправить на имейл, который есть в списке в статусе активен. В противном случае метод вернёт ошибку "Not found email to site trigger". В исключительных случаях можно запросить активацию дополнительной переменной doi_ok (булев тип). Наличие этой переменной в методе добавляет имейл к списку в статусе "активен".
Для транзакционных триггеров можно запросить активацию дополнительной переменной ignore_unsubscribed и ignore_spam (булев тип). Триггер будет отправлен даже если подписчик в статусе "Отписался от рассылки" или "Пожаловался на спам"
Рекомендуем вызывать метод не более 300 раз в минуту.
В запрос можно вставлять любые переменные, в том числе одномерные и многомерные массивы. В вёрстке письма можно испоьлзовать переменные из запроса и перменные из подписчика одновременно.
Например, имя подписчика может находиться в стандартной переменной {{name}} и записано в данных о подписчике, а перменная "Адрес доставки" не обязательно хранить в Mailganer. Адрес можно передать в запросе в переменной delivery_address и также подставить в вёрстку письма {{delivery_address}}
Например, имя подписчика может находиться в стандартной переменной {{name}} и записано в данных о подписчике, а перменная "Адрес доставки" не обязательно хранить в Mailganer. Адрес можно передать в запросе в переменной delivery_address и также подставить в вёрстку письма {{delivery_address}}
Пример запроса для письма о новом заказе в интернет-магазине
Пример кода на python
import json
import requests
data = {
'trigger_id': 150,
'api_key': '***',
'email': 'test@yandex.ru',
'order_id': 1234,
'first_name': 'Test',
'delivery_address': "Москва, Красная площадь, Кремль",
'goods': json.dumps({
"type": "array",
"value": [
{
"link": "https://domain.ru/products/11021",
"title": "Туфли1",
"cost": "39500",
},
{
"link": "https://domain.ru/products/11022",
"title": "Туфли2",
"cost": "39500",
},
{
"link": "https://domain.ru/products/11023",
"title": "Туфли3",
"cost": "39500",
}
]
})
}
r = requests.request('POST', 'https://mailganer.com/api/trigger/send/', data=data)
print(r.status_code, r.json())Пример кода на php
<?php
$mailganer = 'https://mailganer.com/api/trigger/send/';
$goods = [
"type" => "array",
"value" => [
[
"id" => 11111,
"name" => "TEST1",
"tovar_price_actual" => "79999",
"tovar_price_old" => "99999",
"summa" => "99999",
"tovar_name" => "TEXT",
"tovar_id" => "2030001",
"tovar_url" => "aqqqqs12321",
"tovar_price_actual" => "65",
"tovar_price_old" => "98"
],
[
"id" => 11112311,
"name" => "TEST2",
"tovar_price_actual" => "79999",
"tovar_price_old" => "99999",
"summa" => "99999",
"tovar_name" => "TEXT2",
"tovar_id" => "2030001",
"tovar_url" => "test123",
"tovar_price_actual" => "65",
"tovar_price_old" => "98"
],
]
];
$data = [
"trigger_id" => 5935,
"api_key" => "***",
"doi_ok" => 1,
"text_preview" => "TES123T",
"email" => "em362rp@ya.ru",
"goods" => json_encode($goods)
];
$postdata = json_encode($data);
$httpdata = http_build_query($data);
$ch = curl_init($mailganer);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $httpdata);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
$result = curl_exec($ch);
curl_close($ch);
var_dump($postdata);
echo "<br/>";
var_dump($httpdata);
echo "<br/>";
var_dump($result);
?>Пример вёрстки письма, с использованием оператора for
<html>
<body>
<h1>Здравствуйте, {{first_name}} {{last_name}}</h1>
<p>Спасибо за заказ {{order_id}} на сайте domain.ru</p>
<h2>Состав заказа</h2>
{% for item in goods %} //начало цикла, в каждой итерации берётся следующий элемент из массива goods
<div>
<p><a href="{{ item.url }}"><img src="{{ item.image_url }}"/></a></p>
<p>{{ item.name }} {{ item.size }}, {{ item.quantity }} шт., {{ item.cost }} руб.</p>
</div>
{% endfor %} //конец цикла
<p>Адрес доставки: {{delivery_address}}</p>
<p>
Cтоимость доставки: {{shipping}} руб.<br/>
Сумма заказа: {{total_cost}} руб.
</p>
<p>С уважением, команда domain.ru</p>
</body>
</html>Использование оператора if
Используемая ниже конструкция
...
{% for item in goods %}
<div>
<p><a href="{{ item.url }}"><img src="{{ item.image_url }}"/></a></p>
<p>{{ item.name }}{% if item.size %}, Размер: {{ item.size }}{% endif %}, {{ item.quantity }} шт., {{ item.cost }} руб.</p>
</div>
{% endfor %}
...Важно при подготовке вёрстки не вставлять опертаор {% for %} или {% if %} между тегами <table> и <td>. Иначе при сохранении письма операторы автоматически перместятся перед <table> и вёрстка "поедет".
Использование оператора forloop.counter, forloop.first и forloop.last
Используемая ниже конструкция {% if forloop.first %} будет срабатывать для первого элемента в массиве. Конструкция {% if forloop.last %} - для последнего, {% if forloop.counter == 3 %} для третьего элемента массива.
...
{% for item in goods %}
<div>
{% if forloop.first %}<hr/>{% endif %}
<p><a href="{{ item.url }}"><img src="{{ item.image_url }}"/></a></p>
<p>{{ item.name }}{% if item.size %}, Размер: {{ item.size }}{% endif %}, {{ item.quantity }} шт., {{ item.cost }} руб.</p>
{% if forloop.last %}<hr/>{% endif %}
</div>
{% endfor %}
...Использование оператора forloop|length
Используемая ниже конструкция {% if goods|length >= 5 %} будет срабатывать, если в массиве больше или равно 5 элементов
...
{% if goods|length >= 5 %}
{% for item in goods %}
<div>
{% if forloop.first %}<hr/>{% endif %}
<p><a href="{{ item.url }}"><img src="{{ item.image_url }}"/></a></p>
<p>{{ item.name }}{% if item.size %}, Размер: {{ item.size }}{% endif %}, {{ item.cost }} руб.</p>
{% if forloop.last %}<hr/>{% endif %}
</div>
{% endfor %}
{% endif %}
...Работа с переменными типа float и date
{{cost|floatformat:"0" }} превратит переменную 39500.40 в 39500 Полное описание
{{birthday|date:"j l"}} превратит дату по шаблону "дата без 0 вначале + месяц", например "21 февраля" Полное описание
{{birthday|date:"j l"}} превратит дату по шаблону "дата без 0 вначале + месяц", например "21 февраля" Полное описание
Список параметров ответа (json)
Возможные значения ошибок
Error get alias
