Як налаштувати API Sendpulse

У Sendpulse є безкоштовний тарифний план, який дозволяє надсилати разові листи.

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

Ви можете надсилати листи лише з тієї електронної адреси, яку вказали під час реєстрації.

Ви можете зареєструвати email для надсилання в розділі SMPT

Як налаштувати надсилання листів з редактора

Щоб надіслати email, вставте це у вкладку Calculator:

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 — адреса електронної пошти відправника
to_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 — адреса електронної пошти відправника
to_email — адреса електронної пошти отримувача
subject — тема листа
template — значення змінної, яку ми встановили вище

Для зручності розглянемо приклад бота, який запитує, кому, з якою темою та тілом надіслати листа.

Збережемо значення api_id та api_secret у змінні. Для цього перейдіть у налаштування проекту Mavibot.

Потім створіть схему, яка збирає дані.

Тепер протестуємо:

Як додати 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, вставте цю функцію у вкладку Calculator:

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 — transliterate = 1, без транслітерації = 0
route — список каналів для надсилання в країнах, можна встановити як None