Как настроить Sendpulse API

В Sendpulse есть бесплатный тарифный план, который позволяет отправлять разовые письма.

Для использования Sendpulse API вам понадобятся ID, Secret, а также необходимо зарегистрировать email отправителя.

Вы можете отправлять письма только с того email-адреса, который указали при регистрации.

Вы можете зарегистрировать email для отправки в разделе SMTP.

Как настроить отправку писем из редактора

Чтобы отправить email, вставьте это в вкладку «Калькулятор»:

sendpulse_email(api_id, api_secret, from_email, to_email, subject, message, from_name)

где

api_id — ID API из Sendpulse
api_secret — Secret из Sendpulse
from_email — email-адрес отправителя
to_email — email-адрес получателя
subject — тема письма
message — тело письма (само сообщение)
from_name — имя отправителя

Чтобы отправить шаблон:

Сначала присвойте значение переменной template, это данные о нужном шаблоне:

template = { "id": "Номер шаблона", "variables": { "имя_переменной": "значение_переменной", "имя_переменной": "значение_переменной" }}

Затем вызовите функцию

sendpulse_email_template(api_id, api_secret, from_email, to_email, subject, template)

где

api_id — ID API из Sendpulse
api_secret — Secret из Sendpulse
from_email — email-адрес отправителя
to_email — email-адрес получателя
subject — тема письма
template — значение переменной, которую мы задали выше

Для наглядности рассмотрим пример бота, который спрашивает, кому, с какой темой и телом отправить письмо.

Сохраним значения api_id и api_secret в переменные. Для этого перейдите в настройки проекта Mavibot.

Затем создайте схему, которая собирает данные.

Теперь протестируем:

Как добавить email в адресную книгу

Чтобы добавить email-адрес в адресную книгу, используйте этот метод:

sendpulse_add_to_addressbook(api_id, api_secret, book_id, email, variables=None)

где

api_id — ID API из Sendpulse
api_secret — Secret из Sendpulse
book_id — ID адресной книги
email — email, который нужно добавить
variables — (необязательно) массив переменных. Если нужно его задать, он должен быть в таком формате: {"variable_name":"variable_value"}

Как отправить SMS

Чтобы отправить SMS, вставьте эту функцию в вкладку «Калькулятор»:

sendpulse_sms(api_id, api_secret, sender, phone, text, transliterate=0, route=None)

где

api_id — ID API из Sendpulse
api_secret — Secret из Sendpulse
sender — имя отправителя (менее 11 латинских символов, можно использовать цифры)
phone — номер телефона получателя
text — текст сообщения, его нужно поместить в кавычки, если вы не используете переменную
transliterate — транслитерация = 1, без транслитерации = 0
route — список каналов для отправки в странах, можно задать как None