БИТ.ФИНАНС
Получение данных из 1С от бота Telegram
Получение данных из информационной базы от бота Telegram
В БИТ.ФИНАНС в механизме оповещений, уже было реализовано оповещение пользователей в Telegram по видам событий, например, о необходимости установки решения по визам. Но данный функционал не позволял отправлять данные информационного характера по запросу, поэтому был разработан новый механизм взаимодействия БИТ.ФИНАНС и бота Telegram. Для работы данного механизма и отображения раздела в интерфейсе необходимо включить константу «Получать информацию от бота Telegram» в Константы (БИТ) на закладке «Прочее».
После включении константы, появится новый раздел «Telegram», в котором расположены объекты, использующиеся в данном механизме. Для настройки данного механизма пользователю необходимо иметь роль - Администратор оповещений Telegram (кроме пользователей, имеющих полные права).
Справочник «Боты Telegram»
В справочник «Боты Telegram» было добавлено новое свойство – «Нужен пин-код» и само значение «Пин-код», которые необходимы для того чтобы отсечь не нужных пользователей, которые могут запросить регистрацию у вашего бота.
Также появилась возможность настройки прокси соединения:
Подробнее о данном справочнике и о том, как создавать своего бота, получить токен и т.д. описано в разделе руководства пользователя - «Оповещения в Telegram».
Справочник Чаты Telegram
В справочник было добавлено:
    • «Статус регистрации» - отображает статус регистрации данного чата для получения информации от основного бота, возможные значения – Ожидает регистрации, Запрещено взаимодействие, Разрешено взаимодействие. Все новые чаты появляются со значением «Ожидает регистрации», далее администратору необходимо либо разрешить, либо запретить взаимодействие данного чата. Про оповещения администратора о новых регистрациях подробнее в «Чаты для оповещений».
    • «Доступные команды» - табличная часть с командами основному боту Telegram, которые доступны данному чату.
    Подробнее о данном справочнике и о том, как найти и создавать чаты описано в разделе руководства пользователя - «Оповещения в Telegram».
    Чаты для оповещений
    Данный регистр сведений предназначен для указания чатов Telegram, которые необходимо оповещать о запросе новых регистраций к боту или о просьбе помощи другому чату.
      Чат может попросить о помощи с помощью команды /help , Telegram также задаст вопрос желаете ли вы поделиться своим контактом для чатов администраторов.
      Тогда чатам для служебных оповещений придет сообщение о запросе помощи.
      Справочник «Команды Telegram»
      Данный справочник предназначен для хранения команд боту Telegram. В справочнике имеется ряд предопределённых команд, которые уже могут использоваться.
        В элементе справочника «Команды Telegram» указывается следующее:
        1. «Команда Telegram» - команда Telegram должна быть указана только латинскими буквами, и не должна повторяться.

        2. «Текст, отображаемый на клавиатуре» - название кнопки на клавиатуре при взаимодействии с ботом непосредственно в Telegram.

        3. «Определение назначения команды» - описание предназначения команды, какая информация получается с помощью данной команды.

        4. «Использовать внешний запрос» - при установке данного флага, поле «Запрос» будет скрыто и откроется поле с выбором либо запроса из справочника «Запросы», либо другой команды Telegram. Данные из таблицы, полученной запросом выводятся построчно и последовательно. Рекомендуется между числовыми полями запроса добавлять строковые, для обозначения получаемой информации.
        5. «Использовать только период» - указывается, когда необходимо использовать в запросе только период как конкретную дату (стандартные на начало дня, на начало недели, на начало месяца и т.д.), то есть данные будут собираться на конкретную дату. Параметр &Период должен присутствовать в запросе, но добавлять его в таблицу Параметры запроса не нужно, т.к. он обрабатывается отдельно и добавляет в Telegram клавиатуру со стандартными значениями плюс произвольный период.

        6. «Использовать начало и конец периода» - указывается, когда необходимо использовать в запросе только период как диапазон, между началом и концом периода (стандартные за месяц, за квартал, за год и т.д.), то есть данные будут собирать за какой-то период. Параметры &НачалоПериода и &КонецПериода должны присутствовать в запросе, но, как и в п.5 добавлять их в таблицу Параметры запроса не нужно. Так же добавляется стандартный набор кнопок в Telegram.

        7. «Параметры запроса» - табличная часть в которой могут храниться необходимы параметры для запроса.

        8. «Запрос» - текстовое поле, в котором хранится полный текст запроса, который будет исполняться. Данные из таблицы, полученной запросом выводятся построчно и последовательно. Рекомендуется между числовыми полями запроса добавлять строковые, для обозначения получаемой информации.

        Форма «Взаимодействие с ботом Telegram»
        Данная обработка предназначена для взаимодействия с ботом Telegram, она опрашивает все чаты указанного бота Telegram на предмет появления новых сообщений боту и передает боту полученные данные для чатов, и также записывает всю историю взаимодействия в регистр сведений «Реестр обмена с Telegram». У обработки есть следующие возможности:
        1. «Бот для оповещений» - указывается основной бот для оповещений, с которым взаимодействует данная информационная база

        2. «Проверить соединение» - при нажатии кнопки будет произведена попытка подключения к указанному боту в виде тестового запроса

        3. «Запустить/Остановить взаимодействие» - запуск или остановка взаимодействия с указанным ботом Telegram. Пока у данной обработки не запущено взаимодействие, данный механизм не будет взаимодействовать с ботом, то есть информационная база не будет получать сообщения, которые были отправлены боту и не будет их обрабатывать.

        4. «Расписание» - указывается расписание взаимодействия с ботом, по умолчанию установлено каждые 5 секунд.

        5. «Отправить сообщение чату» - возможность отправить любое сообщение любому чату вручную.
        Реестр обмена с Telegram
        Данный регистр сведений предназначен для хранения истории взаимодействия с ботом Telegram, в нем регистрируются все сообщения, отправленные боту и все сообщения, которые отправил сам бот, а также сообщения, созданные вручную.
          Пример взаимодействия с ботом Telegram
          Пользователь, которому необходимо взаимодействовать с ботом Telegram, сначала должен найти вашего бота в Telegram (если у вас еще нет бота, смотрите раздел в руководстве пользователя «Оповещения в Telegram). Самый удобный способ найти бота - по его имени, например, @BitFinanceAlex_bot. Имя вводится в поисковую строку в Telegram.
          Далее боту необходимо отправить любое сообщение, в ответ на сообщение бот может запросить пин-код, если он установлен, после ввода пин-кода бот ответит, что ваша регистрация находится на рассмотрении.
          Чатам, которым необходимо получать оповещении о новых регистрациях и просьбе помощи (указывается в регистре сведений – Чаты для оповещений) придет оповещение от бота.
          Также в информационной базе, в справочнике «Чаты Telegram» создается новый элемент справочника со статус регистрации – Ожидает регистрации.
          Далее, если данному чату возможно взаимодействовать с ботом Telegram, необходимо поменять статус регистрации на – Разрешено взаимодействие. В этом случае чату придет сообщение –
          После этого Чату необходимо назначить доступные ему команды боту Telegram, делается это в элементе справочника «Чаты Telegram» в табличной части «Доступные команды».
          Теперь, если пользователь напишет любое сообщение боту, то в ответ ему придет сообщение от бота с клавиатурой доступных команд
          Далее пользователь может кликать на команды в клавиатуре, уточнять период, за который необходимо получить данные, и видеть ответ от бота
          Если нажать на команду «Больше команд», то список всех команд выведется сообщением
          Команды также можно отдавать сообщением с именем команды, например, /cashflow
          И это все мы сделали для вас!
          Подписывайтесь на нашу рассылку и узнавайте об изменениях в релизах первыми
          Подписывайтесь на нашу рассылку и узнавайте обо всем первые!
          Close
          Made on
          Tilda