Для отправки email-сообщений
Обратите внимание!
При исполнении функций для работы с email-сообщениями возвращается:
А) либо NONE - при успешном выполнении функции;
В) либо текст статуса ошибки.
send_email() | send_email_from_bot() | send_email_template()
Пример кода для копирования
send_email('test@test.ru', 'Это заголовок', 'А здесь я пишу текст')
/*через бот*/
mailing = send_email_from_bot('test_channel@test.com', 'test_client@yandex.ru', 'Тема письма. Совсем обычная', 'Привет, шлю тебе мое сообщение', 'https://sun9-82.userapi.com/impg/L3ZYWHnlseIQsqZO')
Примеры
Для отправки email-сообщения:
После исполнения функции клиент получит письмо:
Отправка через бот
Пример отправки ранее отправленного письма:
В списке писем для рассылок забираем переменную - id.
В примере - 483, это будущая mailing_id:
Переходим в конструктор и вызываем функцию со следующими параметрами:
вариант 1 - указание параметров в явном виде:
e_letter = send_email_template('483',"test@mail.ru", '', '09.08.2022 15:00')
вариант 2 - указание параметров через переменные:
mailing_id = ‘483’
client_email = ‘test@mail.ru’ (получатель письма)
email_bot =’ ’
date = '09.08.2022 15:00' (на момент рассылки уже просроченная дата, следовательно, письмо придет в момент вызова функции)
e_letter = send_email_template(mailing_id ,client_email , email_bot, date)
В итоге при вызове функции на почту test@mail.ru пришел шаблон уже заранее готового письма:
Описание
Для отправки 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, send_from_bot)
Функция понадобится для того, чтобы собирать согласия с клиентов для направления рассылок.
Если клиент в мессенджере указал почту, то будет отправляться согласие на рассылку, только после согласия будет создан email-клиент
При этом доверия к такому адресу электронной почты, владелец которого дал согласие, будет больше, то есть рейтинг рассылок будет выше.
Важно!
Без согласия клиента нельзя отправлять рассылки с потенциально рекламным контентом, не пренебрегайте указанной информацией во избежание штрафов за нарушения.
Параметры:
email - email-адрес клиента для подтверждения и добавления
sender_name - название компании, от имени которой просите подтвердить согласие на получение рассылок
bot_email - адрес email-бота, к которому присоединить нового email-клиента
callback - нужны ли колбеки клиентам, которые подтверждают email-адрес, и новому email-клиенту (по умолчанию False)
client_name - имя, которое запишется email клиенту
send_from_bot - отправлять письмо со сбором согласия от имени бота, к которому будет привязан клиент.
Важно!
Если параметр send_from_bot включен, но при этом email-бот НЕ зарегистрирован на почтовике Salebot (например, домен зарегистрирован в Эпл или Гугл) или НЕ авторизован, то письмо будет направлено по старому способу - с почты info@salebot.pro, то есть будто send_from_bot и не включали
Отправленные колбеки будут иметь вид:
"client_accept_email_subscription: #{email}" - колбек клиенту, подтверждающему email-адрес
"email_client_accepted_by ID:#{@client.id}" - новому клиенту (id подтверждающего сохранится в переменную client_father_id)
Пример
После того, как пользователь оставляет Вам email, отправьте письмо для верификации адреса.
После подтверждения пользователем согласия на получение рассылок от компании Вам будет добавлен новый email-клиент.
Таким образом, у Вас не будет "мертвых душ" при рассылках, а база email будет содержать адреса действительно заинтересованных в вашей продукции клиентов.