Робота з email
Для надсилання електронних листів
Зверніть увагу!
Під час виконання функцій для роботи з електронними листами функція повертає:
a) або NONE — у разі успішного виконання функції;
b) або статус помилки текст.
send_email() | send_email_from_bot() | send_email_template()
Опис
Для надсилання електронного листа
send_email(to_email, subject, message)
Параметри:
! to_email - адреса електронної пошти одержувача адреса електронної пошти
! subject - тема листа
! message - текст листа
Для надсилання електронних листів через бота
send_email_from_bot(email_bot, client_email, email_subject, text, attachment_url)
Параметри:
! email_bot - адреса електронної пошти, прив’язана до каналу розсилки ! client_email - адреса електронної пошти клієнта, на яку буде надіслано повідомлення ! email_subject - тема листа (заголовок) ! text - текст повідомлення, надісланого в листі attachment_url - URL вкладення
Для пересилання чернетки або надісланого листа
send_email_template(mailing_id, client_email, email_bot, date)
Параметри:
! mailing_id - ID шаблону розсилки (або чернетка, або готовий лист)
! client_email - адреса електронної пошти одержувача
email_bot - адреса електронної пошти відправника; за замовчуванням — електронна пошта, підключена до проєкту
date - дата надсилання листа у форматі ‘dd.mm.yyyy HH:mm’. Якщо дата в минулому або не вказана, лист буде надіслано одразу після виклику функції.
Приклад
Для надсилання електронного листа:
Надсилання через бота
Приклад надсилання раніше надісланого листа:
Ми беремо змінну зі списку розсилки — id.
У цьому прикладі це 483, яке буде використано як mailing_id.
Переходимо до конструктора і викликаємо функцію з такими параметрами:
Варіант 1 — явне вказання параметрів:
e_letter = send_email_template('483', "[email protected]", '', '09.08.2022 15:00')
Варіант 2 — вказання параметрів за допомогою змінних:
mailing_id = '483'
client_email = '[email protected]' # email одержувача
email_bot = ''
date = '09.08.2022 15:00' # оскільки на момент надсилання дата вже в минулому, лист буде надіслано одразу після виклику функції
e_letter = send_email_template(mailing_id, client_email, email_bot, date)
У результаті, коли функцію було викликано, шаблон заздалегідь підготовленого листа було надіслано на [email protected].
Приклад коду для копіювання
send_email('[email protected]', 'Це заголовок', 'А це текст')
/*через бота*/
mailing = send_email_from_bot('[email protected]', '[email protected]', 'Тема листа. Просто проста', 'Привіт, я надсилаю тобі своє повідомлення', 'https://sun9-82.userapi.com/impg/L3ZYWHnlseIQsqZO')Для підтвердження розсилок на адресу електронної пошти клієнта
confirm_email_subscription()
Опис
confirm_email_subscription(email, sender_name, bot_email, callback,client_name)
Ця функція призначена для збору згоди від клієнтів на надсилання email-розсилок.
Коли клієнт надає свою адресу електронної пошти через месенджер, спочатку надсилається запит на згоду. Електронний клієнт створюється лише після того, як клієнт підтвердить свою згоду.
У результаті адреси електронної пошти з підтвердженою згодою вважаються більш надійними, що допомагає покращити загальну доставлюваність ваших листів і репутацію відправника.
Важливо!
Ви не можете надсилати розсилки, що містять потенційно рекламний контент, без згоди клієнта.
Не ігноруйте цю інформацію, щоб уникнути штрафів за порушення.
Параметри:
email - адреса електронної пошти клієнта для перевірки та додавання
sender_name - назва компанії, від імені якої ви запитуєте згоду на отримання розсилок
bot_email - адреса електронної пошти бота, до якої буде прив’язано нового email-клієнта
callback - callbacks потрібні (або не потрібні) для клієнтів, які підтверджують свою адресу електронної пошти, та для нового email-клієнта (за замовчуванням: False)
client_name - ім’я, яке буде призначено email-клієнту
Надіслані callbacks матимуть такий формат:
"client_accept_email_subscription: #{email}" - callback для клієнта, що підтверджує свою адресу електронної пошти
"email_client_accepted_by ID:#{@client.id}" - callback для нового клієнта (ID клієнта, що підтвердив, буде збережено у змінній client_father_id)
Надішліть повідомлення для перевірки адреси після того, як користувач вкаже свою електронну пошту.
Після того як користувач підтвердить свою згоду на отримання розсилок від компанії, новий email-клієнт буде доданий до вашого списку.
Таким чином, у ваших кампаніях не буде жодних «мертвих лідів», а ваша база електронних адрес складатиметься лише з адрес клієнтів, які справді зацікавлені у ваших продуктах.
Last updated