SetLoyalty ◾️ Telegram

Описание

Канал коммуникации Telegram предназначен для отправки сообщений через мессенджер Telegram. 

Общие правила

• Рассылка будет отправляться от имени Telegram-бота ритейлера.

• Рассылку через Телеграм смогут получать покупатели, которые:

  • зарегистрировались в программе лояльности; 

  • дали согласие на отправку сообщений через Telegram;

  • авторизовались через Telegram-бота, т. е. для этих покупателей в SetLoyalty хранится идентификатор пользователя в Telegram (platform_id).

• Сообщение может содержать текст, изображение и кнопку. Для настройки подключения сервиса хранения файлов обратитесь в техническую поддержку.

Настройка интеграции

Подключение канала коммуникации Telegram может быть реализовано одним из следующих способов.

1. Подключение при наличии действующего Telegram-бота с собранной базой подписчиков.

Ритейлер предоставляет юзернейм и токен Telegram-бота сотруднику CSI, а также через External API передает в SetLoyalty идентификаторы покупателей в Telegram (т. е. таким образом связываются clientId покупателя в SetLoyalty и platform_id пользователя в Telegram).

2. Подключение канала с нуля.

Ритейлер регистрирует через Telegram нового бота и далее с помощью специализированного сервиса разрабатывает логику данного бота, которая должна включать в себя авторизацию пользователей (стыковку clientId и platform_id). В качестве конструктора ботов можно использовать платформу SaleBot. 

Подключение канала коммуникации Telegram с помощью SaleBot

Список необходимых работ в общем виде:

1. Регистрация бота в Telegram и передача токена доступа в CSI.

2. Подключение Telegram-бота на платформе SaleBot.

3. Разработка приветственного сценария, тестирование и запуск бота.

4. Привлечение покупателей к подписке на Telegram-бота.

Ниже рассмотрим процесс настройки подробнее.

Получение и передача токена Telegram-бота

Для регистрации нового бота в Telegram откройте чат-бот BotFather:

• запустите бота командой /start;

• начните регистрацию нового бота командой /newbot;

• введите название бота (оно будет отображаться в контактах и чатах);

• введите юзернейм бота (уникальное имя на латинице).

Telegram пришлет сообщение об успешной регистрации бота и выдаст токен доступа к HTTP API.

Передайте сотруднику CSI данные:

1. Юзернейм бота (пример: my_favourite8_bot).

2. Токен доступа (пример: 7879675745:AAF_Y2-a5QThZE3TFU4rbDK3DgvbBnHqT68).

Также для подключения в SaleBot можно использовать уже существующего Telegram-бота, если он был создан ранее, для построения новых сценариев и отправки рассылок. SaleBot предоставляет возможность импортировать базу подписчиков бота.

Подключение Telegram-бота в SaleBot

Создайте аккаунт на платформе SaleBot.

Создайте новый проект по кнопке

→ укажите название проекта → нажмите

.

Откройте созданный проект и подключите новый канал:

• перейдите в [Название проекта] → Настройки проекта → Каналы;

• в списке каналов выберите Telegram;

• введите токен в одноименное поле и нажмите .

После добавления канала появится всплывающее сообщение "Канал создан успешно".

Подключенный Telegram-бот будет отображаться в списке каналов.

Важно! Если бот новый, необходимо привлечь покупателей подписываться. Для этого можно использовать различные приветственные сценарии.

Разработка сценария и запуск бота

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

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

• 📄 Скачать пример проекта (.json)

Для загрузки проекта перейдите в раздел Резервная копия (Бэкап) → в секции настроек Восстановление из файла прикрепите скачанный файл → нажмите

. 

Обновите страницу. Появится сообщение об успешном восстановлении проекта.

Затем перейдите в раздел Конструктор воронок для редактирования добавленного сценария.

Важно! При адаптации данного сценария для вашего бота необходимо отредактировать URL следующих запросов:

• http://XXX.XXX.XXX.XXX:8032/api/external/v1/clients?msisdn=#{client_phone}

• http://XXX.XXX.XXX.XXX:8032/api/external/v1/communications/clients/#{set_id}

где XXX.XXX.XXX.XXX - IP-адрес сервиса лояльности SLS.

Необходимо, чтобы был открыт доступ из сети Интернет к указанному IP-адресу через порт 8032.

Блоки, обязательные для редактирования, выделены на скриншоте ниже.

Дополните сценарий, сохраните изменения и протестируйте вашего бота. Подробнее - в документации Salebot.

После запуска Telegram-бота и формирования базы подписчиков, успешно прошедших авторизацию, можно настраивать и запускать рассылки в SetLoyalty.

Настройка сообщения 

1. В секции Каналы выберите тип канала Telegram → кликните 

.

Появится окно настройки сообщения. Для успешной отправки сообщения необходимо добавить как минимум текст или изображение.

Следующий шаг можно пропустить, если в сообщении не требуется текст (в таком случае будет обязательным добавление изображения).

2. Введите текст сообщения. При необходимости используйте динамические подстановки, например, {{Customer.first_name}} для обозначения имени покупателя. При рассылке сообщений подстановка будет автоматически заменена соответствующим значением для конкретного адресата. 

Подстановки вводятся в двойных фигурных скобках. Распознанные системой подстановки выделяются синим цветом.

Обратите внимание, что некоторые подстановки используются только с определенными триггерами. Список подстановок и правила их использования 

Следующий шаг можно пропустить, если заполнен текст сообщения, а изображение не требуется.

3. Нажмите 

 → выберите изображение с компьютера (файл размером до 5 Мб) → нажмите

.

Название прикреплённого изображения отобразится в окне настройки сообщения.

Шаги 4-5 можно пропустить, если в отправляемом сообщении не требуется кнопка.

4. Введите текст, который будет отображаться на кнопке.

5. Введите адрес веб-страницы, на которую будет вести кнопка.

6. Введите номер телефона для отправки тестового сообщения с учетом следующих требований:

• пользователь с таким номером должен быть зарегистрирован в базе покупателей SetLoyalty;

• пользователь с таким номером должен быть авторизован через Telegram-бот (т. е. идентификатор пользователя platform_id должен присутствовать в базе SetLoyalty).

7. Нажмите

и обязательно проверьте сообщение, которое придёт в Telegram на указанный номер телефона.

При отправке тестового сообщения, как в данном примере, подстановки будут заменены на реальные значения из профиля покупателя.

8. Нажмите

для сохранения настроек сообщения.

Пример сообщения

Пример сообщения для покупателя при запуске рассылки с указанными выше настройками:

Информация о доставке сообщений

Канал коммуникации Telegram позволяет отслеживать следующие статусы доставки сообщений:

• Отправлено;

• Доставлено (все отправленные считаются доставленными);

• Запретили отправку.