Создать телеграм бота 1с

Обновлено: 07.07.2024

Пробовали ли вы общаться с клиентами, сотрудниками, партнерами и другими внешними пользователями с помощью telegram-бота ?

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

Интеграция возможна только начиная с версии платформы 8.3.10.2168

Чтобы произвести интеграцию, надо выполнить три простых шага:

Подключение системы взаимодействия
Создание Telegram-бота для входящих обращений
Добавление интеграции на уровне системы взаимодействия.

1С-Рарус подробно расскажет вам о каждом шаге прямо сейчас!

1 шаг. Подключение системы взаимодействия

Переходим в главное меню–> « Функции для технического специалиста » –> « Стандартные » –> « Управление системой взаимодействия ».
Чтобы пройти регистрацию, введите адрес электронной почты , на которую придет код подтверждения.
Введите полученный код и нажмите « Зарегистрировать ».

Чтобы после регистрации создать диалог внутри программы, необходимо:

1. Перейти на закладку « Обсуждения »;

2. Нажимаем на значок « Новое обсуждение »;

3. Указываем тему и пользователей ;

4. Нажимаем « ОК ».

Заходим в главное меню, затем "Функции для технического специалиста". Нажимаем "Стандартные", затем "Управление системой взаимодействия". Вводим адрес электронной почты, получаем код и вводим его в соответствующее поле. Заходим в главное меню, затем "Функции для технического специалиста".

Готово! Вы настроили внутренний чат.

Для того, чтобы выполнить интеграцию с Telegram, нужно выполнить еще два шага. Разбираем!

2 шаг. Создание телеграмм-бота для входящих обращений

1. Переходим в Telegram

2. В поле поиска вводим @BotFather. Это аккаунт для создания персональных ботов.

3. Переходим в диалог с ботом.

4. Нажимаем команду « Запустить » –> « New bot ».

5. После этого введите имя бота . Так он будет отображаться для пользователей.

6. Указываем никнейм бота .

В конце никнейма обязательно надо указать слово bot

8. Готово! Бот создан.

3 шаг. Добавить интеграцию на уровне системы взаимодействия

Остался всего один простой шаг, который соединит два предыдущих действия.

1. Заходим в программу под администратором .

2. Переходим в главное меню –> « Функции для технического специалиста » –> « Стандартные » –> « Управление системой взаимодействия » –> пункт « Интеграции ».

3. Нажимаем « Добавить ».

Много строк исписано про интеграцию Телеграма и 1С. Но нигде не увидел полной инструкции по установке и настройке вебхуков. Попробую её написать.

Для всего этого нам понадобится (или правильнее будет сказать, что было использовано мной):

Apache 2.2.24
OpenSSL (входящий в установку апача)
1C (с модулями веб-сервера)
Свой домен
Созданный бот в Телеграм (не буду описывать его создание, т.к. оно достаточно тривиально)

YOURPRIVATE.key — закрытый ключ сертификата. Будет использован в апаче

YOURPUBLIC.pem — открытый ключ сертификата. Будет использован при регистрации вебхука

YOURDOMAIN.EXAMPLE — адрес вашего домена с вебхуком. Должен таки совпадать с адресом вебхука.

После выполнения этого кода в папке openssl ( у меня это «C:\Program Files\Apache Software Foundation\Apache2.2\bin») появятся файлы ключей.

Я их скопировал в папку conf апача.

Переходим к настройке Apache.

Я видел много разных способов. У меня сработал следующий:

для того, чтобы апач «слушал» 443 порт.

Блок <IfModule ssl_module> приведен к следующему виду:

В самом конце добавлены строчки, где указываю пути к сертификату:

И раскомменитурйте строчку:

В моём случае указаны следующие параметры:

Имя: ТГВебхук
КорневойURL: webhook
Повторное использование сеансов: Не использовать (с автоматическим режимом у меня не заработало)
Время жизни: 20
Шаблоны URL: создан шаблон «Любой» с двумя методами: GET и POST

Обработчики методов создаются по умолчанию. В обработчик POST добавлю следующее, просто для проверки связи:

ВашДомен/ИмяБазы/hs/ИмяСервиса/v1

Прошу не пинать ногами за код, некоторые вещи умышленно сделаны хардкодом, т.к. это всё делалось исключительно в демонстрационных целях.

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

Заходим в telegram на телефоне и добавляем.

. бота с именем BotFather

При необходимости перезапускаем бота.

. а затем пишем ему команду /newbot для создания бота:

Далее придумываем имя (любое) для нашего бота:

Затем придумываем адрес для нашего бота. Этот адрес должен быть:

на английском
уникальным
заканчиваться на bot

Я, например, укажу в данном случае (но вы придумайте своё) milkin_updater_bot:

После этого BotFather создаст для нас бота и напишет нам секретный код (токен) нашего бота, который мы должны держать в секрете:

Этот токен нужно скопировать на компьютер (для этого откройте веб-версию telegram в браузере на вашем компьютере), мы его в дальнейшем укажем в настройках обновлятора.

Итак, наш бот создан со следующими параметрами (у вас эти параметры будут своими):

адрес: milkin_updater_bot
секретный код (токен): 1746089470:AAHRM70FVDpvIJkpVK4oHVpBeN3nz6qNs20

Создаём группу

В эту группу бот будет присылать нам отчёты из обновлятора.

В нижнем правом углу telegram нажимаем вот такой значок:

Выбираем пункт "New Group":

В качестве члена этой группы указываем нашего бота, напечатав его точный адрес в строке поиска:

Имя группы вводим любое:

Группа создана, осталось узнать её внутренний адрес, так как именно его мы будем указывать в обновляторе.

Для этого временно приглашаем в группу.

. бота по имени getidsbot

Этот бот сразу после добавления в группу выводит необходимую нам информацию о группе:

После этого бота из членов группы удаляем.

Итак, адрес нашей группы: -580943329

Обращаю ваше внимание, что если в дальнейшем вы измените состав администраторов группы - адрес (идентификатор) группы также изменится!

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

Если вы захотите настроить иконку группы или бота как у обновлятора, то вот она:

Сохраните её к себе на телефон в галерею (открыв сайт на телефоне или через веб-версию мессенджера) и далее укажите в настройках группы или бота.

Настраиваем обновлятор

Нам понадобится следующая информация (у вас она будет своя), полученная выше:

секретный код (токен) бота: 1746089470:AAHRM70FVDpvIJkpVK4oHVpBeN3nz6qNs20
адрес группы: -580943329

Открываем настройки уведомлений:

Нажимаем кнопку добавить:

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

Бот выбран, в поле "Кому отправлять" указываем адрес нашей группы (см. выше):

Ответы на вопросы

Как сделать, чтобы полные отчёты по операциям приходили в незапакованном виде?

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

Это легко настраивается. В диалоге уведомлений нажмите ссылку "уточнить. " справа от пункта "операции":

В открывшемся окне настройте вид отчёта для всех или для конкретных адресов, например, так:

Можно ли получать уведомления одновременно и на почту и в telegram?

Да, конечно. Для этого настройте оба средства отправки.

. а в поле "Кому отправлять. " укажите необходимые почтовые адреса и адреса групп telegram через точку с запятой:

Нам нужно создать несколько групп для уведомления - нужно ли создавать под каждую группу своего бота?

Нет, достаточно будет одного бота. Главное, добавить его во все необходимые группы.

Как удалить созданного бота?

Зайдите в чат с BotFather (через него мы создавали бота) и напишите в чате команду /deletebot

BotFather сам предложит вам выбрать бота из тех, что вы создавали и попросит подтвердить удаление.

С уважением, Владимир Милькин (преподаватель школы 1С программистов и разработчик обновлятора).

Как помочь сайту: расскажите (кнопки поделиться ниже) о нём своим друзьям и коллегам. Сделайте это один раз и вы внесете существенный вклад в развитие сайта. На сайте нет рекламы, но чем больше людей им пользуются, тем больше сил у меня для его поддержки.

Читайте также: