Работа с электронной почтой
Для отправки email-сообщений
Обратите внимание!
При выполнении функций для работы с email-сообщениями функция возвращает:
a) либо NONE — при успешном выполнении функции;
b) либо статус ошибки текст.
send_email() | send_email_from_bot() | send_email_template()
Описание
Для отправки email-сообщения
send_email(to_email, subject, message)
Параметры:
! to_email - email адрес получателя email address
! subject - тема письма
! message - текст письма
Для отправки email-сообщений через бота
send_email_from_bot(email_bot, client_email, email_subject, text, attachment_url)
Параметры:
! email_bot - email адрес, привязанный к каналу email-рассылки ! client_email - email адрес клиента, на который будет отправлено сообщение ! email_subject - тема email (заголовок) ! text - текст сообщения, отправляемого в email 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 - дата отправки email в формате ‘dd.mm.yyyy HH:mm’. Если дата находится в прошлом или не указана, письмо будет отправлено сразу после вызова функции.
Пример
Для отправки email-сообщения:
Отправка через бота
Пример отправки ранее отправленного 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 получателя
email_bot = ''
date = '09.08.2022 15:00' # поскольку на момент отправки дата уже в прошлом, письмо будет отправлено сразу после вызова функции
e_letter = send_email_template(mailing_id, client_email, email_bot, date)
В результате при вызове функции был отправлен шаблон заранее подготовленного email на [email protected].
Пример кода для копирования
send_email('[email protected]', 'Это заголовок', 'А это текст')
/*через бота*/
mailing = send_email_from_bot('[email protected]', '[email protected]', 'Тема письма. Просто простая', 'Привет, я отправляю тебе мое сообщение', 'https://sun9-82.userapi.com/impg/L3ZYWHnlseIQsqZO')Для подтверждения рассылок на email адрес клиента
confirm_email_subscription()
Описание
confirm_email_subscription(email, sender_name, bot_email, callback,client_name)
Эта функция предназначена для сбора согласия клиентов на отправку email-рассылок.
Когда клиент предоставляет свой email адрес через мессенджер, сначала отправляется запрос на согласие. Email-клиент создается только после того, как клиент подтвердит свое согласие.
В результате email-адреса с подтвержденным согласием считаются более надежными, что помогает повысить общую доставляемость ваших email и репутацию отправителя.
Важно!
Нельзя отправлять рассылки с потенциально рекламным содержимым без согласия клиента.
Не игнорируйте эту информацию, чтобы избежать штрафных санкций за нарушения.
Параметры:
email - email адрес клиента для проверки и добавления
sender_name - название компании, от имени которой вы запрашиваете согласие на получение рассылок
bot_email - email адрес бота, к которому будет привязан новый email-клиент
callback - требуются ли callback-и или нет для клиентов, подтверждающих свой email адрес, и для нового email-клиента (по умолчанию: False)
client_name - имя, которое будет присвоено email-клиенту
Отправленные callback-и будут иметь следующий формат:
"client_accept_email_subscription: #{email}" - callback для клиента, подтверждающего свой email адрес
"email_client_accepted_by ID:#{@client.id}" - callback для нового клиента (ID подтверждающего клиента будет сохранен в переменной client_father_id)
Отправьте сообщение для проверки адреса после того, как пользователь предоставит свой email.
После того как пользователь подтвердит свое согласие на получение рассылок от компании, новый email-клиент будет добавлен в ваш список.
Таким образом, у вас не будет "мертвых лидов" в кампаниях, а ваша email-база будет состоять только из адресов клиентов, которые действительно заинтересованы в ваших продуктах.
Последнее обновление