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

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

Подключение на стороне Telegram

ШАГ 1. Откройте Telegram на вашем компьютере и найдите бот @BotFather.

ШАГ 2. Нажмите кнопку Старт и в полученном списке выберите команду /newbot.

Переход к созданию бота

ШАГ 3. Укажите название вашего бота и нажмите кнопку Отправить.

После этого укажите username бота в виде @username_bot. Например, @autoparts_bot.

Нажмите кнопку Отправить.

Создание бота

ШАГ 4. Скопируйте и сохраните в надежном месте:

• ссылку на бота;
• токен — потребуется позже для подключения бота на стороне PARTS SOFT.

Данные бота

Подключение на стороне PARTS SOFT

Чтобы бот был доступен вашим клиентам, требуется:

• установленный SSL-сертификат
• активная опция Протокол httpS в клиентской части в Сайт → Общие настройки. 

Для подключения бота к вашему магазину на платформе выполните следующие действия:

ШАГ 1. В панели администрирования перейдите в раздел Служебные → SMS и мессенджеры → Сервисы и выберите логотип Telegram. 

В появившемся окошке подтверждения нажмите ОК.

Переход к подключению на платформе

ШАГ 2. На открывшейся странице выполните следующие действия:

Таблица 1. Подключение бота

№	Название поля	Описание
1	Название	Укажите название мессенджера, под которым он будет отображаться на платформе.
2	API ключ	Укажите токен, который вы скопировали в Telegram-боте ранее.
3	Регион	Выберите регион, в котором будет доступен бот. Если оставить это поле пустым, бот будет доступен во всех регионах.
4	Приоритет	Выберите уровень приоритета бота. При значении 1, система будет пытаться в первую очередь отправить сообщение через Telegram, затем — через подключенные SMS-сервисы, если для них настроены соответствующие значения приоритета 2, 3 и т.д. Если для оповещений у вас подключен и активен Универсальный сервис, система в первую очередь будет пытаться отправить сообщение через него, а уже после через другие сервисы, согласно заданным уровням приоритета.
5	Активен	Активируйте опцию ПОСЛЕ первого сохранения настроек!

Нажмите кнопку Сохранить.

Настройки подключения к боту PARTS SOFT

Предоставление клиентам доступа к боту

Чтобы клиенты могли подписаться на бота и получать уведомления, вам нужно поделиться ссылкой на бота одним из следующих способов:

• разослать клиентам письмо с прямой ссылкой на бота;
• добавить ссылку в письмо о подтверждении заказа. Такая ссылка будет содержать код для входа без идентификации по номеру;
• разместить виджет подписки на странице "Спасибо за покупку";
• сгенерировать QR-код с прямой ссылкой;
• разместить ссылку в личном кабинете клиентов.

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

Клиент, который еще не подписан на бота, после перехода по ссылке увидит кнопку Запустить. Нажав кнопку, он будет или сразу авторизован (если перешел по ссылке с кодом) или ему необходимо будет пройти идентификацию по номеру телефона (если перешел по прямой ссылке).

По ссылке в письме

Вы можете настроить отображение ссылки на Telegram-бота в письма для клиентов о подтверждении заказа (для входа без аутентификации по номеру). Для этого выполните следующие действия:

ШАГ 1. В панели администрирования перейдите в раздел Служебные → Шаблоны html и в блоке Уведомления электронной почты откройте шаблон Пподтверждение заказа.

ШАГ 2. В текст шаблона добавьте приведенный ниже код ПОСЛЕ строки Спасибо за ваш заказ.

Нажмите кнопку Сохранить.

{% if order.customer.get_bot_client != blank %}
{% unless order.customer.get_bot_client.activate %}
<br>
<a href="{{order.customer.get_bot_client.authorize_url}}">Получайте уведомления в Telegram</a>
<br>
{% endunless %}
{% endif %}

Настройка уведомления

Код проверяет, подключен ли бот и подписан ли на него клиент. Если бот не подключен и/или не активен, ссылка отображаться не будет. 

Ссылка будет отображаться только для клиентов, которые еще не подписаны на бота, а также при условии, что бот активен.

Ссылка на бота в письме

На странице "Спасибо за покупку"

Для отображения виджета со ссылкой на Telegram-бота выполните следующие действия:

ШАГ 1. Активируйте отображение страницы "Спасибо за покупку" если это еще не настроено. Для этого в панели администрирования перейдите в раздел Сайт → Настройки страницы поиска → Настроить внешний вид → Окошко корзины/быстрый заказ и в поле Действия после оформления заказа выберите вариант Перенаправить на страницу "Спасибо за покупку". 

Активация страницы "Спасибо за покупку"

ШАГ 2. Перейдите в раздел Служебные → Шаблоны html и в блоке Шаблоны html страниц откройте шаблон Страница "Спасибо за покупку".

На открывшейся странице добавьте приведенный ниже код ПОСЛЕ строки <div class="b-head">Спасибо за заказ!</div>:

Нажмите кнопку Сохранить.

{% unless current_customer.get_bot_client.activate %}

{% include 'notification_services/_bot_status.liquid'%}

{% endunless %}

Настройка уведомления

Данный код проверяет, подписан ли клиент на Telegram-бота. Виджет будет отображаться только для клиентов, которые еще не подписаны на бота.

Код не поддерживается для страниц об успешном оформлении заказа, назначенных в разделе Сайт → Страницы.

Виджет на странице "Спасибо за покупку"

С помощью QR-кода

В качестве примера рассмотрим создание QR-кода на сайте https://free-qr.com/.

ШАГ 1. Перейдите на сайт для генерации QR-кодов https://free-qr.com/ (или любой другой).

В поле Link (Сайт) укажите ссылку на ваш Telegram-бот и нажмите кнопку Generate QR code (Сгенерировать QR код). 

Генерация QR-кода

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

Готовый QR код

В личном кабинете

В личном кабинете клиенты могут найти ссылку на вашего бота в разделе Бот Telegram. 

Чтобы включить отображение раздела перейдите в раздел панели администрирования Сайт → Внешний вид → Настройки личного кабинета и активируйте опцию Включить "Бот Telegram".

Включение раздела Бот Telegram

Раздел Бот Telegram в ЛК клиента 

На открывшейся странице клиент сможет:

• Копировать ссылку на бота;

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

• Перейти к боту по ссылке;
• Перейти к боту по QR-коду.

После активации чат-бота будет доступна кнопка отключения уведомлений.

Ссылки для перехода к чат-боту

Перейти к уведомлениям Telegram можно в виджете личного кабинета, с помощью кнопки Уведомления Telegram.

Переход к уведомлениям в виджете ЛК

Авторизация и использование бота

Для использования чат-бота клиенту требуется авторизоваться. Для этого необходимо выполнить следующие действия:

ШАГ 1. После перехода в чат-бот нажмите кнопку Запустить.

Запуск бота

ШАГ 2. В зависимости от требования чат-бота укажите ваш номер телефона и нажмите кнопку Отправить номер или введите команду /start.

Авторизация через отправку номера

Уведомления Telegram-бота

Бот отправляет клиентам уведомления о следующих событиях:

• о переходе заказа в определенный статус — в настройках статуса требуется активировать опцию Отправлять SMS уведомления и задать текст уведомления;
• о подтверждении заказа — в разделе Служебные → Шаблоны html требуется настроить шаблон Смс уведомление подтверждение заказа;
• о собранном заказе — в разделе Служебные → Шаблоны html требуется настроить шаблон Заказ собран;
• о пополнении баланса — в разделе Служебные → Шаблоны html требуется настроить шаблон Уведомление о зачислении на баланс.

  При необходимости отправку уведомлений о пополнении баланса можно отключить для всех клиентов. Для этого в разделе Сайт → Общие настройки активируйте опцию Отключить уведомление при пополнении баланса.

• и других — в разделе Служебные → Шаблоны html требуется настроить соответствующие шаблоны в блоке Шаблоны SMS.

В сообщении для Telegram-бота можно:

• использовать конструкции языка Liquid и HTML-теги <b> (жирный шрифт) и <i> (курсив);
• добавить кнопку оплаты счета;
• выводить информацию о конкретном пункте выдачи, если заказ был оформлен на самовывоз.

Примеры настройки уведомлений

О принятом заказе

ШАГ 1. В панели администрирования перейдите в раздел Служебные → Шаблоны html (письма, смс и т.п.) и в блоке Шаблоны СМС выберите шаблон Смс уведомление подтверждение заказа.

ШАГ 2. Замените текст уведомления на приведенный ниже.

Нажмите кнопку Сохранить.

{% if notification_service_code == 'telegram' %}
<b>Ваш заказ</b> {{order.order_id}}принят. Дождитесь звонка от менеджера: {{order.customer.user.phone}}
{% else %}
Ваш заказ {{order.order_id}} принят. Дождитесь звонка от менеджера: {{order.customer.user.phone}}
{% endif %}

Настройка уведомления

После настройки сообщение до элемента {% else %} будет использоваться в Telegram-уведомлениях, после элемента {% else %} — для SMS-рассылок.

Уведомление о принятом заказе

О смене статуса позиции и всего заказа

ШАГ 1. В панели администрирования перейдите в раздел Справочники → Статусы заказов и в строке статуса В работе нажмите кнопку Редактировать.

На открывшейся странице перейдите к блоку Настройка уведомлений о смене статуса.

ШАГ 2. Выполните следующие действия

1. На вкладке Настройка SMS уведомлений о статусе позиции:

• активируйте опцию Отправлять SMS уведомления;
• в поле Текст уведомления укажите приведенный ниже текст.

Нажмите кнопку Сохранить.

{% if notification_service_code == 'telegram' %}
<b>Вы заказывали:</b>
<b>Позиция</b> → {{order_item.detail_name}} {{order_item.oem}} {{order_item.make_name}}
• новый статус → {{order_item.status.name}}
• заказанное кол. → {{order_item.qnt}}
• актуальное кол. → {{order_item.current_qnt}}
{% endif %}

Настройка уведомления о статусе позиции

2. На вкладке Настройка SMS уведомлений о статусе всего заказа:

• активируйте опцию Отправлять SMS уведомления;
• в поле Текст уведомления укажите приведенный ниже текст.

Нажмите кнопку Сохранить.

{% if notification_service_code == 'telegram' %}
<b>Данные по заказу:</b>
{% for item in order.order_items %}
<b>Позиция</b> → {{item.detail_name}} {{item.oem}} {{item.make_name}}
• новый статус → {{item.status.name}}
• заказанное кол. → {{item.qnt}}
• актуальное кол. → {{item.current_qnt}}
{% endfor %}
{% endif %}

Уведомления о смене статуса

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

ШАГ 1. В панели администрирования перейдите в раздел Справочники → Статусы заказов и в строке статуса Ожидает оплаты нажмите кнопку Редактировать.

На открывшейся странице перейдите к блоку Настройка уведомлений о смене статуса.

ШАГ 2. Выполните следующие действия на вкладке Настройка SMS уведомлений о статусе всего заказа:

• активируйте опцию Отправлять SMS уведомления;
• в поле Текст уведомления Ваш заказ №{{order.order_id}} ожидает оплаты;
• активируйте опцию Отправлять кнопку оплаты счета в Telegram, чтобы в сообщении отображалась кнопка оплаты счета.

Нажмите кнопку Сохранить.

Настройка уведомления

Уведомление о смене статуса

О переходе заказа в статус "Пришло"

Вы можете настроить отправку клиентам уведомлений о приходе заказа в определенный пункт выдачи (переходе заказа в статус Пришло) и даже добавить отображение местоположения ПВЗ на карте. 

Перед настройкой отправки уведомлений убедитесь, что выполнены необходимые условия:

• настроены пункты выдачи, которые закреплены за типом доставки Самовывоз;
• указаны адрес и режим работы для каждого ПВЗ;
• указаны координаты местоположения (в полях Долгота и Широта) для каждого ПВЗ, чтобы в сообщении чат-бота отображалась карта (если требуется).

Для настройки уведомлений выполните следующие действия:

ШАГ 1. В панели администрирования перейдите в раздел Справочники → Типы доставки и в строке типа доставки Самовывоз нажмите кнопку Редактировать. 

ШАГ 2. На открывшейся странице активируйте опцию Отправлять контакты в TG, чтобы адрес ПВЗ передавался в чат-бот Telegram.

Сохраните изменения.

Настройка отправки уведомлений

ШАГ 3. В панели администрирования перейдите в раздел Справочники → Статусы заказов и в строке статуса Пришло нажмите кнопку Редактировать.

На открывшейся странице перейдите к блоку Настройка уведомлений о смене статуса.

ШАГ 4. Выполните следующие действия на вкладке Настройка SMS уведомлений о статусе всего заказа:

• активируйте опцию Отправлять SMS уведомления;
• в поле Текст уведомления Ваш заказ №{{order.order_id}} готов к выдаче;
• в поле Режим отправки адреса выберите вариант Если активировано в типе доставки.

Нажмите кнопку Сохранить.

Настройка уведомления

Уведомление о смене статуса

Видео по теме

YouTube

RuTube