Перейти к содержимому
← Все статьи
10 мин чтения

Телеграм-бот для 1С: интеграция, права доступа и что делать, когда 1С недоступна

Телеграм-бот для 1С — это тонкий интерфейс: он принимает вопрос («остаток по артикулу», «где заказ 1042»), проверяет, кто спрашивает, и забирает ответ из 1С через HTTP-сервис или OData. Надёжность держится на трёх вещах: правах по ролям, идемпотентной записи заказов и плане на случай, когда 1С не отвечает. Ниже по порядку, где какая схема уместна.

Что бот делает с 1С и чем он не является

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

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

Читать проще и безопаснее, чем писать. Поэтому первая версия почти всегда состоит из чтения и одного-двух простых действий. Всё, что меняет учёт, добавляйте после того, как поймёте, как бот ведёт себя на реальных данных.

Общую картину способов обмена с 1С мы разобрали в статье про способы интеграции с 1С. Здесь сузим тему до одного сценария: интерфейс на базе бота.

Как бот получает данные из 1С: HTTP-сервис или OData

У платформы 1С:Предприятие есть два штатных пути для обращения извне. Первый — HTTP-сервисы: разработчик конфигурации сам описывает шаблоны URL, методы и обработчики. Второй — стандартный интерфейс OData: готовый REST-интерфейс над объектами метаданных, который включается при публикации базы на веб-сервере. По документации ИТС, OData доступен начиная с платформы 8.3.5, а HTTP-сервисы нельзя использовать в режиме совместимости 8.3.4 и ниже. Версию платформы и режим совместимости проверяйте до выбора схемы.

Если нужна точность, в справке по вашей версии платформы смотрите разделы «Стандартный интерфейс OData» и «HTTP-сервисы»: номера глав меняются от релиза к релизу, поэтому ищите по названию.

Выбор обычно простой:

  • HTTP-сервис — когда ответ должен быть готовым и компактным: «остаток по артикулу на складе X» одним запросом, ответ в том виде, который нужен боту. Бизнес-логика и расчёты остаются в 1С, а снаружи виден один узкий метод. Минус: нужен 1С-разработчик, а метод надо поддерживать при обновлении конфигурации.
  • OData — когда нужно читать справочники и документы как есть и вы готовы собирать ответ на стороне бота. Быстро запустить, но лишнюю работу (соединения, отборы, формат) делает ваш код. Состав публикуемых объектов можно ограничить, и это стоит сделать: наружу попадают только нужные справочники и документы.
  • Оба варианта работают по HTTPS и под отдельным пользователем 1С с минимальными правами. Бот не должен ходить под администратором и тем более под учётной записью живого сотрудника.
  • Если 1С стоит внутри офисной сети, наружу её открывать не обязательно: бот или слой между ним и 1С может жить в той же сети и сам ходить в Telegram.

Промежуточная БД или очередь: когда прямого вызова мало

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

Вторая схема — промежуточная база. Отдельный сервис (у нас обычно на Go с Postgres) периодически забирает из 1С нужные срезы: остатки, цены, статусы заказов — и кладёт их в свою таблицу вместе с временем обновления. Бот читает только эту таблицу. Ответ мгновенный, нагрузка на 1С предсказуема, а сама 1С может быть недоступна, и бот продолжит отвечать. Цена: данные немного устарели, и бот обязан показывать, на какое время они актуальны.

Третья схема — очередь для записи. Заказ, созданный в боте, не идёт сразу в 1С, а сохраняется у вас вместе с уникальным ключом и ставится в очередь на отправку. Воркер отправляет его в 1С, а при ошибке пробует снова с паузой. Пользователь получает честный статус «принято, отправляем в 1С», а не зависший экран. Как устроены очереди и воркеры в Go, описано в статье фоновые задачи и очереди на Go.

Что выбрать, подскажет несколько вопросов: насколько свежим должен быть ответ, сколько людей будет спрашивать и что произойдёт, если заказ придёт в 1С на десять минут позже.

  • Редкие запросы, мало людей, свежесть критична — прямой вызов HTTP-сервиса.
  • Частые чтения, остатки и цены, терпимо отставание на минуты — промежуточная база с периодическим обновлением.
  • Запись заказов и статусов — очередь с повторами и ключом идемпотентности.
  • Уведомления из 1С в бот — 1С или обработчик обмена отправляет событие в ваш сервис, а тот пишет в Telegram.

Права доступа: кто что видит в боте

Бот открывает данные 1С людям, которые раньше работали в интерфейсе с ролями и правами. Нельзя дать им больше, чем они имели. Telegram знает только идентификатор аккаунта и не знает, кто это в вашей компании, поэтому привязку делаете вы.

Рабочая схема: пользователь запускает бота, вводит одноразовый код или переходит по ссылке-приглашению, которую выдал администратор. Сервис сохраняет связь «Telegram ID — сотрудник или контрагент в 1С — роль». Дальше каждое действие проверяется по этой роли на вашей стороне, а не доверяется тексту, который прислал клиент. Любая кнопка может быть нажата вручную с подделанными данными, поэтому проверка нужна на сервере.

  • Роли заводите по задачам: «менеджер видит свои заказы», «кладовщик видит остатки и отгрузки», «руководитель видит сводки». Роль хранится у вас, а не в тексте кнопки.
  • Для клиентов фильтруйте строго по контрагенту: клиент видит только свои заказы. Ошибка в фильтре здесь утечка чужих данных.
  • Увольнение и смена роли должны отключать доступ сразу: сверяйте привязки со справочником сотрудников 1С или давайте администратору команду отзыва.
  • Не кладите в callback_data ничего чувствительного: по документации Telegram оно занимает от 1 до 64 байт, и в нём передают короткий идентификатор, а не данные.
  • Логируйте, кто и что запрашивал или менял, без персональных данных в тексте логов. Это пригодится при разборе спорного заказа.
  • Для опасных действий (отмена, изменение цены) добавьте подтверждение отдельным шагом. Как удержать такие шаги в связном диалоге, описано в статье про состояние диалога бота.

Идемпотентность: как не создать два заказа

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

Принцип простой: у каждой команды записи есть уникальный ключ, и повтор с тем же ключом даёт тот же результат, а не новое действие. Ключ можно собрать из идентификатора обновления или кнопки и идентификатора черновика заказа. Сервис записывает ключ в Postgres в той же транзакции, что и сам заказ, и при повторе возвращает уже созданный результат. Подробнее про устройство ключей и повторы: идемпотентность API и повторные запросы.

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

И последнее: ответ бота должен отличать «заказ создан» от «заказ принят в очередь». Пока 1С не подтвердила запись, честнее писать второе.

Что делать, если 1С недоступна

1С будет недоступна. Обновление конфигурации, блокировка базы, перезапуск сервера, обрыв канала, тяжёлое закрытие месяца. Хороший бот не делает вид, что ничего не случилось, и не теряет заказы. Заранее решите, что видит человек в каждой ситуации.

  • Чтение при недоступной 1С: покажите последнее известное значение из промежуточной базы и время его обновления («остаток на 14:20»). Если данных нет, скажите прямо, что 1С не отвечает, а не показывайте ноль.
  • Запись при недоступной 1С: принимайте заказ в свою базу, ставьте в очередь и сообщайте пользователю, что заказ принят и будет передан в 1С. Повторы делайте с растущей паузой и ограничением числа попыток.
  • Таймауты: ставьте короткий таймаут на запрос к 1С и не держите пользователя в ожидании. Бот может ответить «проверяю» и прислать результат отдельным сообщением.
  • Ручной разбор: заказы, которые не прошли после всех попыток, попадают в отдельный список для сотрудника, а не исчезают. Дайте команду, которая повторяет отправку.
  • Оповещение: если очередь копится, это должно прийти ответственному в Telegram раньше, чем позвонит клиент. Мониторинг подробно разобран в статье про поддержку и мониторинг после запуска.
  • Лимиты Telegram: по официальным вопросам и ответам по ботам стоит избегать больше одного сообщения в секунду в один чат и около 30 сообщений в секунду при рассылке. Массовые уведомления после восстановления 1С отправляйте через очередь с темпом, а не залпом.

Webhook или long polling и где это живёт

Бот получает обновления двумя способами, и выбор не зависит от 1С. Для production обычно берут webhook на вашем сервере: Telegram присылает обновление и ждёт ответ со статусом 2xx, а при другом статусе повторяет запрос и через ограниченное число попыток отказывается. В настройках можно задать секретный токен, и Telegram добавит его в заголовок X-Telegram-Bot-Api-Secret-Token: проверяйте его на входе. Сравнение подходов собрано в статье про webhook и long polling.

Важное следствие: обработчик обновления должен быстро отвечать, а тяжёлая работа с 1С выполняться отдельно, через очередь. Иначе медленный ответ 1С приведёт к повторной доставке обновления, и вы снова упрётесь в дубли.

Где разместить сервис, зависит от того, где стоит 1С. Облачная 1С и сервис на обычном сервере общаются по HTTPS. Если 1С внутри сети компании, ставят агент или сервис в той же сети: он сам обращается к 1С и к вашему серверу, а входящие подключения извне не нужны.

Когда бот для 1С не нужен

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

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

  • Люди и так весь день сидят в 1С за компьютером, а в мессенджере ничего не спрашивают. Выгоды от бота почти нет.
  • Нужны сложные формы с десятками полей и таблицами. В чате это неудобно, лучше веб-форма или мобильное приложение. Для таких случаев смотрите Telegram Mini Apps.
  • Нужно просто выгрузить данные в таблицу или на сайт: достаточно планового обмена без бота.
  • Данные настолько чувствительны, что передача через стороннего мессенджера недопустима по правилам вашей компании.
  • Нет человека, который знает конфигурацию 1С и сможет поправить HTTP-сервис. Без него интеграция остановится на первом же обновлении.
  • Если всё же нужен бот, начните с одного сценария, например «остаток и статус заказа», и оцените его на реальных людях. Подробнее о том, как мы подходим к таким проектам, на странице про разработку Telegram-ботов.
Вопросы

Частые вопросы

Не нашли ответ — спросите на созвоне или в Telegram.

Как сделать телеграм бот для 1С?

Нужны три части: сам бот, сервис-прослойка и точка входа в 1С. 1С публикует HTTP-сервис или OData на веб-сервере, сервис хранит привязку пользователей к ролям и ходит в 1С под отдельным пользователем с минимальными правами. Бот только принимает команды и показывает ответ. Начните с чтения остатков и статусов, запись добавляйте позже.

Как подключить 1С к телеграм боту: HTTP-сервис или OData?

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

Можно ли в боте смотреть остатки и статусы заказов из 1С в реальном времени?

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

Как не допустить дублей заказов при создании через бота?

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

Что будет с ботом, если 1С недоступна?

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

Как разграничить права сотрудников и клиентов в боте для 1С?

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

Связанная услуга

Разработка Telegram-ботов для бизнеса

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

Об услуге
Другие статьи
6 мин чтения

Разработка телеграм бота на заказ: архитектура, интеграции и скрытые затраты

Разработка телеграм бота на заказ: от чего зависит стоимость проекта, выбор между конструктором и кодом, платежи, интеграции, серверы и поддержка.

Читать статью: Разработка телеграм бота на заказ: архитектура, интеграции и скрытые затраты →
6 мин чтения

Оплата в телеграм боте: архитектура, платежные шлюзы и надежная обработка

Оплата в телеграм боте: выбор между Stars и ЮKassa, обработка pre_checkout_query, успешные платежи, идемпотентность и возвраты.

Читать статью: Оплата в телеграм боте: архитектура, платежные шлюзы и надежная обработка →
Контакт

Обсудим вашу задачу?

Тридцать минут созвона — и у вас есть понимание архитектуры, сроков и формата работы. Без обязательств.

Или напишите в Telegram →Читайте наш канал в Telegram →

Укажите Telegram или email, чтобы мы могли ответить.

Отвечаем в течение 15 минут.