Как маркетплейс собрал в базе более 1000 подписчиков, из которых 70% уже авторизованы. Использование триггерных коммуникаций позволило сэкономить на SMS и WhatsApp.
2 декабря 2022
B2B-маркетплейс «на_полке»: как отправлять клиентам персонализированные сообщения через Telegram
B2B-маркетплейс «на_полке» продает продукты питания, бытовую химию и другие товары оптом от проверенных поставщиков и дистрибьюторов.
Задача: подключить Telegram как канал коммуникации
«На_полке» решили протестировать Telegram в качестве канала коммуникации с клиентами. Чтобы сегментировать клиентов по городам, отправлять им триггерные сообщения и управлять коммуникациями омниканально, Telegram нужно было интегрировать с Mindbox. Для интеграции использовали сервис Botmother со встроенной функцией отправки вебхуков.
Чтобы увеличить долю заказов через CRM, мы решили использовать новый канал — Telegram. Решали задачу с помощью модуля чат-ботов в Mindbox и сервиса Botmother.
У нас уже был свой чат-бот и мы планировали пополнять количество подписчиков. Ребята из Mindbox посоветовали сразу внедрить механизм авторизации клиентов, чтобы не просто собирать базу для массовых рассылок, но и сразу авторизовывать клиентов для последующих триггерных сообщений.
На внедрение и тесты авторизации ушло несколько недель. Вместе с авторизацией и набором базы мы смогли сегментировать клиентов сразу в боте по городам и отправлять им массовые рассылки в Telegram.
Итого за пару месяцев нам удалось собрать в базе более 1000 подписчиков, из которых 70% уже авторизованы. Мы можем отправлять им триггерные коммуникации и экономить на SMS и WhatsApp.
Как сделать авторизацию клиента в Telegram
Этап 1: подготовка
Перед началом интеграции Telegram с Mindbox необходимо:
- Создать Telegram-бота через сервис @BotFather.
- Завести учетную запись в сервисе https://botmother.com/.
- Подключить в Mindbox модуль «Рассылки и боты» и написать об этом вашему менеджеру.
- Создать в Mindbox дополнительное поле для сущности «клиент» с системным именемplatformID.
Этап 2: настройка авторизации клиентов бота через Mindbox
Чтобы отправлять персонализированные сообщения через Telegram, необходимо авторизировать клиентов в Mindbox так же, как это происходит на сайте или в мобильном приложении.
Авторизация для новых клиентов настраивается так:
- Отправить клиенту ссылку на вашего бота.
- Запросить номер телефона для авторизации после того, как клиент подпишется на бота.
- Передать этот номер в Mindbox вместе с platform ID — уникальным идентификатором клиента в Telegram. По номеру телефона Mindbox найдет пользователя в базе и присвоит ему переданный platform ID.
Чтобы упростить авторизацию для клиентов, которые уже есть в базе, можно использовать два способа автоматической авторизации в Telegram:
- для тех, кто подписался на бота из рассылки,
- для тех, кто подписался на бота с сайта.
Если использовать эти способы, авторизация происходит незаметно, потому что мы не просим клиентов указывать номер телефона при подписке на бота.
Для своих задач можно использовать один из трех вариантов, описанных ниже, или все сразу, чтобы увеличить конверсию в подписчика. Рассмотрим, как их правильно настроить.
Вариант 1: авторизация при переходе из рассылки
Этот вариант подходит в таких случаях:
- Вы только что запустили бота и хотите привлечь в него ваших подписчиков из email-канала.
- Вы отправляете welcome-письмо со ссылкой на бота всем новым клиентам.
Как настроить авторизацию при переходе из рассылки:
- Добавить в email-рассылку ссылку на бота с параметром ?start=${Recipient.Id}, который подставит в него Mindbox ID клиента перед отправкой. Ссылка на бота должна иметь вид: https://t.me/TEST_bot?start=${Recipient.Id}
Так выглядит ссылка внутри email-рассылки
- Добавить в Botmother внешнее событие с типом «Deeplink» и переменную с именемmindboxid. В переменнуюmindboxidзапишутся значения, которые будут указаны в ссылке на бота в параметре? start=${Recipient.Id}
- Чтобы принять запрос с авторизацией клиента из Botmother, надо настроить в Mindbox операцию с такими настройками:
- Настроить передачу параметров Mindbox ID, который мы подставляли в ссылку на бота, и platform ID — уникального идентификатора клиента на платформе Telegram. C помощью platform ID мы можем взаимодействовать с конкретным клиентом в мессенджере напрямую из Mindbox. Для этого надо добавить блок «Запрос» на стартовом экране конструктора Botmother и указать в нем данные для передачи в Mindbox.
Пример запроса:
Когда запрос придет в Mindbox, в карточке клиента появятся действие «Подписался на Telegram» и заполненный внешний идентификатор platform ID.
После того как platform ID получен, через Telegram можно отправлять триггерные сообщения клиенту, например о брошенной корзине или персональной скидке.
Вариант 2: авторизация при переходе с сайта
Этот способ подходит для авторизации как существующих, так и новых клиентов. На сайте можно показывать клиенту попап или встроенный блок с предложением подписаться на Telegram-бота.
В этом случае для авторизации клиента используется другой уникальный идентификатор, который формирует JS SDK для всех посетителей сайта — deviceUUID (уникальный идентификатор устройства).
Как настроить авторизацию:
1. К концу ссылки на вашего бота добавить параметр ? start=customs.mindboxDeviceUUID%>
Должно получиться: https://t.me/test_bot?start=customs.mindboxDeviceUUID%>Параметр
2. Добавить сформированную ссылку на кнопку перехода в Telegram в настройках верстки попапа.
Так выглядит попап для клиента
При переходе в бота в адресной строке видно, что подставился параметр
После перехода по такой ссылке deviceUUID запишется в переменную mindboxid в Botmother.
- Создать в Mindbox операцию для получения deviceUUID и platform ID с такими настройками:
- Настроить передачу deviceUUID и platform ID из Botmother в Mindbox. Для этого на стартовом экране Botmother добавить блок «Запрос» со следующими настройками:
После передачи запроса в действиях клиента увидим действие «Подписался на Telegram» и заполненный внешний идентификатор platform_id.
Вариант 3: авторизация с помощью номера телефона
Этот метод универсальный, поэтому он подходит, когда клиент получил ссылку на бота через QR-код, медийную рекламу или обычной ссылкой без параметров UUID или Mindbox ID.
Как настроить
- Создать в Mindbox операцию таким образом:
- Создать в Botmother цепочку действий, в которых запросить у клиента номер телефона. Пример цепочки в Botmother:
После получения номера телефона через блок «Ввод от пользователя» записать номер в переменную contact.
- Подставить переменную «contact» и platform_id в запрос для передачи в Mindbox через операцию, созданную на первом этапе:
Пример запроса:
Что видит пользователь при авторизации этим способом:
При нажатии на кнопку «Ввести номер» всплывает окно с разрешением на отправку номера телефона в качестве ответа. При нажатии «Ок» номер автоматически отправляется в Mindbox.
В базе Mindbox происходит поиск клиента по номеру, если его не удалось найти, то создается новый.
Этап 3: настройка отправки сообщений в мессенджер
Вот как настроить отправку триггерного сообщения в Telegram на примере механики «брошенная корзина».
- Создать в конструкторе бота экран и шаблон сообщения, которое должно отправляться при брошенной корзине. Для этого сообщения понадобятся название и ссылка на товар, так как они будут передаваться из Mindbox.
Для этого используются два параметра:
— название товара — product_name
— ссылка на товар — product_url
Названия параметров могут быть любыми, их не нужно создавать в конструкторе чат-ботов дополнительно. Они будут созданы в Botmother автоматически при передаче из Mindbox.
Чтобы они отображались в сообщении, нужно использовать сущность last_request. По сути, это блок данных, который хранит в себе последние переданные в него параметры. Финальный вид параметров будет выглядеть так:
— название товара — {{last_request.product_name}}
— ссылка на товар — {{last_request.product_url}}
- Добавить в конструктор чат-ботов внешнее событие, при вызове которого из Mindbox будет отправляться сообщение из настроенного выше экрана.
- Скопировать сформированную ссылку на внешнее событие и перейти в Mindbox. Для отправки триггерного сообщения в Telegram через Botmother используются функции вебхуков.
- Заполнить поля вебхука:
- В ссылке запроса указать ссылку, которую получили при создании внешнего события в Botmother
- В заголовке — Content-Type: application/json
- В теле запроса:
Разберем состав тела запроса:
${Recipient.
AdditionalData.
— здесь выводится ID клиента в Telegram, который получили на этапе авторизации.
В тело запроса добавляется строка:
@{for item in Recipient.GetProductList («Korzina1»).
(«TovaryDlyaPisemIReko»).
Она необходима для того, чтобы получить один товар из списка продуктов «Корзина» и проверить, что он есть в заранее созданном сегменте товаров со ссылками и названиями (на разных проектах списки продуктов и сегменты называются по-разному).
- Когда вебхук готов, добавить его отправку в сценарий брошенной корзины. Перед отправкой проверить в условиях, что у клиента есть заполненный platform ID, который передали в Mindbox при авторизации клиента в Telegram.
Важно: отправка сообщения в Telegram должна быть последним этапом в любом каскаде, так как мы не получаем статус доставки, открытия или клика по этому сообщению из Telegram.
