Назначение
Расширение позволяет отправить сообщение с произвольным текстом в мессенджер Telegram через ваш Telegram-бот с прикреплением сформированной печатной формы, комплектом печатных форм, сформированным отчётом или любым произвольным табличным документом в любом поддерживаемом 1С формате. Поддерживается прикрепление произвольных вложений, выбранных с локального или сетевого диска.
После установки расширения в форму печати и форму отчета добавляется кнопка "Отправить в Telegram". Также добавляется глобальное сочетание клавиш Alt+t, позволяющее отправить из активной формы любой табличный документ, включая даже вручную заполненные файлы в формате mxl или сформированные с помощью команды "Вывести список".
Отправка сообщения происходит с помощью одноименной типовой формы из состава БСП ("ОбщаяФорма.ОтправкаСообщения").
Перед отправкой сообщений в Telegram необходимо добавить как минимум одного бота в соответствующий справочник. Для настройки минимально необходимо указать его токен, полученный от @BotFather, и его наименование. При создании бота в 1С сразу же проверяется возможность подключения с выводом диагностических сообщений. Инструкция по созданию ботов на VC.RU, вполне подробная.
Для хранения идентификаторов получателей сообщений в Telegram добавлен соответствующий функционал. Можно добавить неограниченное количество получателей с указанием принадлежности к определенному боту и виду справочника. Добавление идентификаторов доступна в любой справочник, подключенный к подсистеме "Контактная информация".
Для пакетной загрузки идентификаторов чатов можно воспользоваться обработкой Загрузка данных из Telegram.
Состав справочников в 1С:ERP
Подключение
Расширение подключается в режиме предприятия в разделе Администрирование > Печатные формы > Расширения. Отключить безопасный режим. Функционал расширения будет доступен после перезапуска сеанса 1С:Предприятие. Для добавления ботов, чтения и записи идентификаторов получателей пользователю без полных прав необходимо назначить роли Добавление изменение Telegram, Чтение данных Telegram.
Требования
Среда разработки: ОС Windows 10x64, файловый режим 1С:Предприятие 8.3 (8.3.23), ERP 2.5, КА 2.4, ЗУП 3.1, БП 3.0, УНФ 3.0, однако расширение должно быть полностью универсально для типовых конфигураций на базе БСП 3.1.
Режим совместимости расширения - 8.3.16
Для просмотра ботов и получения данных идентификаторов пользователь должен обладать правами "Чтение данных Telegram". Для добавления и изменения этих данных - "Добавление изменение Telegram".
Кнопка отправки добавляется только в типовые формы "Печать документов" и "Форма отчета", в остальных местах можно использовать через хоткей Alt+t. Особенно актуально для БП, в ней полно отчётов с собственной формой.
Для отправки данных на сервере должен быть открыт доступ по https к серверу Telegram по порту 443, возможно потребуется настройка брандмауэра.
Код открыт, предложения по доработке принимаются.
