Как отправить рассылку через чат-бот

При подключении мессенджеров к Mindbox их можно использовать для отправки массовых и автоматических рассылок как любой другой канал.

Настройка отправки рассылки

1. На платформе Botmother добавьте экран, который хотите отправить пользователям.

2. Перейдите в настройки бота и добавьте событие:
   1. задайте название;
   2. тип — Внешнее событие;
   3. тип внешнего события — Экран
   4. Экран — экран, созданный на первом шаге для рассылки.

После сохранения ссылка события автоматически заполнится. Скопируйте ее.

3. В Mindbox создайте вебхук:
   1. Задайте название;
   2. Тип запроса — POST;
   3. URL — Вставьте скопирорванную ссылку;
   4. Заголовки — необязательно;
   5. Тело запроса — общий вид:

{ 
  "platform": "tg",
  "users": ["${Recipient.ExternalIdentity.TelegramID}"],
  "data": {}
}

Где:

• platform — это платформа в которую будет отправлено сообщение.
• users — идентификатор подписчика платформы. Обращаемся к нему с помощью параметра шаблонизатора ${Recipient.ExternalIdentity.TelegramID}. Может отличаться от проекта к проекту, если у поля задано иное системное имя.
• data — любой JSON, который запишется в боте в объект last_request. Принимает массивы и другие объекты.

Подробнее возможности передачи данных в data рассмотрим ниже.

4. Создайте сценарий для вызова вебхука.

Для массовой рассылки используйте сценарий по расписанию. Не забудьте указать ограничение по количеству срабатываний на клиента и по окончанию работы, чтобы сообщения не отправлялись клиентам несколько дней подряд.

Например:

Для автоматических рассылок используйте сценарий по событиям.

Например:

Наполнение рассылки

Отправка рассылки состоит из двух процессов:

1. запуск отправки и передача данных в чат через вебхук;
2. вывод данных в чате с помощью собственных переменных.

Поэтому содержимое вебхука и экрана чат-бота зависят от типа передаваемых данных.

Рассылка без переменных

Например, нужно просто сообщить о массовой акции, персонализированная информация не нужна.

На экран вводится всё сообщение:

Вебхук передается с пустым объектом для data:

{ 
  "platform": "tg",
  "users": ["${Recipient.ExternalIdentity.TelegramID}"],
  "data": {}
}

Клиент получает сообщение:

Рассылка с простыми переменными

Например, хотим обратиться в сообщении по имени, если оно заполнено, и вывести персональный промокод.

В вебхуке задайте:

• переменные, в которые запишутся значения с проекта для передачи в Botmother (например, "name");
• значения этих переменных с помощью параметров Mindbox (например, "${Recipient.OnlyStandardFirstName}").

{ 
  "platform": "tg",
  "users": ["${Recipient.ExternalIdentity.TelegramID}"],
  "data": {
      "name": "${Recipient.OnlyStandardFirstName}",
      "code": "${Recipient.LastReceivedPromoCode.WithTypePromo500.Value}"
  }
}

На экране добавьте текст с переменными, в которые будут переданы полученные из Mindbox значения.
Не забывайте, что переменные будут записаны в last_request:

Привет{{#if last_request.name}}, {{last_request.name}}{{/if}}!
Не забудьте воспользоваться персональным промокодом {{last_request.code}}

Клиент получает сообщение:

Рассылка с коллекцией

Например, хотим отправить сообщение с брошенной корзиной.

В вебхуке задайте переменные, в которые будут записаны значения из Mindbox:

{ 
  "platform": "tg",
  "users": ["${Recipient.ExternalIdentity.TelegramID}"],
  "data": {
                 @{for item in Session.GetAddedToListProducts("Korzina").AvailableForRecipient.Take(1)}
    
              "name": "${item.Name}",
              "price": "${item.Price}"
          @{end for}
  }
}

На экране добавьте текст с переменными, в которые будут переданы полученные значения.
Не забывайте, что переменные будут записаны в last_request:

Вы кое-что забыли в корзине
Товар: {{last_request.name}}
Цена: {{last_request.price}}

Клиент получает: