Для работы с email
Для отправки email-сообщений
Обратите внимание!
При исполнении функций для работы с email-сообщениями возвращается:
А) либо NONE - при успешном выполнении функции;
В) либо текст статуса ошибки.
send_email() | send_email_from_bot() | send_email_template()
send_email('[email protected]', 'Это заголовок', 'А здесь я пишу текст')
/*через бот*/
mailing = send_email_from_bot('[email protected]', '[email protected]', 'Тема письма. Совсем обычная', 'Привет, шлю тебе мое сообщение', 'https://sun9-82.userapi.com/impg/L3ZYWHnlseIQsqZO')Для отправки 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] пришел шаблон уже заранее готового письма:
Для отправки 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-адрес клиента
confirm_email_subscription()
confirm_email_subscription(email, sender_name, bot_email, callback,client_name)
Функция понадобится для того, чтобы собирать согласия с клиентов для направления рассылок.
Если клиент в мессенджере указал почту, то отправляться будет согласие на рассылку, только после согласия будет создан email-клиент
При этом доверия к такому адресу электронной почты, владелец которого дал согласие, будет больше, то есть рейтинг рассылок будет выше.
Важно!
Без согласия клиента нельзя отправлять рассылки с потенциально рекламным контентом, не пренебрегайте указанной информацией во избежание штрафов за нарушения.
Параметры:
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 updated