Урок № 35 Telegram боты и юнитботы в MAGAZKA
(от простого к сложному)
(урок подготовлен на основании релиза *.0371)
- Оглавление
- - СОЗДАЕМ БОТА
- - ЧТО НУЖНО, ЧТОБЫ "ОЖИВИТЬ" БОТА ?
- - ОСНОВНЫЕ КОМАНДЫ ЧАТА
- КОМАНДЫ (ЮНИТБОТЫ)
- КЛАДОВКА ЮНИТОВ
Запускаем Telegram и в строке поиска ищем канал @BotFather
Обратите на значок - нам нужен оригинальный BotFather
Переходим в канал
Можно написать команду /newbot (создать нового бота) или выбрать из меню
Нужно придумать имя для бота (КАКОЕ САМИ ПОЖЕЛАЕТЕ - потом можно будет переименовать)
Telegram проверит ваше имя бота и если оно не занято (в нашем примере : TEST_UNITBOT_MAGAZKA)
предложит создать имя пользователя для бота (TEST_UNITBOT_MAGAZKA_bot) не будем выдумывать и просто добавим суффикс
Если все сделали правильно : появится вот такое сообщение :
где главное это ТОКЕН :
5553282493:AAEZS8h7G-QZcKBf3U11z1KxN7Tm31QqY1A
(это примерный , не настоящий- настоящий никому не показывайте)
Снова переходим в поиск и вводим имя вашего бота (TEST_UNITBOT_MAGAZKA)
находим его и переходим в канал
если нажать кнопку ЗАПУСТИТЬ(или /start) , к сожалению ничего еще не произойдет
2. ЧТО НУЖНО, ЧТОБЫ "ОЖИВИТЬ" БОТА
Запускаем MAGAZKA - Главное окно - Служебные - Telegram боты
Добавить и появится запрос на ввод ТОКЕНа
- копируем и вставляем
Если все сделали так - программа проверит и ответ "Слушаюсь и повинуюсь"
Если ТОКЕН не верный
ЧАТ БОТ НЕ НАЙДЕН
Unauthorized
Проверьте правильность токена !
Ставим галочку АКТИВНЫЙ . Сохраняем и перезапускаем MAGAZKA
Давайте рассмотрим назначение реквизитов
Наименование : имя вашего бота в телеграм канале
Кнопка "ТЕСТ" - проверка корректности имени и токена (нужно нажимать, чтобы сделать доступной галочку АКТИВНЫЙ)
АКТИВНЫЙ - если галочка установлена , значат MAGAZKA будет обрабатывать ВХОДЯЩИЕ сообщения от бота (попробуйте написать "Я люблю MAGAZKA")
Токен : ключ доступа к боту
ПИН-КОД : код доступа в чат (если оставить пустым - никого запроса не будет)
Сотрудники : чат для сотрудников (пользователей MAGAZKA - должны знать или иметь пароль в программе)
Клиенты : внешние ваши партнеры, покупатели, рекламодатели , физ.лица
Запросит : ОТПРАВИТЬ КОНТАКТ
так если просто написать телефон (да же если он ваш - программу будет требовать ОРИГИНАЛЬНЫЙ ВАШ КОНТАКТ)
Если все сделали правильно - вы увидите СТАРТОВУЮ КЛАВИАТУРУ БОТА
Для всех: выбор или ПАРОЛЬ или ТЕЛЕФОН
дальше два варианта или ПАРОЛЬ или КОНТАКТ (действия смотри выше)
Без : никаких запросов- пишут всех кто хочет и что хочет
Если вам удалось авторизоваться , то теперь у вас канал будет выглядеть вот так
СТАРТОВА КЛАВИАТУРА БОТА MAGAZKA
- СПРАВКА
пока 4(четыре основные команды чата) ОНИ ОБЩИЕ и ЕСТЬ у ВСЕХ
- КТО Я? (три варианта)
- владелец клубной карты
- зарегистрированный пользователь по телефону
- пользователь с правами программы MAGAZKA
У вас не доступных ЮНИТов - грустно, но не страшно
их просто нужно добавить в вашей программе
ЮТИТ бот MAGAZKA - это специальная внешняя обработка c ЛЮБОЙ ЛОГИКОЙ алгоритма
(БОТ наш умеет все!) и его действия зависят только от вашей фантазии и нашей реализации)
Вот пример ДЕМО БАЗЫ
также ЮНИТА можно скрыть от общей КОМАНДЫ
снова запросим КОМАНДЫ
и уже получим вот такой результат
Где брать ЮНИБОТОВ ? - будет доступен МАРКЕТ MAGAZKA (на сайте) будет бесплатные, платные и индивидуальные под заказ
- СКРЫТЬ (убирает стартовую клавиатуру)
Смотрю на вас и вижу ОДИН ВОПРОС ????- и на .... для чего все это . Где КОМАНДЫ - кем командовать ?
не спешите. КОМАНДЫ - это ЮНИТ БОТЫ (внешние обработки)
4.ЮНИТ БОТЫ (внешние обработки) - как добавить НОВУЮ команда для БОТА
нажимаем на желтую папочку внизу - и выбираем файл ЮНИТА
все поля АВТОМАТИЧЕСКИ ЗАПОЛНЯТСЯ (по умолчанию) но их все - можно менять
Команда для БОТА : любые буквы в английской раскладке и цифры в боте будет отображать , как "/" + Команда для БОТА
Активный : включен /отключен
Описание и комментарий : для команды клавиатуры ПАРАМЕТРЫ
Открытие/Закрытие - служебные поля
Закрыт для "/Help" - скрыт от команды "СПРАВКА"
Параметр : - это ВОПРОС ЮНИТБОТА к пользователю
Значение : - это тип возвращаемого ответа (число, строка, дата, Булево (да, нет), Справочник, Документ, Файл, Музыка, Действие, Команда, Повтор и.т.д.)
Если заранее заполнить значение : Например : Выбрать склад и вы сразу укажите МАГАЗИН по УМОЛЧАНИЮ - то запроса не поступит
Подсказка - описание запрашиваемого действия (очепятку вижу, поправим)
Флаг - выводить запрос
Повтор - повторять запрос
Сортировка - порядок вывода запросов
Сохраняем
переходим в бот и снова запрашиваем КОМАНДЫ (можно сразу ввести /DATE)
Появилась команда : /DATE
Логика такая
если одно число - это ДЕНЬ текущего месяца текущего года (7 = 07.08.2022)
если два числа : число [РАЗДЕЛИТЕЛЬ] число - это ДЕНЬ МЕСЯЦ (указанный) текущего года (7,2 = 07.02.2022)
если три числа : число [РАЗДЕЛИТЕЛЬ] число [РАЗДЕЛИТЕЛЬ] число - это ДЕНЬ МЕСЯЦ (указанный) ГОД (указанный) (7,3,14 = 07.02.2014)
Если введенное число не может быть конвертирована в ДАТУ - то получите предупреждение
Если Вы уже заметили КЛАВИАТУРА - внизу изменилась (Это КЛАВИАТУРА _ ЮНИТБОТА - и она может быть ЛЮБОЙ)
Параметры : - описание ЗАПРОСОВ юнитбота (они указываются в параметрах ЮНИТБОТА в программе)
СПРАВКА : - описание и комментарий ЮНИТБОТА (они указываются в параметрах ЮНИТБОТА в программе)
ПРОПУСТИТЬ - например ВЫБОР из СПРАВОЧНИКА несколько СКЛАДОВ, ПОЛЬЗОВАТЕЛЕЙ, ГРУППЫ ТОВАРА и.т.д. (когда ХВАТИТ - нажимаем пропустить)
в параметрах ЮНИТА у строки ЗАПРОСА - есть галочка ПОВТОР
Проверяем (изменим КОМАНДУ на /DATE2
ввели две даты и нажали ПРОПУСТИТЬ - получили результат - РАЗНИЦА МЕЖДУ ДАТАМИ
это хорошо, НО ! неудобно и не всегда понятно, а если ПОЛЬЗОВАТЕЛЬ введете три даты ? четыре ....(результат в любом случая будет правильный между 1 и 2 датой)
Но, можно сделать БОЛЕЕ правильно и логично
в параметрах ЮНИТА :
1. Убираем повтор
2. Копируем строку запроса
3. Меняем название Параметр
проверяем : ЮНИТ запросит СТРОГО ДВЕ ДАТЫ и выдаст результат.
СТОП - останавливает текущего ЮНИТБОТА
Данные ЮНИТ БОТЫ - полностью бесплатные (распространяются свободно)
их цель - только показать ВОЗМОЖНОСТИ ЮНИТБОТОВ и научится ими пользоваться
определяет день недели по введённой дате
7.34 кб.
определяет разницу в дня между двумя датами
7.09 кб.
Случайная крылатая фраза или пословица
8.85 кб.
Оправить сообщение или вопрос пользователю (можно получить ОТВЕТ или Выключить программу)
11.06 кб.
Вводим дату или период , выбираем магазин, кассу и получаем АНАЛИЗ ВЫРУЧКИ
22.07 кб.
Если вы закроете программу MAGAZKA
то Телеграм бот - перестанет работать, но он оповестит все своих пользователей
Как магазин откроется - так заработает и чат бот (табличка смениться)
ПРОДОЛЖЕНИЕ СЛЕДУЕТ....
Протестировать: (ПИН КОД : 2907 , ПАРОЛЬ МАГАЗЬКА :12345)
