АВТОМАТИЗАЦИЯ РЕСТОРАНОВ И ПРЕДПРИЯТИЙ ИНДУСТРИИ РАЗВЛЕЧЕНИЙ
АВТОМАТИЗАЦИЯ РЕСТОРАНОВ
EN
This text is not yet available in other languages. We apologize for the inconvenience.
RU
Этот текст пока недоступен на русском языке. Приносим свои извинения за неудобства.
10.03.2022

Информирование Клиентов об изменении статуса доставки в Telegram

Данный функционал отправляет сообщение клиенту в чат Телеграм, при изменении статуса доставки гостевого счета.  Предварительно клиент должен подписаться на определенного Телеграм-бота.
Предварительные настройки.
1) Создаем Телеграм - бота.
Боты — специальные аккаунты в Telegram, созданные для того, чтобы автоматически обрабатывать и отправлять сообщения.
BotFather попросит придумать имя нашему новому боту. Единственное ограничение на имя — оно должно оканчиваться на «bot». В случае успеха BotFather возвращает токен (ключ авторизации) бота и ссылку для быстрого добавления бота в контакты.
Бот создан. Необходимо сохранить токен (ключ авторизации).
2) Импортировать в базу данных необходимые файлы для настройки функционала (можно получить в поддержке Тиллипада)
3) Для отправки клиенту СМС с приглашением подписаться на Телеграм-бота, необходимо зарегистрироваться на любом из трех сервисов:
PUSHSMS.ru,     SMS.ru,    p1SMS.ru.
После регистрации, личном кабинете, Вам будут доступны API-ключи (или ТОКЕН для сервиса PUSHSMS).
Далее нужно в личном кабинете подать заявку на создание  Отправителя,  иначе сообщения будут доставляться долго, а имя отправителя будет добавлено по умолчанию.
4) Создаем задачу, заполняем параметры:
Параметры задачи:
Токен – ввод токен-бота, созданного в п.1;
Имя бота – имя пользователя(бота) в Telegram. Нужно указывать без символа: @.
Дата запуска уведомлений – данный параметр нужен только для первого запуска задачи. При последующих запусках задачи, операции будут выбираться от даты последнего успешного запуска задачи.
Группы постоянных клиентов - клиентам выбранных групп будут отправляться уведомления об изменении статусов счетов доставки.
Выбор оператора отправки СМС - в данном параметре выбирается, какой из сервисов будет отправлять смс клиенту со ссылкой на Телеграм-бот.
API-ключ – Ключ API берется из личного кабинета сервисов: P1SMS, SMS.RU.
ТОКЕН к сервису PUSHSMS – у данного сервиса вместо API-key используется Token. Его также нужно взять в личном кабинете сервиса.
Отправитель – в данном параметре нужно указать, от какого имени будет происходить отправка СМС.  Указывать нужно только тех отправителей, которые уже созданы в личном кабинете и прошли проверку администраторов сайта. Если указать неверного отправителя или не указать вообще, то СМС будет отослано от отправителя по умолчанию, при этом СМС придет с большой задержкой.  
Шаблон сообщения клиенту Телеграм – в данном параметре нужно указать первую часть сообщения, которая не будет меняться в зависимости от статуса ГС. Статус счета доставки будет автоматически добавлен в конец данного сообщения.
Например, «Уважаемый клиент, Ваш заказ находится в статусе». 
Принцип работы механизма:
Постоянный клиент оформляет заказ на доставку. При первом  изменении статуса ГС доставки срабатывает задача: «Информирование Клиентов об изменении статуса доставки  в Telegram». Если это первый заказ ПК с начала работы данной задачи, то задача отправляет клиенту СМС-сообщение с предложением подписаться на Телеграм-бота. Если клиент подписывается на бота (переходит по ссылке из СМС), то при следующем заказе задача определит chat_ID клиента и начнет отправлять уведомления об изменении статуса в Телеграм клиента через бота.
Что делает задача:
1) Получает обновления бота, добавляет в заметку клиента  chat_ID новых подписчиков, подписавшихся на Телеграм-бота с последнего запуска задачи.
Метод АПИ: https://api.telegram.org/{BOT}:{TOKEN}/getUpdates
2) Выбирает ГС, статусы доставки, которых были изменены.
Важно: в данном варианте задачи анализируются следующие статусы:
3  Ждет начала приготовления
5  Начали готовить
6  Ждет отправки
7  В пути 
При необходимости, можно добавить или убрать статусы, по которым происходит отправка уведомления клиенту.  
3) Проверяет, есть ли в заметке постоянного клиента значение chat_ID (уникальный идентификатор клиента в Телеграм):
Если заметка «chat_ID в  Telegram»  заполнена, то задача, через бота, отправляет в Телеграм клиента информацию о текущем статусе заказа.
Если клиент не подписался на Телеграм-бота, в обновлении нет по нему никакой информации, и заметка  пустая, то в этом случае, клиенту на телефон отправляется СМС с динамической ссылкой на Телеграм-бота и предложением подписаться на него для получения уведомлений:
В ссылке также, в качестве параметра, зашит GUID клиента в системе Тиллипад. Тем самым, происходит сопоставление chat_ID клиента в Телеграм c GUID клиента в Тиллипад.
ВАЖНО: Для получения уведомлений клиент должен пройти по указанной в СМС ссылке и ОБЯЗАТЕЛЬНО нажать в чате бота на кнопку Запустить (или Start)
Требование к системе:
SQL SERVER должен быть 2016 или выше.
Уровень совместимости базы данных должен быть не ниже 130.
Релиз Тиллипада: 9.х  - 10.х.