Для работы с email
Для упрощения понимания какой набор функций доступен на тарифе вводим систему обозначений:
- доступно на Бесплатном тарифе

- доступно на Базовом тарифе

- доступно на тарифе Стандарт

- доступно на тарифе Премиум

В случае успешного исполнения функции для работы с email-сообщениями возвращают None, иначе - текст ошибки.
Описание
Примеры
Пример кода для копирования
Видеоразбор
Для отправки email-сообщения
send_email(to_email, subject, message)
Параметры:
! to_email - email получателя
! subject - заголовок письма
! message - текст письма
Для отправки email-сообщений через бот
send_email_from_bot(email_bot, client_email, email_subject, text, attachment_url)
Параметры:
! email_bot - почта, к которой подключен канал email-рассылок
! client_email - почта клиента, куда отправится письмо
! email_subject - тема письма, заголовок
! text - сообщение, передаваемое в теле письма
attachment_url - url с ссылкой на вложение
Для пересылки черновика или отправленного письма email
send_email_template(mailing_id, client_email, email_bot, date)
Параметры:
! mailing_id - id шаблона рассылки - либо черновик, либо уже готовое письмо.
! client_email - email получателя письма.
email_bot - email отправителя. По умолчанию email, подключенный к проекту.
date - дата отправки письма, в формате ‘dd.mm.yyyy HH:mm’. Если указать уже прошедшую дату или не указать вовсе, письмо отправится сразу же после вызова функции.
Для отправки email-сообщения:

После исполнения функции клиент получит письмо:

Скрин полученного письма
Отправка через бот

Пример отправки ранее отправленного письма:
В списке писем для рассылок забираем переменную - 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_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(email, sender_name, bot_email, callback,client_name)
Параметры:
email - email-адрес клиента для подтверждения и добавлен ия
sender_name - название компании, от имени которой просите подтвердить согласие на получение рассылок
bot_email - адрес email-бота, к которому присоединить нового email-клиента
callback - нужны ли колбеки клиентам, которые подтверждают email-адрес, и новому email-клиенту (по умолчанию False)
client_name - имя, которое запишется email клиенту
Отправленные колбеки будут иметь вид:
"client_accept_email_subscription: #{email}" - колбек клиенту, подтверждающему email-адрес
"email_client_accepted_by ID:#{@client.id}" - новому клиенту (id подтверждающего сохранится в переменную client_father_id)
После того, как пользователь оставляет Вам email, отправьте письмо для верификации адреса.

После подтверждения пользователем согласия на получение рассылок от компании Вам будет добавлен новый email-клиент.
Таким образом, у Вас не будет "мертвых душ" при рассылках, а база email будет содержать адреса действительно заинтересованных в вашей продукции клиентов.
Last modified 18d ago