Отправка в Telegram отчетов, печатных форм, присоединённых файлов и произвольных вложений. Загрузка получателей. Хранение истории отправок.

Назначение

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

Реализована фоновая и ручная загрузка идентификаторов получателей Telegram и их сопоставление с объектами информационной базы.

Поддерживается хранение истории отправленных сообщений с ограничением срока хранения и автоматической очисткой по истечении этого срока.

Технические требования

Среда разработки: ОС Windows 10x64, файловый режим 1С:Предприятие 8.3 (8.3.23):

• 1С:УТ 11.5
• 1С:ERP 2.5
• 1С:КА 2.5
• 1С:ЗУП 3.1
• 1С:БП 3.0
• 1С:УНФ 3.0, однако расширение должно быть полностью универсально для типовых конфигураций на базе БСП 3.1.

Режим совместимости расширения - 8.3.16

Для просмотра ботов и получения данных идентификаторов пользователь должен обладать правами "Чтение данных Telegram". Для добавления и изменения этих данных - "Добавление изменение Telegram".

Кнопка отправки добавляется только в типовые формы "Печать документов", "Форма отчета" и "Присоединённые файлы", в остальных местах можно использовать через хоткей Alt+t. Особенно актуально для БП, в ней полно отчётов с собственной формой.

Для отправки данных на сервере должен быть открыт доступ по https к серверу Telegram по порту 443, возможно потребуется настройка брандмауэра.

При скачивании обращайте внимание на версию БСП своей конфигурации.

БСП - это совместимость конфигурации с библиотекой стандартных подсистем, так что расширение будет работать с любой конфигурации с учетом версии БСП.

БСП 3.1.8+

• 1С:Управление торговлей 11.5.12.185
• 1С:Зарплата и кадры государственного учреждения, 3.1.28.35
• 1С:Зарплата и управление персоналом, 3.1.28.35
• 1С:Управление нашей фирмой 3.0.5.145
• 1С:Бухгалтерия предприятия КОРП 3.0.144.49
• 1С:УНФ 3.0.3.169/3.0.4.45
• 1С:ERP 2.5.12.160 (середина ноября 2023) и 2.5.14.59 (середина октября 2023) - 3.1.9 
• 1С:КА 2.5.12.160/2.5.14.59- 3.1.9 

БСП 3.1.7-

• 1С:УНФ 3.0.3.169 - (от середины апреля 2023)
• 1С:ERP Управление предприятием 2.5.9.119/2.5.12.147
• 1С:КА 2.5.9.119/2.5.12.147

Код открыт.

Порядок работы

Ссылки на добавленные объекты подсистемы вынесены в раздел Администрирование -> Органайзер (кроме УНФ, где размещение вынесено в раздел Администрирование -> Интернет-поддержка и сервисы).

После установки расширения в формы печати, присоединённых файлов и отчета добавляется кнопка "Отправить в Telegram". Также добавляется глобальное сочетание клавиш Alt+t, позволяющее отправить из активной формы любой табличный документ, включая даже вручную заполненные файлы в формате mxl или сформированные с помощью команды "Вывести список". См. пример.

Перед отправкой сообщений в Telegram необходимо добавить как минимум одного бота в соответствующий справочник. Для настройки минимально необходимо указать его токен, полученный от @BotFather, и его наименование. При создании бота в 1С сразу же проверяется возможность подключения с выводом диагностических сообщений.

Для хранения идентификаторов получателей сообщений в Telegram добавлен соответствующий функционал. Можно добавить неограниченное количество получателей с указанием принадлежности к определенному боту и виду справочника. Добавление идентификаторов доступна в любой справочник, подключенный к подсистеме "Контактная информация".

Автоматическая фоновая загрузка идентификаторов получателей активируется для каждого бота раздельно в разделе Органайзер -> Настройка загрузки или прямо из формы бота.

В конфигурациях с внедренной подсистемой "Шаблоны сообщений", поддерживается формирование текста сообщения по шаблону.

Настройки прокси-сервера для отправки берутся из персональных настроек конфигурации (типовой функционал БСП). Переключать использование прокси и настраивать параметры прокси-сервера можно прямо из формы отправки сообщения.

Хранение истории отправок задается на уровне каждого Telegram-бота и может быть ограничена по времени хранения с ручной и автоматической очисткой по расписанию. В истории сохраняется полный лог отправки, включая дату отправки, получателя, текст сообщения и данные вложений. Вложения можно просматривать и выгружать в локальное хранилище как по текущей отправке, так и по выделенной группе.

Подключение

Расширение подключается в режиме предприятия в разделе Администрирование -> Печатные формы -> Расширения. Отключите безопасный режим. Функционал расширения будет доступен после перезапуска сеанса 1С:Предприятие. Для добавления ботов, чтения и записи идентификаторов получателей пользователю без полных прав необходимо назначить роли Добавление изменение данных Telegram, Чтение данных Telegram.

Отправка сообщений происходит с помощью одноименной типовой формы из состава БСП ("ОбщаяФорма.ОтправкаСообщения").

Техническая поддержка и обновления

Бесплатный период техподдержки составляет 1 месяц со дня покупки

Также после приобретения вы получаете 1 месяц бесплатных обновлений.

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

Проверить наличие обновлений можно в личном кабинете. Если обновления недоступны - загрузить новую версию можно после покупки обновлений/технической поддержки.

Задать вопрос по программе можно по кнопке "Техподдержка" на странице описания.

При создании тикета необходимо предоставить:

1. Номер заказа
2. Описание вопроса. Если это ошибки - напишите порядок ваших действий с программой, которые к ней привели (приложите видео/скриншоты/отчеты об ошибке)
3. Точную конфигурацию 1С, и версию платформы, на которой используете купленное решение (наименование и версию 1С можно взять из раздела "О программе"), версию купленной программы.

К созданной заявке подключается специалист. Дальнейшее обсуждение проблемы будет проходить в тикете техподдержки. Стандартный срок реакции - 24 часа в рабочие дни с момента обращения.

Техподдержка