Но максимальный эффект и польза от подсистемы будут достигнуты с помощью квалифицированного программиста.
В подсистеме есть поддержка эмодзи.
Подсистема писалась для обычных форм, толстого клиента, но может быть легко переделана и под управляемые формы (планируется в следующих версиях).
Подсистема тестировалась на платформе 8.3.14.1694
Подсистема больше рассчитана на то, что пользователи бота – известные вам люди, например, руководители, которые хотят получать отчеты о деятельности компании, или менеджеры, которые должны с помощью бота делать заказ в 1С.
В меньшей степени она подходит для поддержки широкого пула клиентов, например, в качестве бота службы поддержки. Однако она легко может быть расширена благодаря тому, что…
Подсистема предлагает три уровня:
- Пользовательский
- Интерфейса
- API
Пользовательский уровень
На этом уровне располагаются настройки ботов и справочники с дополнительными возможностями.
Работа с этим уровнем упростит взаимодействие с ботом и настройку различных меню и кнопок в чате.
Краткое описание справочников:
Боты
– справочник ботов, с которыми должна взаимодействовать подсистема.
В этом справочнике достаточно ввести токен бота и нажать кнопку «Тест». Подтянутся настройки бота. Тут же можно установить или сбросить webhook.
Останавливаться на том, что такое webhook или токен бота, не буду, про эту часть настройки в интернете много информации, достаточно поискать по запросу «BotFather» или «регистрация бота в телеграм». Скажу только, что «входящий токен» – это исключительно внутренняя сущность подсистемы, добавленная для безопасности взаимодействия с ботом. Полный адрес вашего webhook будет https://урл-вашего-сайта/hs/telegram/входящий-токен – разумеется, после публикации http-сервиса «Webhook (Телеграм)».
Для режима Webhook предусмотрена опция «Автопинг». При включенной опции база периодически будет пытаться установить соединение с опубликованным webhook и получить ответ. Для корректной работы, убедитесь что сама база имеет доступ к адресу webhook и, если используется самоподписанный сертификат, то он должен быть добавлен в доверенные. При ошибке соединения будет вызвана функция ОшибкаАвтопинга модуля ЮК_ТГ_Пользовательский и, если настройка «Чат уведомления» заполнена, будет отправлено соответствующее сообщение об ошибке в выбранный чат.
Работа в режиме получения сообщений из очереди по запросу тоже поддерживается. В этом случае вам не нужно публиковать http-сервис, в подсистеме предусмотрено регламентное задание и кнопка «Обработать очереди» в справочнике «Боты».
После регистрации бота вы можете переходить к справочнику…
Чаты
– список всех чатов, о которых знает бот.
В этот справочник автоматически добавляются все пользователи и группы, от которых бот получает сообщения. И тут же есть возможность установить флаг, можно ли боту взаимодействовать с данным чатом.
Команды из чатов, с которыми боту взаимодействовать не разрешено, будут игнорироваться, кроме команды «/start», ответ на которую будет выглядеть вот так:
После того как регистрация выполнена и связь налажена, рассмотрим как работают…
Команды
– справочник поддерживаемых команд бота, которые вызываются через символ слэш.
В этом справочнике вы можете указать, какое действие (о действиях см. ниже) должно выполняться по вызову какой команды. Например, отправка ответного сообщения или вызов…
Клавиатуры
– клавиатуры в нижней части чата
С помощью справочника «Клавиатуры» можно описать иерархическое меню клавиатур и действия, которые будут выполняться по нажатии на ту или иную кнопку.
При этом если у кнопки прописано действие и есть дочерние элементы, то будет выполнено действие и показана новая, дочерняя клавиатура.
Клавиатура может быть вызвана командой ЮК_ТГ_Сервер.ПоказатьКлавиатуру
И, наконец, последний справочник – это…
Быстрые ответы
– ответ какой-то фразой и картинкой, если в сообщении найдено некое выражение, либо выполнение произвольного кода.
Выражение задается регулярным выражением, используется COMОбъект("VBScript.RegExp").
И несколько слов о справочнике…
Действия
Справочник действий содержит выполняемые ботом действия. Действие может быть нескольких типов: выполнение произвольного кода, запрос текстового значения, предложение выбора из списка и условие.
Каждое действие может ссылаться на следующее действие, а в случае с условием – на два. Благодаря этому можно организовать цепочки действий, ветвления и циклы. Что позволяет создать разветвленные опросники, анкеты и ввод произвольных данных.
Например, в демобазе по кнопке «кнопка 1» будет выполнен следующий алгоритм:
И остановимся немного подробнее на действии типа «Выбор». Вы можете предложить пользователю выбор из произвольного списка, сформированного программно. Например, из справочника:
В конце концов, после всех стандартных обработок подсистемы, вы можете самостоятельно обработать сообщение при помощи процедуры…
ЮК_ТГ_Пользовательский.ОбработатьСообщение
Процедура ОбработатьСообщение общего модуля ЮК_ТГ_Пользовательский будет вызвана после всех обработок подсистемы для входящего сообщения (по обработке очереди или webhook), и вы можете самостоятельно дополнительно обработать входящее сообщение.
Уровень интерфейса
Если все вышеописанное вам не очень нужно или вы хотите расширить существующий функционал, то вы можете воспользоваться уровнем интерфейса. Это набор функций общего модуля ЮК_ТГ_Сервер. Таких как:
- ОтправитьСообщение;
- ОтправитьКартинку;
- ОтправитьФайл
- и т.д.
Эти функции являются обертками над уровнем API самого телеграма и используются пользовательским уровнем подсистемы.
На этом уровне реализованы не все функции-обертки, предоставляемые API (расширить планируется в следующих версиях).
В модуле ЮК_ТГ_Пользовательский есть процедура ПередОбработкойОбновления, которая будет вызвана перед обработкой обновления (сообщения от телеграма) и по флагу СтандартнаяОбработка может отменить обработку сообщения стандартными процедурами подсистемы.
Если же даже это для вас лишнее, то добро пожаловать на…
Уровень API
Этот уровень представлен двумя функциями модуля ЮК_ТГ_Сервер:
ЗапросКБоту – отправляет произвольную команду боту;
ЗапросКБотуСФайлами – отправляет произвольную команду боту с файлами (формат multipart/form-data).
Эти функции используются самой подсистемой (уровнем интерфейса) и являются практически прямым вызовом POST-запроса к API телеграма.
И напоследок некоторые…
Примечания
В подсистеме предусмотрено подключение через прокси.
Настройки регламентных заданий автопинга и получения очереди можно найти в настройках подсистемы.
На уровне интерфейса и API все равно используется справочник «Боты», но можно обойтись и соответствующей структурой.
Если в функцию СообщитьОбОшибке модуля ЮК_ТГ_Сервер передать третьим параметром структуру с сообщением, то сообщение об ошибке будет выведено не только в окно служебных сообщений, но и в чат. Этим активно пользуется сама подсистема, чтобы уведомлять пользователя об ошибках.
Преобразованием текста в текст с эмодзи занимается функция ДобавитьЭмодзи. Как именно можно включить эмодзи в сообщение, написано в справке, которую можно получить по кнопке (?) при редактировании действия.
На создание подсистемы меня вдохновила публикация //infostart.ru/public/627500/
Про обнаруженные ошибки пишите на адрес me@zfilin.org.ua или в комментарии.
Так как подсистемой я пользуюсь сам в ежедневной работе, она поддерживается и будет обновляться.
Оригинал статьи в блоге автора
Спасибо за интерес к подсистеме, всем хорошего дня и хорошего кода.
Related Posts
Получение логина и пароля техподдержки 1С из базы
Класс для вывода отчета в Excel
Счет-фактура для УПП
Библиотека классов для создания внешней компоненты 1С на C#- Акт об оказании услуг (со скидками) — внешняя печатная форма для Управление торговлей 11.1.10.86
Прайс-лист с артикулом в отдельной колонке
не кажется ценник великоватым? при этом под обычные формы, мне кажется большинство, кому нужен телеграм, сидят в уф.
(1) Добрый день. Нет, ценник вполне оправдан.
Это рабочее решение с полностью открытым исходным кодом предоставляемое «как есть» без всяких ограничений по использованию.
Первое же использование у клиента окупает потраченные sm в разы.
УФ планируются в следующей версии. Если вам нужны именно УФ, можете подождать. Но сразу скажу, что почти все формы — с пустыми модулями, так как вся логика вынесена в общий модуль.
Телеграмм и солнце из телепузиков. Совпадение?…и далее по тексту.
10 см, подсистема, которую нужно встраивать (снимая с замка) и обычные формы)) Дайте угадаю — для вебхука ещё и база должна быть опубликована наружу?
Почему в этой стране каждый хочет с одной продажи неуникальной лицензии неуникального продукта купить себе дачу на Мальдивах?))
(4) Понимаете, дача на Мальдивах у меня уже есть, но туда неудобно добираться. Это пойдет на покупку частного самолета.
А, если серьезно, скиньте пожалуйста ссылку где можно взять аналогичное решение дешевле. Просто, я смотрю, людям дороговато, а так мы сможем предложить дешевое решение для тех кому дорого и мое для тех, кому нормально.
Например, вот, сопоставимое по функционалу решение предоставляется совершенно бесплатно —
Можно взять там. Я и в описании указал, что был вдохновлен той публикацией. Есть еще примеры, давайте поможем тем, кому дорого.
(5)
Цена всегда диктуется рынком.
Вот смотрите, во-первых, у вас встраиваемая подсистема. Как вы думаете, у меня вот УНФ на замке, например, и мне нужен телеграм. Нужна мне ваша доработка за 10 см? Перелопатить конфу, чтобы слать что-то в телеграм — уж не знаю, кому такое в голову придёт.
Обычные формы — как думаете, много пользователей сейчас на обычных формах?
Т.е. продукт, мягко говоря, неликвидный — и стоит при этом денег, за которые тут же на инфостарте можно купить что-то более полезное. В крайнем случае — самому написать этих ботов. Я писал — час ушёл на готовый рабочий вариант, ничего там заоблачного нет, обычная работа с интернетом.
Я потому и говорю про Мальдивы — потому что вы, видимо, написали немного кода, обрадовались, и под эндорфинами решили, что сейчас этот код сметут с полок за 10 см. Вы не анализировали свою аудиторию, кому может понадобиться ваш код, чем они пользуются, как будут использовать ваш продукт.
А по сути, без УФ, он мог бы подойти только как код, не как готовый продукт.
Я-то мимо проходил, мне всё равно, можете хоть 100 см попросить)) У нас тут один свой блокчейн на 1С продаёт даже за рубли. Правда, тоже никто не покупает)) Потому что вопрос не в дорого ли вообще, а в том, дорого ли вот конкретно это за конкретно эти деньги. Поэтому вам, вместо того, чтобы искать «альтернативы для нищебродов, ведь мой продукт — илитный, подходит не всем, только успешным и состоявшимся», нужно просто провести анализ аудитории хотя бы на пальцах. Либо просто продавать за 1 см, эта цена очень гармонична с тем, что выкладывалось по наитию, без анализа. На истину не претендую, всё сказанное — моё личное мнение.
(6) Спасибо за ваши замечания.
Разумеется, для УФ подсистема будет использовать расширения, чтобы не снимать конфигурацию с замка.
Что же касается неликвидности, Мальдив, анализа аудитории и прочего. Это рынок. Если вас не устраивает цена — не покупайте, есть более полезные и более дешевые вещи, которые можно купить за 10sm.
Опять же, как вы и сказали, можно написать самому. Очень понимаю вас в этом смысле. Собственно, меня, например, не устраивала цена в 6499 руб. я сделал свое и дешевле.
Почему бы вам не написать свою подсистему (час работы всего-то) и не выложить за 1sm?
Но, боюсь, что этого не произойдет. Вы сделали предположение на мой счет, я сделаю на ваш. Вы из тех, кто вечно «я-то мимо проходил». Кто в первых рядах, когда надо обсуждать и критиковать, но когда нужно просто взять и сделать — «я мимо проходил, делайте как хотите, это просто мое мнение».
Здесь мне видится еще одна проблема, Телеграмм — это как бы достаточно специфичный мессенджер со своей, специфичной, аудиторией. В то время как ЦА этой подсистемы почти поголовно сидит в Viber и Whatsapp. Ставить отдельный мессенджер для сотрудников, особенно руководства — идея так себе.
(12) Это да… Надежда на заказчиков, которые все-таки пользуются телеграмом.
(13) Сколько мы не пытались прикрутить Телеграм к реальным бизнес процессам — обычно все оставалось на уровне «да, прикольно, а под Viber/Whatsapp так можно?».
(14) В наших краях с таким не сталкивался, но это может мне так исключительно повезло, что все вокруг телеграмом пользуются. Хотя, вайберо/вацап тоже в почете.
Однозначно плюс
Насчёт выбора месенждера, это можно как говориться и приучить пользователя, главное что бы работало хорошо и быстро. Просто показать все возможности, но и другие месенждеры тоже хороши.
Просто телега даёт открытый апи, бери и сразу пользуйся
У всех «публичных» месенджеров есть один очень важный недостаток. Их основное назначение частная жизнь и меня (и коллег в частности) отчасти достаёт смешение работы и личного пространства. А загнать то так конечно куда угодно можно.
Я всеми руками поддреживаю расширяемость телеги, но она превращается в какую-то помойку личных сообщений, ботов, новостных лент и т.п.
Так что мне ближе таки чтобы для корпоративного использования было отдельное приложение. Ну или на выбор самого «клиента».
(20) Ну они обещали группы, так можно было бы как-то упорядочить помойку. Но пока в базовой версии групп нет. =(
(14) На Viber это переделать совсем не сложно. Есть подобная подсистема, которая работает одновременно на Telegram, Viber, Facebook
(21) В десктопной версии есть «Рабочий режим», когда можно скрыть все каналы и неважные чаты
(22) О! Круто. А можно ссылку? Было бы любопытно посмотреть.
(24) Ссылки пока нет. Приезжайте в Питер, буду рассказывать. 🙂
(25) Понятно. =)
(22) Только вы забыли сказать, что у Viber, как и Whatsapp, API закрытый и доступен только по платной подписке, что резко снижает число желающих… Потому как боты по большому счету пока баловство, нет в них насущной необходимости.
(27) Нет, API Viber открытый и бесплатный. Зайдите на , создайте бота и работайте.
С WhatsApp все сложнее… У них сейчас вообще нет запущенного API, идет пока тестовый запуск. Когда будет полностью запущено, посмотрим, что у них с условиями использования будет.
(20)
Это и есть самая большая проблема, к которой еще добавляется слабый контроль за таким каналом связи. А еще веселей, если сотрудник увольняется или уходит к конкурентам. В корпоративном приложении заблокировал аккаунт и все. А тут вся история остается у него, со всеми документами, переписками и т.д. и т.п. Принудительно отбирать и чистить телефон при увольнении?
(29) Может проще давать корпоративную симку и на нее привязывать телеграмм?
После ухода сотрудника все история общения останется в компании.
Ну а кто жлобится, пусть сам и расхлебывает такое.
Как идея написать расширение на УФ. Большинство конфигураций на 8.3.12 уже могут работать с этим.
На ОФ конечно только подсистема.
(31) Расширение для УФ будет. Уже включено в план.
(30) Не поможет симка. Данные хранятся на устойстве, а не сим карте. Кроме того это устройство может быть вообще без модуля сотовой связи. Какая гарантия, что сотрудник не установит себе на домашнем ПК телеграм, зарегистрировав его на служебную учетку с помощью еще пока работающего (он же еще не уволился) корпоративного телефона. И вся история будет сохраняться на его домашнем ПК.
Например, у меня телеграм стоит на телефоне и ноутбуке. А бывало, что и на нескольких разных телефонах одновременно. Под одной учеткой. И вся переписка синхронизируется на всех устройствах.
в полку прибыло 😉 я автор 😉
(34)
Собственно о том и речь. Если мы блокируем доступ в корпоративном приложении — то мы можем быть уверены, что больше бывший сотрудник туда не зайдет. А с мессенджерами есть очень много очень разных вариантов. И у Телеграма с этим хуже всего, сквозного шифрования по умолчанию нет, можно добавить хоть 100500 устройств и на каждом будет копия переписки.
У того же Viber получше, но можно добавить свой номер, сделать бекап и корпоративная симка более не нужна, вся история будет доступна и с новой симкой.
(30)
Все осложняется тем, что мессенджеры народ широко использует в личных целях и скорее всего на телефоне сотрудника они уже будут, с привязками к его личным симкам, естественно. Как вы собираетесь переключить его на корпоративную сим? Снеси свой Viber, где у тебя все друзья-подруги, родственники и т.п. и поставь новый, с корпоративным ботом? Догадываетесь куда вас пошлет сотрудник?
(29) а корпоративное приложение не даёт сохранять данные на телефона/делиться по почте? В телеграме можно снести любое сообщение так, что следов почти не останется (только если на него отвечали, останется текст «Удаленное сообщение»).
(35) О! У вас отличное решение, я всем рекомендую, кому нужна не «почти коробка», а «совсем коробка».
Прошу Вас уточнить следующие вопросы 1.как работает программа с эмоджи? Возможно хранить их в 1С и выводить в сообщениях или названиях кнопок? 2. Скорость отлика телеграмм бота идет с задержкой или ответ поступает моментально. 3. Возможно работать с сервером телеграмм через прокси. В связи с его блокировкой на территории РФ? 4.Использует программа webhook?
(39) 1. В любых сообщениях и названиях кнопок вы можете вставить код эмоджи в формате U+xxxx+ и при выводе сообщения или названия кнопки код будет преобразован в картинку эмоджи. Найти необходимый код можно тут —
Вот, например, знак доллара — U+1F4B2+ (
2,4. Скорость отклика зависит от вашего интернет-канала. Но стороны 1С вы можете обрабатывать входящие сообщения по таймеру (регламентные события) не используя webhook, в этом случае будет задержка между вызовами обработчика. Либо сразу же по webhook. Система поддерживает оба способа.
3. На данный момент прокси не поддерживается, однако версия с поддержкой прокси сейчас в тестировании. Будет в ближайшее время, следите за обновлениями.
Эмоджи по коду неудобно. Программа должна быть запущена на сервере windows и работать 24 часа в сутки. Ее отключение приводит и к отключению бота?
Как Вы реализовали постоянный процесс опроса телеграмм сервера? И какие данные выводятся при ее опросе? Если информационное окно?
(41) В данный момент изменения работы с эмоджи не планируются, но вы можете внести предложение на почту me@zfilin.org.ua как именно вам было бы удобно.
Да, подсистема это «бэкенд» бота, который и взаимодействует с пользователем. При отключении подсистемы бот перестанет отвечать.
Телеграмм бот может реагировать и на другие события. Например Отправить файл, звук, видео. Исправить выводимое ранее сообщение, интернет ссылки, другой вид клавиатуры, отключение клавиатуры. Это все предусмотрено у Вас?
И если это есть можно не вникая в код программы получить реферальную ссылку, выслать личное сообщение пользователю, и другие механизмы аналогичны как у работающие у ботов.
(42) Опрос сервера происходит по таймеру (регламентные события) не используя webhook, либо сразу же по webhook. Подсистема поддерживает оба способа.
(43) Все типы сообщений будут приняты, как входящие сообщения с соответствующими заполненными полями, которые вы можете обработать в процедуре ЮК_ТГ_Пользовательский.ОбработатьСообщение либо ЮК_ТГ_Пользовательский.ПередОбработкойОбновления
Какие информационные отчеты включены в вашу конфигурацию?
(45) Вы можете работать с подсистемой не вникая в ее код, но вообще не вникать в код не получится. Действия выполняемые ботом это все-равно некий код 1С.
(46) Конфигурация не предусматривает информационных отчетов.
(47)
регламентные события — Наличие MS SQL сервера обязательно для регламентные. Файловая версия обеспечит выполнение регламентных событий?
(47) webhook — Кроме данной обработки понадобиться еще web сервер? sql для выполнения регламентных событий?
(50) Наличие SQL сервера не является обязательным для выполнения регламентных заданий, но в файловом режиме должен быть запущен менеджер обработки регламентных заданий.
Подробнее на тему регламентных заданий и режима запуска 1С вам лучше почитать в специализированной теме на сайте.
Ваш бот настроен на администрирование чатов. Скажите пожалуйста возможно с помощью Вашей программы получить список пользователей чата?
(51) Для подключения webhook http-сервис должен быть опубликован. Это делается при помощи web-сервера.
Web Сервер, SQL, Круглосуточная работа, статический IP. Вы можете посоветовать провайдера сервера который это обеспечит?
(53) Подсистема не поставляется вместе с ботом. В демонстрационной базе указаны данные тестового бота. Для своего бота вы можете задать любые настройки, которые сочтете нужным.
(55) Да, напишите мне на почту, я могу посоветовать хорошего провайдера.
Прошу Вас мне объяснить чем Ваша разработка лучше чем аналоги на других языках ? Python или PHP?
(58) Моя разработка лучше, чем аналоги на других языках, тем что она может быть очень просто интегрирована в существующую учетную систему и взаимодействовать с ней (выборка и предоставление данных, ввод новых данных) без дополнительных «прослоек», сразу и «нативно».
(58) Я так понимаю, вы хотите улучшить свою криптобиржу с помощью подсистемы?
(34) Включить двухфакторную аутентификацию, пароль не давать. При уходе удалить из активных устройств все кроме рабочего.
Опубликована версия 1.0.1.0
Изменения в версии:
* добавлена поддержка подключения через прокси
А можно ли телеграм установить на ТСД?
Чтобы отсканировать штрих-коды в сообщение, нажать на кнопку в телеграмм боте и в 1с возник приходный ордер?
И чтобы телеграм показывал количество строк в сообщении?
С телефона неудобно камерой… Возможно есть такая модель ТСД, которая и отсканировать штрих-коды может быстро и сфотографировать. Сделанные фотографии приложить в сообщении телеграм и прикрепить к приходному ордеру.
Особенно интересно чтобы эта модель сканера могла отсканировать номера купюр(не штрих-коды) на банкнотах и сформировать ведомость для инкассаторов.
(63) про ТСД не знаю, но это же отличная идея! Мне и в голову не приходило, что телефон с камерой можно использовать в качестве ТСД с ботом. Бюджетный вариант для тех кому покупать ТСД дорого, а телефон есть и автоматизации хочется. Надо только найти хорошую библиотеку распознавания ШК из картинки.
Спасибо, кажется, я смогу ещё заработать на своей подсистеме, у меня было пару желающих, которым я не мог ничего предложить.
Опубликована версия 1.0.3.2
Изменения в версии:
* Добавлен режим «Автопинг». При включенном автопинге база периодически пытается установить соединение с веб-сервисом и в случае ошибки посылает сообщение в выбранный чат.
* исправлено несколько мелких багов
Если вы уже скачивали подсистему и хотите получить обновление, напишите мне сюда в личные сообщения.
Опубликована версия 1.0.3.4
Изменения в версии:
* мелкие исправления и интерфейсные улучшения
(если вы уже скачали подсистему и хотите получить это обновление, напишите мне в ЛС)