К статье
Практический материал

Другое · 8 мин

Связь 1С с Telegram: настройка уведомлений и обмена данными

Практические способы интеграции 1С с Telegram: боты, уведомления, отправка документов, настройка вебхуков и проверка работоспособности связи.

Интеграция 1С с Telegram позволяет отправлять из информационной базы уведомления, отчёты, напоминания о документах и получать простые команды от пользователей. Связь обычно реализуется через Telegram-бота: 1С выступает клиентом, который вызывает методы Bot API, а Telegram доставляет сообщения в личные чаты или группы.

Выбор способа зависит от версии платформы, наличия доступа в интернет из сервера 1С и необходимости приёма входящих сообщений. Если достаточно односторонней рассылки, проще использовать исходящие HTTP-запросы к Bot API. Для диалога с пользователем понадобится вебхук или долгое опросрование обновлений, что предъявляет более высокие требования к сетевой доступности и безопасности.

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

Способы связи 1С и Telegram

Основной путь — интеграция через Telegram-бота и HTTP-интерфейс Bot API. Из 1С формируются запросы к методам API, например отправка сообщения в чат, а ответ от Telegram используется для оценки доставки. Этот подход подходит для уведомлений о проводках, статусах заказов, закрытии периодических задач и оповещениях ответственных.

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

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

Односторонняя рассылкаДостаточно исходящих запросов к Bot API

Проверьте доступ сервера 1С к адресам Telegram и наличие токена бота.

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

Убедитесь, что сервер доступен извне и порт не закрыт брандмауэром.

Отправка файловИспользуются методы отправки документов Bot API

Проверьте ограничения по размеру файла и типам вложений.

Создание бота и получение токена

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

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

Порядок действий
  1. 1
    Зарегистрируйте бота и скопируйте токен доступа
  2. 2
    Задайте в 1С адрес API и идентификатор целевого чата
  3. 3
    Настройте исходящее HTTP-соединение из информационной базы
  4. 4
    Отправьте тестовое сообщение и проверьте доставку

Настройка отправки из 1С через HTTP-сервисы

В 1С настраивают HTTP-соединение к конечной точке Bot API, формируют тело запроса в формате JSON и указывают заголовки, требуемые сервисом. Для отправки текстового сообщения достаточно метода sendMessage с идентификатором чата и текстом. Для документов и фото используются соответствующие методы с вложениями.

Важно обрабатывать ответы Telegram: успешная доставка подтверждается полем ok, а ошибки содержат код и описание. При неудаче 1С должна фиксировать событие в журнале регистрации и, при необходимости, повторять попытку через интервал, чтобы не потерять уведомление.

Отправка уведомлений о событиях

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

Не отправляйте одно и то же сообщение при каждом сохранении документа без проверки флага проведения или изменения критических реквизитов. Это приведёт к спаму в чатах и может вызвать блокировку бота со стороны пользователей или Telegram.

Получение сообщений и вебхуки

Для двухстороннего взаимодействия боту нужно получать обновления от Telegram. Можно использовать метод getUpdates с периодическим опросом, но тогда сервер 1С или промежуточный скрипт должен регулярно обращаться к API. Более отзывчивый вариант — вебхук: Telegram сам отправляет сообщения на указанный адрес.

Вебхук требует, чтобы сервер, принимающий запросы, был доступен из интернета по HTTPS и имел действительный сертификат. Самоподписанные сертификаты могут не приниматься Telegram, поэтому перед промышленным запуском проверяют доступность адреса извне и корректность SSL-соединения.

Приём команд от пользователей

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

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

Проверка и устранение неполадок

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

Типичные ошибки
01
Хранение токена бота в открытом модуле 1С или публичном репозитории
02
Отправка уведомлений при каждом сохранении без проверки флага события
03
Использование вебхука на сервере без доступа из интернета или с недействительным сертификатом

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

Альтернативы и ограничения

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

Контрольные точки

Как проверить результат

Тестовое сообщение из 1С в чат бота
Норма

Сообщение доставлено, в журнале 1С есть успешный ответ API

Тревожный признак

Ошибка HTTP, пустой ответ или отсутствие доставки

Вебхук при входящем сообщении
Норма

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

Тревожный признак

Тайм-аут, ошибка SSL или отсутствие реакции бота

Доступ пользователей
Норма

Сообщения приходят только указанным получателям

Тревожный признак

Сообщения уходят не тем контактам или бот заблокирован

Telegram накладывает собственные ограничения на частоту запросов, размер вложений и поведение ботов. Превышение лимитов может привести к временной блокировке, поэтому массовые рассылки лучше дозировать и отправлять не одновременно всем пользователям.

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

Итог

Что важно запомнить

Связь реализуется через бота и Bot API: проще настроить исходящие уведомления, сложнее — приём сообщений через вебхук; токен и адреса чатов хранят защищённо, а работу проверяют тестовыми сообщениями и журналами.

Нужен ли отдельный сервер для связи с Telegram?

Не обязательно. Если сервер 1С имеет выход в интернет и может делать HTTPS-запросы, достаточно настроить исходящее соединение к Bot API. Для вебхука потребуется отдельный доступный извне адрес или промежуточный сервис.

Можно ли отправлять файлы из 1С в Telegram?

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

Безопасно ли передавать через Telegram данные из 1С?

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

Что делать, если сообщения не доходят?

Проверьте токен бота, идентификатор чата, доступ сервера 1С к адресам Telegram и код ответа API. Для вебхуков убедитесь, что сервер принимает запросы по HTTPS и возвращает код успеха.