Опыт интеграции мессенджера Telegram c 1C

Предыстория

У одного нашего клиента возникла проблема – там большая компания, руководители отделов постоянно находятся в командировках, ездят на переговоры, и в то же время они ответственны за финансы и отгрузки со склада. Согласования отгрузок и платежей отправлялись им на почту, но они не всегда могли на них оперативно ответить. Соответственно, это тормозило определенные бизнес-процессы в компании и доводило до скандалов.

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

Все отнеслись скептически, но решили попробовать. Посмотрели статьи на Инфостарте, поняли, что это несложно. Тем более, у Telegram открытое API и все достаточно быстро работает. Попробовали, и это оказалось удобным:

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

Создание бота

 

Теперь я расскажу, как это работает и как это устроено внутри.

• Сначала нужно зарегистрировать бота. Для этого находим в Telegram канал BotFather и пишем ему команду «/newbot».
• Теперь нужно придумать ему название – я назову своего бота test_infostart2024_bot.
• После этого необходимо придумать его имя, которое заканчивается на «bot» – имя нашего бота будет infostart2024_bot.
• Сейчас BotFather проверит, есть ли уже такие зарегистрированные боты в системе, и выдаст нам токен.

Имя и название бота нам больше не пригодятся, нужен будет только токен. Его никому нельзя сообщать, потому если кто-то его узнает, он сможет пользоваться вашим ботом и делать с ним все, что угодно. Эту информацию необходимо сохранить.

 

 

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

 

Конфигурация TelegramBot

Теперь я расскажу, как это сделано с точки зрения конфигурирования в 1С. Я сделал конфигурацию, которую потом выложу.

В конфигурации есть:

• Один общий модуль Telegram_Сервер – в нем 500-1000 строк, не больше.
• Три регистра сведений:
  • Telegram_ИсторияСообщений;
  • Telegram_Пользователи;
  • Telegram_Настройки.

 

В регистре сведений Telegram_ИсторияСообщений хранится история входящих и исходящих сообщений.

• Здесь у нас три измерения:
  • ID_сообщения;
  • ВидСообщения – об этом измерении я расскажу чуть подробнее позже;
  • И Пользователь – это измерение нужно, чтобы видеть, кто общается с ботом.
• И есть два ресурса:
  • Команда;
  • И Сообщение.

Ресурс «Команда» имеет тип Справочник.Telegram_КомандыСистемы. В этом справочнике хранятся команды, которые нам пишут пользователи. Для того чтобы бот понимал, на какие вопросы как отвечать, мы здесь создадим список команд – список вопросов, которые можно ему задать, и соответствующий этим командам список ответов.

 

 

В справочнике Telegram_КомандыСистемы есть реквизиты:

• Описание;
• ТипКоманды – это перечисление. Здесь может быть либо отправка файла, либо просто сообщение;
• КодОбработки – этот реквизит нужен для того, чтобы можно было добавлять команды не через конфигуратор, а сразу написать какие-то ответы в режиме «1С:Предприятие», чтобы постоянно не обновлять систему.

Справочник – это удобно, потому что можно делать предопределенные элементы, чтобы потом обращаться к этим командам в коде.

 

 

Еще у нас есть регистр Telegram_Пользователи, где мы храним информацию о соответствии пользователя Telegram и пользователя нашей системы.

• Здесь у нас два измерения:
  • ИмяПользователяТелеграм;
  • ID_Пользователя.
• И один ресурс «Пользователь», где хранится ссылка на элемент справочника «Пользователи».

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

Также есть регистр Telegram_Настройки.

• Здесь у нас два измерения:
  • ИмяБота;
  • API.
• И один ресурс token – это токен, по которому у нас будут идти сообщения.

 

В регистре сведений Telegram_Настройки мы записываем:

• Имя бота – сюда можно написать любое имя;
• Api – это всегда api.telegram.org;
• И Token – тот токен, который был назначен нам при регистрации.

Теперь попробуем запустить конфигурацию и проверить ее в действии. К сожалению, в файловой версии у меня не получилось сделать регламентное задание, которое бы запускалось раз в три секунды, поэтому я сделал обновление отображения через обработку ожидания. Напомню, что для корректной работы чата мы должны постоянно обращаться по API, чтобы обновлять данные.

 

 

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

 

 

Посмотрим, что происходит при этом в коде. Как только срабатывает обработка ожидания, запускается процедура ПрочитатьСообщенияПользователя().

Сначала устанавливается HTTPСоединение. Строчки подключения стандартные для всех API:

• В переменную Источник мы прописываем токен бота и команду, которую нужно передать в Telegram. Для получения сообщений за последние 24 часа используется команда /getUpdates;
• HTTPСоединение открывается через 443-й порт;
• В заголовке HTTPЗапроса прописываем, что будет передаваться структура JSON.

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

 

 

Сначала мы попадаем в процедуру ДесериализоватьJSON – это стандартная процедура преобразования нашей строки JSON в структуру данных.

 

 

Структура входящего сообщения изнутри выглядит следующим образом.

• Первое поле ok – это значение, куда записывается результат вызова – правильно или неправильно прошло сообщение.
• И второе поле result – это массив сообщений за 24 часа, который вернул нам бот. В этом массиве можно увидеть, что четыре человека нам уже что-то написали. Каждый элемент массива – это структура, состоящая из полей:
  • update_id – это уникальный код сообщения, который нам прислали;
  • message – это непосредственно само сообщение.

 

Открываю любое сообщение из массива.

 

 

Здесь тоже вложенная структура – можно увидеть, от кого пришло сообщение (поле from), можно посмотреть текст сообщения (поле text), можно посмотреть сам чат (поле chat).

 

 

При просмотре структуры from видно, от кого пришло сообщение (first_name) и видно ID пользователя.

 

 

То же самое мы видим при просмотре структуры chat.

В этой структуре не так много параметров, главное – это запомнить ID самого сообщения и ID того пользователя, с которым мы общаемся. Мы должны обращаться к этому пользователю по его ID, чтобы сообщение пришло именно ему, а не какому-то другому пользователю в сети. Пользователей очень много.

 

 

Итак, бот вернул массив сообщений (у нас их четыре). Теперь я поочередно разбираю этот результат:

• Сначала в переменную СообщениеID я сохраняю ID конкретного сообщения для того, чтобы с ним дальше работать.
• Далее у нас идет проверка ПроверитьНаличиеСообщенияПоID. Дело в том, что после каждого запроса к серверу Telegram в результат попадают все сообщения за 24 часа. И мы должны где-то хранить информацию о том, какие сообщения мы уже обработали, а какие нет. Для этого у нас есть регистр сведений Telegram_ИсторияСообщений, где мы храним всю историю. Здесь я проверяю, было ли уже обработано это сообщение от бота или нет.
• Далее у нас производится вызов функции ВернутьКомандуTelegram, где мы принимаем команду (сообщение, которое нам прислали) и проверяем, есть ли у нас эта команда в справочнике Telegram_КомандыСистемы. Если описание не вернулось, мы должны ответить, что не знаем такой команды.
• Далее в процедуре ЗаписатьИсториюСообщений мы записываем в регистр сведений Telegram_ИсторияСообщений информацию о том, что это сообщение было обработано, после этого оно становится старым.
• И, наконец, в процедуре ОбработатьОтветПользователя вызываем процедуру обработки ответа.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Теперь по командам. У нас есть справочник с историей сообщений. Здесь хранится информация обо всех сообщениях – и входящих, и исходящих.

 

 

На данный момент всем всегда приходит один ответ: «Извините, я такого не знаю», потому что никаких команд мы в справочник «Команды системы» еще не вводили.

 

 

Заведем новую команду в справочник «Команды системы».

• В качестве типа команды выбираем «Сообщение».
• В поле «Наименование» напишем то, что могут написать боту пользователи, например, «Привет».
• Поле «Описание» заполняем для справки.
• И в поле «Код обработки» заносим простые команды, которые будут выполнены из кода через оператор «Выполнить()». В данном случае, я напишу:
  ОтветСистемы = "Привет, дружище. Как дела?".

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Посмотрим, как реализована обработка ответа пользователя.

• Если в качестве команды попадает известная команда – мы ее обрабатываем.
• А если мы команду не знаем, то отвечаем «Извините, я такого не знаю».
• И дальше мы отдаем ответ пользователю.
  • Если тип команды – Файл, то производится отправка файла пользователю.
  • А если тип команды – Сообщение, то мы берем стандартную структуру HTTPСоединение и для этого соединения создаем HTTPЗапрос, куда передаем команду /sendMessage с параметром chat_id, в который записываем значение переменной СтруктураСообщения.chat.id. В результате сообщение благополучно отправляется именно тому пользователю, который нам написал.

 

 

Сейчас проверю, будет ли теперь работать команда «Привет».

 

 

Вот, пожалуйста, работает. Вы можете любого человека посадить, он вам такие простые команды напрограммирует.

 

 

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

 

 

Теперь мне приходит сообщение с кнопками «Согласовать» и «Не согласовать».

 

 

Код такой:

• Мы добавляем простейшие кнопки в массив, вставляем их в структуру и записываем в JSON.
• Дальше отправляем стандартное сообщение – оно всегда отправляется одинаково, независимо от того, с кнопками вы его отправляете, или без. Просто в конце добавляете reply_markup или ваши кнопки, которые вы перечисляете – их может быть две или три, сколько вам удобно.
• И, соответственно, когда пользователь отвечает, вы этот ответ обрабатываете.

Кода здесь вообще практически нет. Все эти сообщения выводятся стандартными командами – только то, что вы внутри накрутите.

 

 

Добавляю в справочник «Команды системы» еще одну команду – help. В ней мы просто запросом пробегаемся по справочнику наших команд и выводим название команды и ее описание.

 

 

Теперь, когда я пишу боту команду help, я получаю ответ – все команды и их описание.

 

 

Еще одна команда –
eport. Она присылает нам отчет со всеми сообщениями пользователей, их ID и т д. Соответственно, если вы куда-то это встроите, то сможете отправлять любой отчет, например, оборотно-сальдовую ведомость, отчет о дебиторской задолженности и т.д. В этой команде мы:

• Создаем новый табличный документ;
• Обращаемся к отчету в системе, вызываем его экспортную процедуру СкомпоноватьРезультатТабДок, которая компонует результат в табличный документ;
• Создаем временный файл с расширением xlsx;
• Записываем табличный документ в этот временный файл.

 

 

Теперь по команде
eport мне приходит отчет по истории сообщений.

В конфигураторе это все обрабатывается следующим образом.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Этот код я взял из одной хорошей статьи с Инфостарта.

Здесь мы прописываем заголовки, текст отправки, имя файла.

 

 

И в конце вызываем команду sendDocument.

У Telegram открытый API, можно с ним разобраться. Конечно, когда постоянно работаешь в 1С – это сложно, но можно день-два посидеть, потестировать, и становится все понятно.

Система более-менее рабочая. Я постарался сделать поменьше объектов метаданных: два справочника, три регистра. Справочник «Пользователи» я не стал вытаскивать из «Библиотеки стандартных подсистем», потому что вместе с ним там идет огромное количество связанных объектов. Но если вы его объедините, он нормально объединится.

 

Вопросы

Как так получилось, что вы начали пользоваться Telegram?

Первоначально у нас был достаточно крупный клиент, у которого была проблема – чтобы провести отгрузку со склада, нужно было согласовать ее состав с руководителем. Плюс они еще согласовывали платежный календарь – какие платежи сегодня платить. А руководители отдела, которые за это отвечают, постоянно находились в разъездах или на совещаниях. Из-за этого постоянно происходили задержки – по отгрузке, по оплатам. Соответственно, это тормозило определенные бизнес-процессы в компании. И мы предложили им с чем-нибудь интегрироваться, сделали им через Telegram согласование распоряжений на отгрузку и платежей. Попробовали, запустили, всем понравилось, все начали активно пользоваться. Как обычно люди на совещаниях сидят? Они слушают, что говорят, и попутно решают свои дела. Пришло сообщение – он быстро нажал на «Согласовать» или «Не согласовать». Тем самым, повысилась оперативность работы. А потом уже директор начал с этим «играться» – отправлял определенные команды и ему приходил, например, размер дебеторской задолженности.

 

Целевая аудитория – какое количество человек?

100 человек.

 

А аутентификацию как организовали? Зная наименование бота, к нему можно подключиться. Как вы это отсекали?

У бота в настройках можно настроить приватность. Соответственно, настроить вход по паролю и т.д. И на стороне 1С можно реализовать отключение обработки сообщений для неизвестных системе пользователей. Здесь есть регистр Telegram Пользователи. И те, кто боту писал, сюда автоматически попали. Вот он, ID у каждого пользователя. Связка с пользователем системы проставляется вручную. Мы сделали это соответствие через регистр, чтобы не мучиться, но можно привязаться к контактной информации. Например, вы можете в контактную информацию добавить поле ID_Telegram и прописать туда ID пользователя. Этот ID можно узнать по входящему сообщению.

 

Мы в своем боте для студентов делали немного хитрее. Мы в момент авторизации принудили пользователя расшарить свои контактные данные и сверялись уже по номеру телефона, который есть в нашей базе данных. В Telegram можно расшарить контакт, мы его парсим, смотрим на номер телефона, ищем человека по номеру в базе. Если мы его нашли, то это – наш студент, и дальше он может уже работать с ботом.

Поле для творчества очень большое. API тоже очень большое, можно много чего «накопать». В зависимости от задачи и того, что вам требуется. Мы сделали так – нас устраивало.

 

А как реализовать многоуровневое меню? Когда мы выбираем какую-то команду, бот на нее задает уточняющий вопрос и т.д. Такое возможно? Вопрос в том – как при выборе окончательной команды понять, что изначально была выбрана команда такая-то?

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

 

А можно ли добавлять дополнительные ключи – например, чтобы получить отчет по какому-то конкретному контрагенту? Как будет выглядеть команда – report и наименование контрагента?

Команду необязательно писать через слэш – вы ее можете определить, как вам удобно. Например, вы задаете команду ДебиторскаяЗадолженность, потом пробел и ставите какой-то определенный спецсимвол (например, @), после которого пишете название контрагента. Когда у вас эта команда попадает в 1С, там вы уже парсите, что к чему относится и, соответственно, передаете уже эти параметры в отчет.

 

А как вы решали проблему с возможным флудом сообщений от пользователя? Насколько я понял, у вас все пользователи бота – это ваши сотрудники. А были ли какие-то возможности у бота, которые могли использовать сторонние неподконтрольные люди – контрагенты, например или еще кто-то. У нас сейчас основные пользователи нашего бота – это студенты. Они нам неподконтрольные. Мы не можем дисциплинарно наказать человека за то, что он нам пришлет 5000 сообщений.

По chat.id можно отключить обработку сообщений целиком.

 

А вообще Telegram не банит, когда слишком часто к нему обращаешься?

Нас ни разу не банили.

 

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

Единственное ограничение, которое есть – это отправка исходящих сообщений. Там, по-моему, допускаются пики до 30 сообщений в секунду. Это – основное узкое место.

 

Еще вопрос по кнопкам – в callback_data есть жесткое ограничение в 64 символа. В этой конфигурации реакция на кнопки реализована через ответ на данные в callback_data или в базе данных записывается еще что-то, что используется при обработке callback?

В этой конфигурации ответ не обрабатывается, но вообще здесь все стандартно – возвращается ответ, вы его точно так же разбираете и пишете в историю сообщений. А потом уже вы можете что-то дальше с историей сообщений делать – обрабатывать ее, как вам удобно.

 

А почему вы выбрали Telegram? С WhatsApp вы интеграцию не рассматривали?

С WhatsApp мы не работали. Там нет открытого API. Насколько я знаю, WhatsApp собираются сделать корпоративную версию и там уже давать API за деньги. В Viber есть открытое API, но в Viber, насколько я знаю, нет кнопок. К тому же Viber еще и не все файлы поддерживает. По крайней мере, раньше так было – какие-то файлы отправляешь, он пишет – я этот формат не знаю. А в Telegram открытое API, можно использовать кнопки и можно свободно обмениваться теми же самыми Excel-евскими документами.

 

А можно ли реализовать обращения к API не через обработчик ожидания?

Мы это делали регламентным заданием.

 

Это понятно, но стучаться постоянно все равно неохота.

Можно заставить отправлять Telegram push-уведомления – высунуть наружу HTTP-сервис, который будет получать сообщения. У Telegram есть такая возможность – там можно создать подписку и указать типы сообщений, которые будут приходить по этой точке. Но здесь есть ограничение – нужно «высунуть наружу» HTTP-сервис. Это вообще отличная идея, когда из 1С ничего в Telegram не стучится, а все сообщения разбирает сам IIS (или Apache). Потому что у нас была такая проблема – создавалась дополнительная нагрузка на 1С, потому что она должна была одновременно обрабатывать эти сообщения. Тут нужно поступать в зависимости от того, для чего вам нужен этот бот. Если вы хотите, чтобы у вас постоянно было 1000 пользователей, и они массово писали, я думаю, что через 1С это будет сделать сложно. Можно, но сложно. Думаю, что тогда нужно будет запускать отдельную базу 1С, чтобы она работала только с Telegram. А если вы хотите запустить просто информирование внутри компании, то таких возможностей вам хватит, достаточно поставить время для запросов – одну-две минуты.

 

****************

Данная статья написана по итогам доклада, прочитанного на конференции INFOSTART EVENT 2024 COMMUNITY. Больше статей можно прочитать здесь.

В 2024 году приглашаем всех принять участие в 7 региональных митапах, а также юбилейной INFOSTART EVENT 2024 в Москве.

Выбрать мероприятие.