^{MAGAZKA - программа для магазина - МАГАЗьКА}

Урок № 35 Telegram боты и юнитботы в MAGAZKA
(от простого к сложному)

(урок подготовлен на основании релиза *.0371)

Вернуться к содержанию уроков

• Оглавление
• -  СОЗДАЕМ БОТА
• -  ЧТО НУЖНО, ЧТОБЫ "ОЖИВИТЬ" БОТА ?
• -  ОСНОВНЫЕ КОМАНДЫ ЧАТА
•  КОМАНДЫ (ЮНИТБОТЫ)
  
• КЛАДОВКА ЮНИТОВ

1. СОЗДАЕМ БОТА

Запускаем 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

 3. ОСНОВНЫЕ КОМАНДЫ ЧАТА

- СПРАВКА

пока 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. Меняем название Параметр 

проверяем : ЮНИТ запросит СТРОГО ДВЕ ДАТЫ и выдаст результат.

 СТОП - останавливает текущего ЮНИТБОТА

  

5. КЛАДОВКА ЮНИТОВ

Данные ЮНИТ БОТЫ - полностью бесплатные  (распространяются свободно)
их цель - только показать ВОЗМОЖНОСТИ ЮНИТБОТОВ и научится ими пользоваться

юнитбот_DATE.epf    

определяет день недели по введённой дате

7.34 кб.

юнитбот_DATE2.epf

определяет разницу в дня между двумя датами

7.09 кб.

 

юнитбот_FRAZA.epf

Случайная крылатая фраза или пословица

8.85 кб.

 

юнитбот_SEND.epf

Оправить сообщение или вопрос пользователю (можно получить ОТВЕТ или Выключить программу)

11.06 кб.

юнитбот_AVIR.epf

Вводим дату или период , выбираем магазин, кассу и получаем АНАЛИЗ ВЫРУЧКИ

22.07 кб.

 

Если вы закроете программу MAGAZKA

то Телеграм бот - перестанет работать, но он оповестит все своих пользователей

 

Как магазин откроется - так заработает и чат бот (табличка смениться)

ПРОДОЛЖЕНИЕ СЛЕДУЕТ....

Протестировать: (ПИН КОД : 2907 , ПАРОЛЬ МАГАЗЬКА :12345)

@TEST_UNITBOT_MAGAZKA

 

Вернуться к содержанию уроков