К каждому списку рассылки прикреплён текст приглашения подписаться и подтвердить свой email, отправляемый контакту для подтверждения рассылки. Если контакт подписывается сразу на несколько списков, будет отправлено письмо с текстом первого из списков. С помощью метода updateOptInEmail можно изменить текст письма. Текст обязательно должен включать в себя как минимум одну ссылку с атрибутом
href="{{ConfirmUrl}}".
Принцип использования
| Синтаксис и URL для вызова метода |
| updateOptInEmail (string sender_name, string sender_email, string subject, string body, int list_id) |
| https://api.unisender.com/ru/api/updateOptInEmail?format=json&api_key=KEY&sender_name=FROMNAME&sender_email= FROMMAIL&subject=SUBJECT&body=HTMLBODY &list_id=X |
| Аргументы | |
| api_key * | Ключ доступа к API. |
| sender_name * | Имя отправителя. Произвольная строка, не совпадающая с e-mail адресом (аргумент sender_email). |
| sender_email * | E-mail адрес отправителя. Этот e-mail должен быть проверен (для этого надо создать вручную хотя бы одно письмо с этим обратным адресом через веб-интерфейс, затем нажать на ссылку "отправьте запрос подтверждения" и перейти по ссылке из письма). |
| subject * | Строка с темой письма. Может включать поля подстановки. |
| body * | Текст письма в формате HTML с возможностью добавлять поля подстановки.
Текст обязательно должен включать в себя как минимум одну ссылку с атрибутом href="{{ConfirmUrl}}". Возможность добавлять вложенные файлы не реализована. Предполагается, что HTML-текст содержит только содержимое тега body. Если Вы передаёте текст HTML целиком, то тестируйте такие письма дополнительно - заголовки вне body могут быть подвергнуты модификациям. Кроме того, чтобы уменьшить расхождение в отображении в различных почтовых программах, мы автоматически добавляем дополнительную разметку в каждое письмо (таблица с невидимыми границами, которая также задаёт шрифт по умолчанию и выравнивание текста по левой границе). Вы можете попросить отключить это для Ваших писем, обратившись в техподдержку. |
| list_id * | Код списка, при подписке на который будет отправлять данное письмо. Коды всех списков можно получить с помощью вызова getLists. |
| Возвращаемое значение |
| Пустой JSON-объект. |
