Конструктор ботов Телеграм— лёгкая и универсальная интеграция 1С с Telegram

Обмен - Обмен с другими системами

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

Достоинства представленного решения:

  • Никаких дополнительных компонент для использования решения устанавливать не требуется
  • Для базового варианта интеграции достаточно только интернета
  • Легко, по инструкции, устанавливается на любую конфигурацию, соответствующую перечисленным под следующим заголовком требованиям. Не пересекается с любыми другими модулями и справочниками любого другого решения. Не требует установленной БСП (библиотекти стандартных подсистем).
  • Можно создать больше чем одного бота. Разные боты могут интегрироваться с Telegram разными способами, в зависимости от Вашей ит-инфраструктуры.
  • Все возможные обрабатываемые команды, а также обрабатываемые нажатия клавиатур, содержатся в справочнике “Сервисы”. Один элемент справочника Сервисы может ловить и обрабатывать или одну, или несколько, или все команды бота.
  • Все возможные ответы в Телеграм из 1С содержатся в справочнике “Обработки”.
  • Одному “Сервису” можно назначить множество “Обработок”, и наоборот — одна “Обработка” может вызываться из множества “Сервисов”.
  • Лёгкое задание стандартных и контекстных (привязанных к сообщению) клавиатур — через справочник “Клавиатуры”. При необходимости, используя любой элемент справочника “Клавиатуры” как шаблон (кнопка “Код клавиатуры” в любом элементе справочника “Клавиатуры”), можно создать программную клавиатуру с динамически генерируемыми клавишами (то есть когда набор кнопок клавиатуры заранее не определён)
  • Лёгкое создание ответов из 1С в Telegram благодаря шаблонам. Доступны 10 шаблонов, позволяющих в интерактивном режиме собрать структуру ответа именно в том виде, который Вам нужен. Шаблоны раскрывают всю функциональность решения и сводят задачу к подстановке значений в переменную типа “Структура”. Шаблоны позволяют легко подставлять клавиатуры, оперировать настройками сообщения, отправлять файлы, соблюдая синтаксис общения с Telegram. Шаблоны можно добавлять и менять. Доступные по умолчанию шаблоны: 
    • отправка сообщения, 
    • отправка фото, 
    • отправка видео, 
    • отправка файла, 
    • отправка аудио, 
    • отправка голосового сообщения, 
    • загрузка файла, 
    • отправка местоположения, 
    • отправка места на карте, 
    • редактирование контекстной клавиатуры.
  • Лёгкое задание наборов условий в справочнике “Наборы условий”. Благодаря наборам условий можно задать правила авторизации (различные группы доступа, например, сотрудники или клиенты), фильтрации по содержимому (например, сообщение содержит изображение, содержит файл, местоположение и прочее), срабатывания обработок по условиям. В набор условий также можно добавить свою программную проверку, возвращающую значение [ложь|истина] в переменную Ответ.
  • Лёгкая настройка запоминания контекста общения. Это означает, что путём запоминания параметров контекста текущего чата можно настроить осмысленный разветвлённый диалог, состоящий из последовательных вопросов и ответов.
  • Предусмотрен регистр “Настройки пользователей”, который поставляется в виде “полуфабриката”. В зависимости от Ваших потребностей Вы можете самостоятельно добавить в регистр ресурсы (например, сопоставить с идентификатором чата пользователя, контрагента, менеджера, курьера, права, любую сопутствующую информацию), и тогда данные регистра будут отображаться в накопленных данных любого входящего из Telegram сообщения, будут доступны для анализа и при формировании ответа.
  • Реализованный в решении подход универсален и позволяет использовать любой метод Telegram. Вы сможете самостоятельно выполнить даже метод , который появится после выхода последнего релиза решения, при этом Вам не придётся обращаться к средствам HTTP (HTTPСоединение, HTTPЗапрос, HTTPОтвет, тело запроса, адрес ресурса). Достаточно будет указать название метода и параметры структурой. За выполнение любого метода отвечает функция ТелеграмAPI.ВыполнитьМетод(Бот, Метод, СтруктураПараметров). Все доступные боту Telegram методы и их параметры описаны в https://core.telegram.org/bots/api
  • Доступно использование эмодзи

Требования

  • Платформа 8.3.7.1759 или выше
  • Режим совместимости не используется или не ниже 8.3.7
  • Управляемые формы
  • Наличие интернета
  • Включённая возможность внесения изменений в конфигурацию, если решение будет устанавливаться на существующую конфигурацию

Заблуждение: бот не может самостоятельно отправлять сообщения пользователям

На самом деле, может. Никаких ограничений нет, если конечно бот добавлен и не заблокирован.

Структура “НакопленныеДанные” — ещё одно облегчение при обработке входящего обновления (сообщения)

Структура сопровождает любое входящее сообщение, в дополнение к справочникам “Сервисы” и “НаборыУсловий”, и содержит всю необходимую информацию, которая поможет Вам при обработке сообщения:

НакопленныеДанные.ДанныеБота.Бот — текущий бот, <СправочникСсылка.ТелеграмБоты>
НакопленныеДанные.ДанныеБота.Жетон — жетон бота, <строка>
НакопленныеДанные.ДанныеБота.Имя — представление бота, <Строка>
НакопленныеДанные.ДанныеБота.Смещение — последний обработанный ботом идентификатор обновления, <Число>
НакопленныеДанные.ИдентификаторОбновления — идентификатор текущего обновления, <число>
НакопленныеДанные.ИдентификаторСообщения — идентификатр сообщения, <число>
НакопленныеДанные.ИдентификаторЧата — идентификатор чата, <число>
НакопленныеДанные.ВидВходящегоОбновления - вид входящего обновления, определямый на основании содержания обновления, <Перечисления.ТелеграмВидыВходящихОбновлений> (чаще всего Сообщение)
НакопленныеДанные.Обновление — обрабатываемое обновление https://core.telegram.org/bots/api#update, <ОбъектXDTO>
НакопленныеДанные.Сообщение — сообщение, https://core.telegram.org/bots/api#message, <ОбъектXDTO> или НЕОПРЕДЕЛЕНО
НакопленныеДанные.ТекстСообщения  — текст сообщения, <строка> или НЕОПРЕДЕЛЕНО
НакопленныеДанные.КонтекстСеанса — контекст сеанса, <Соответствие>
НакопленныеДанные.НастройкиПользователя - структура с настройками пользователя из регистра сведений ТелеграмНастройкиПользователя
НакопленныеДанные.ОтветКонтекстнойКлавиатуры — ответ контекстной клавиатуры, если ВидВходящегоОбновления = Перечисления.ТелеграмВидыВходящихОбновлений.ОтветКонтекстнойКлавиатуры, <строка> или НЕОПРЕДЕЛЕНО

Структура “ВходнойФайлСтруктура” — кардинальное облегчение при отправке любых двоичных данных

Структура передаваемых на сервер Telegram двоичных данных (файла)

ВидИсточника — <строка>, определяет, в каком виде предоставлены данные. Может принимать 4 значения — "Файл", "АдресВХранилище", "ДвоичныеДанные", "СерверТелеграм"
Источник — <строка>, имя файла, или адрес во временном хранилище, или двоичные данные, или строка-ссылка на сервер Telegram
ИмяФайла — имя файла для отображения получателю, например, mydog.jpg

Вопрос-ответ

Трудно ли настроить бота самому, если я начинающий программист 1С?

Нет, благодаря шаблонам, примерам и содержанию структуры НакопленныеДанные

Что нужно, чтобы создать своего бота?

Токен бота, выдаваемый ботом BotFather

Я скачал и установил демо-версию, что дальше?

Задайте токен бота и включите получение обновлений. Для этого откройте справочник “Боты”, откройте карточку демо-бота, скопируйте токен в поле “жетон”, запишите элемент. Нажмите кнопку “Панель получения обновлений”, установите значение “Периодичность, секунд” в “2”, нажмите “вкл”. Ваш бот работает. Это самый простой, но не самый удобный, способ получения обновлений с сервера Telegram.

Какие есть способы получения обновлений?

Способ

Плюсы

Минусы

Требования к базе

Обработчик ожидания формы

Самый простой и доступный способ, не требует ничего — ни SSL сертификата, ни web- адреса, ни серверной режима работы

Работает только при открытой форме списка справочника “Боты”

База может быть как файловой, так и серверной.

Периодический запрос

Не требует SSL сертификата и web-адреса

 

База должна быть серверной

Webhook (вебхуки)

Сервер телеграм сам присылает обновления по указанному web-адресу

Необходимы выделенный web-адрес и SSL сертификат. Можно использовать самоподписанный сертификат.

База должна быть опубликована на веб-сервере. Должен быть настроен HTTP-сервис “ТелеграмВебхук”.

Можно ли сделать так, чтобы ботом могли пользоваться только сотрудники фирмы?

Да, в зависимости от разных прав пользователи могут получать разный ответ, вариант аутентификация рассмотрен в примерах.

Можно ли использовать один бот и для сотрудников, и для покупателей, выдавая им различные ответы и клавиатуры?

Да, используя регистр “ТелеграмНастройкиПользователей”

Можно ли использовать бота, если у нас файловая база?

Да

Можно ли добавить бота в группу?

Да

Может ли бот отправлять/получать файлы, изображения, видео и прочее?

Да, легко, рассмотрено в примерах

Можно ли отправлять сообщения из других мест конфигурации?

Да, используйте модуль ТелеграмСервер на общих основаниях

Можно ли отправлять/получать геопозицию / местоположение?

Да, легко, рассмотрено в примерах

Что нужно дополнительно устанавливать? Нужно ли использовать dll или что-то другое?

Ничего дополнительно устанавливать не нужно, нужен только интернет

Требует ли решение дополнительной лицензии пользователя 1С?

Нет

Нужен ли ключ защиты для работы решения?

Нет

Нужна ли электронная лицензия?

Нет

Есть ли временные ограничения на использование решения?

Нет

Как это всё работает?

С помощью HTTP запросов и ответов на сервер Telegram api.telegram.org

Можно ли отправлять эмодзи?

Да, можно отправлять и вставлять в клавиатуры

Открыт ли код решения?

Да, за исключением NFR

Доступен ли код для изменения?

Да, за исключением NFR

Пример использования шаблона

Отправка файла

Заполнено:

Примеры

Вывод приветствия при начале работы с ботом

Создание и вывод клавиатуры

Загрузка пришедшего файла (шаблон "Загрузить содержимое")

Загрузка любого пришедшего файла осуществляется одной строкой

// Загружается двоичное содержимое сообщения, что бы это ни было  — документ, картинка, аудио, видео, голос.
// Результат загрузки попадает в НакопленныеДанные.ЗагруженныйФайл (<строка> или НЕОПРЕДЕЛЕНО)
ЗагрузитьФайл(НакопленныеДанные);

 

1: указать каталог сохранения файлов в боте

2: создать набор условий, благодаря которому мы сможем отфильтровать сообщения именно с файлами:

3: создать и заполнить сервис, в сервисе указать набор условий:

4: заполнить с помощью шаблонов обработку:

Результат: файл сохранён в C:\Temp\ТекущаяДата

 

Отправка присоединённого файла применительно к любой типовой конфигурации с БСП:

Настройка веб-хука

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

111.JPG

Ассоциация пользователя бота с пользователем конфигурации


Пользователь бота отправляет свой контакт. Отправка контакта рассмотрена в https://youtu.be/Q_O2usYkEkc?t=48m25s

 

 

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

Дополнительный плюс: лёгкая отладка

Если в коде обработки допущена ошибка, пользователь в любом случае получит ответ, даже если этот ответ — сообщение об ошибке. Такой подход облегчает отладку и гарантирует получение ответа от бота.

Пример — в обработке вывода текущей даты допущена грамматическая ошибка:

Результат работы обработки будет следующим:

 

Примеры нескольких из неограниченного числа бизнес-кейсов, которые можно реализовать с помощью решения:

Франчайзи

Сервис-инженер франчайзи, введя регистрационный номер ПП 1С, ИНН или название клиента, может получить:

Контактную информацию партнёра или контактных лиц

Список зарегистрированных ПП 1С

Срок действия ИТС (и отраслевой итс)

Список подключенных сервисов 1С (отчетность, автообновление, линк, фреш, облачный архив)

Срок действия прочих сервисов (антивирус и т.д.)

Список неоплаченных заказов покупателя

Список не возвращенных подписанных документов

Ввести время начала и окончания с созданием ЛУРВ

Автоматизация склада

При изменении обеспечения "Отгрузить" в заказе покупателя у кладовщика появляется сообщение о необходимости собрать товар, с номером и датой заказа, кому отгружаем и когда

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

При оплате/отгрузке заказа (даже частично) отправляется сообщение менеджеру

Автоматизация агента недвижимости

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

Обучающее видео

Настройка бота, справочник ботов — 0:10
Способы получения обновлений ботами (периодический запрос, вебхуки, обработчик ожидания) — 0:30
Получение о обработка сообщений от Телеграм (справочник Сервисы) — 3:35
"Привет, мир" — Учим бота воспринимать команду "Привет" — 4:30
Ещё один "Привет, мир": https://youtu.be/FkNOJRp7GyY
Отправка сообщений боту, использование шаблонов отправки — 6:10
Сервисы, которые ловят сообщения, и обработки, которые отвечают на сообщения, ещё раз, описание — 9:25
Пример, как на одно сообщение бота сформировать два ответа — 9:55
Клавиатуры, работа, виды, вывод, удаление — 10:25
Клавиатура стандартная, вывод и работа — 10:40
Клавиатура контекстная, вывод и работа — 11:29
Обработка событий от контекстной клавиатуры — 11:52
Аудио, использование шаблона отправки — 13:16
Отправка любых двоичных данных (аудио, видео, фото, голос, другое) — 14:35
Ещё о клавиатурах, создание клавиатур программным способом, вывод кода клавиатуры — 17:15
Эмодзи, использование — 19:20
Работа с контекстом сеанса (сохранение и использование промежуточных данных общения через бот) — 21:32
Последовательный опрос пользователя — 21:53
Параметры контекста, что это такое, как создавать и как устанавливать — 24:30
Программная установка контекста — 25:37
Наборы условий, что это такое и как их использовать — 26:15
Настройки пользователей, изменяемый регистр — 27:20
Сопоставление пользователя бота с пользователем, контрагентом 1С или любой другой сущностью — 27:45
Накопленные данные — важная переменная окружения. Содержание и использование накопленных данных — 28:00
Настройки пользователей — добавление ресурсов, изменение регистра, видимость в обработках — 29:40
Описание параметров методов, назначение, использование в шаблонах, сопоставление параметров Телеграм с параметрами 1С, редактирование сопоставлений и комментариев — 30:05
Параметры контекста, немного подробнее — 33:25
Обновление подсистемы "Конструктор ботов Telegram на 1С" — 33:47
Работа с параметрами контекста на примере демо-бота — 34:11
Редактирование контекстной клавиатуры на примере демо-бота — 35:30
Как сохранять двоичные данные (файлы, фотографии, аудио, видеосообщения, голос), полученные от пользователей бота Telegram, простой универсальный метод — 37:55
Ещё раз о том, как отправлять любые файлы с помощью шаблонов. Отправка непосредственно из 1С, с использованием значения типа ДвоичныеДанные или ссылки на временное хранилище — 42:45
Местоположение и место на карте, отправка и получение — 44:19
Использование параметров входящего сообщения (содержит аудио, содержит видео, содержит голосовое сообщение, содержит контакт, содержит место на карте, содержит местоположение, содержит подпись, содержит файл, содержит фото, содержит текст) в наборах условий — 45:15
НакопленныеДанные.Сообщение как тип данных Telegram, что это такое и как работать, используя описание API Telegram bot — 46:00
Получение контакта пользователя Telegram на примере демо-бота — 48:25
Вариант сопоставления пользователя Telegram с сущностью 1С (пользователь, контрагент) по полученному из контакта телефону — 48:25
Набор условий, описание возможности программной проверки — 49:00
Выводы и заключение, создание бота любой степени сложности — 50:05
Может ли бот петь? — 50:40

 

Внутренности

7000 строк кода, не считая многочисленных переделок и переписок. 3 общих модуля, 6 справочников, 8 перечислений, 2 плана видов характерстик, 5 регистров сведений.

Решение проверено через “Проверку конфигурации”

Решение проверено на совместимость стандартам разработки 1С через “1С:Автоматизированная проверка конфигураций”

Дополнительное преимущество — наличие NFR-версии

NFR позволяет полностью ознакомиться с решением, не покупая его, и сделать вывод о том, насколько оно подходит под Ваши требования. NFR полнофункциональна, не ограничена ни по времени использования, ни по количеству использования, ни по методам. Модули закрыты для просмотра и изменения

Дополнительное преимущество — наличие демо-бота

Демо-бот — как демо-конфигурация типовой поставки. Он представляет из себа набор сервисов, обработок, клавиатур, условий,  полностью рабочий и позволяет оценить функционал решения

Дополнительное преимущество — бесплатный месяц технической поддержки

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

  • Установка
  • Первая настройка
  • Способ реализации Ваших кейсов
  • Аутентификация
  • Заполнение сервисов, обработок, наборов условий
  • Другие прямые и косвенные вопросы

 

Гарантия возврата денег

Гарантия возврата денег

ООО "Инфостарт" гарантирует Вам 100% возврат оплаты, если программа не соответствует заявленному функционалу из описания. Деньги можно вернуть в полном объеме, если вы заявите об этом течение 14-ти дней со дня поступления денег на наш счет.

Программа настолько проверена в работе, что мы с полной уверенностью можем дать такую гарантию. Мы хотим, чтобы все наши покупатели оставались довольны покупкой.

Для возврата оплаты просто свяжитесь с нами.

Скачать файлы

Наименование Файл Версия Размер
NFR-версия конструктора ботов Telegram на 1С + Демо-бот 50 примеров + Инструкция (zip)
.zip 13,87Mb
05.06.17
46
.zip 13,87Mb 46 Скачать
Конструктор ботов Telegram на 1С + Демо-бот 50 примеров + Инструкция (zip) + Бесплатная техническая поддержка 1 месяц
21.11.2017
3500 руб.

Моментальная
доставка

Техническая поддержка 1 час
21.11.2017
1800 руб.


Новый тикет

E-mail*
Тема (вопрос)*

См. также