Перейти к основному содержимому

Настройка Webhook

  1. Для настройки вебхука необходимо запустить конфигуратор от имени администратора и выполнить публикацию базы на веб сервере, с включенным HTTP-сервисом «Мессенджеры», более подробнее про публикацию базы 1С на веб-сервере IIS по ссылке Публикация базы на 1с сервере Конфигуратор, вебхук
  2. Проверяем подключение к HTTP-сервису по адресу http://имя_хоста/имя_публикации/hs/messengers/ключ_вебхука, где ключ_вебхука — значение поля Ключ на вкладке Настройки Webhook в карточке бота. Если переход выполняется, но требует авторизацию, переходим к пункту 3. Если авторизации не требует и открывается страница «Привет. HTTP-сервис Мессенджеры доступен. Ключ web hook равен "ключ_вебхука"», публикация работает — переходим к пункту 4. Если открывается страница «Привет. HTTP-сервис Мессенджеры НЕ доступен по этому адресу» со списком подсказок, публикация тоже работает, но ключ в адресе не совпал ни с одним ботом: ключ задаётся в карточке бота (пункт 8), до этого можно переходить к пункту 4. В любом ином случае (ошибка 404 или 500, пустая страница) возвращаемся к первому пункту и пытаемся опубликовать правильно.
  3. Если веб-публикация требует авторизации, необходимо «вшить» логин и пароль в файл публикации, для сервера IIS это делается следующем образом:
    a. Находим папку с нашей web-публикацией, по умолчанию она находится в C:\inetpub\wwwroot\имя_публикации, в моем случае webka.
    b. Делаем копию данной папки, и называем ее любым другим именем, например webka_webhook.
    c. В скопированной папке открываем файл «default.vrd» любым текстовым редактором производим изменения файла:
    • Если имеется тэг <ws>, полностью, со всем содержимым удаляем его.
    • В теге <httpServices> удаляем все наполнение, кроме <service name="Мессенджеры" rootUrl="messengers" … />
    • В теге <point> вносим изменения, как на скриншоте, логин и пароль для подключения к ИБ, и параметр enable=”false” запретит подключение в режиме тонкого клиента.
      ISON файл
    • Сохраняем изменения
      d. Открываем “Диспетчер служб IIS” в древе подключений находим нашу публикацию (в моем случае “webka”), щелкаем по ней правой кнопкой мыши и нажимаем «Добавить приложение»
      e. В открывшемся окне заполняем физический путь, до скопированного каталога (в моем случае C:\inetpub\wwwroot\webka_webhook), заполняем псевдоним «webka_webhook», нажимаем «ОК» и в диспетчере IIS перезапускаем сервер.
      f. Проверяем переход по новой публикации, в моем случае http://имя_хоста/webka_webhook/hs/messengers/ключ_вебхука: если не запрашивает авторизацию и открывает страницу «Привет. HTTP-сервис Мессенджеры доступен…» (или «…НЕ доступен по этому адресу», если ключ ещё не задан в боте, см. пункт 2), переходим к пункту 4, иначе еще раз внимательно проходим пункт 3.
  4. Для работы с вебхука, необходимо иметь постоянный адрес к базе через интернет, а именно фиксированное доменное имя или белый IP. Пытаемся подключится к публикации через интернет http://внешний IP или доменное имя/имя публикации/hs/messengers/ключ_вебхука, если открывается страница HTTP-сервиса Мессенджеры (см. пункт 2), переходим к следующему пункту, иначе проверяем настройки маршрутизатора.
  5. Очень важно, чтобы Ваше соединение было защищено SSL сертификатом, иначе телеграм-сервер не захочет взаимодействовать. Если не знаете как получить сертификат бесплатно, воспользуйтесь данной инструкцией Настройка IIS. Если доверенный сертификат получить нельзя, Telegram-боту подойдёт самоподписанный: Самоподписанный сертификат для вебхука.
  6. Пробуем перейти к публикации по HTTPS протоколу https://внешний IP или доменное имя/имя публикации/hs/messengers/ключ_вебхука, обращаем внимание на SSL сертификат: он не должен быть просроченным или вызывать подозрения…

Безопасный режим

  1. Публикация готова! Осталось перенастроить бота, для этого, в 1с открываем справочник Боты, выбираем необходимого бота и изменяем параметр «Способ взаимодействия с ботом» на Вебхук
  2. После изменения способа взаимодействия, появится вкладка Настройки Webhook, нажимаем на нее и выполняем шаги в последовательности указанной на скришоте

Сохранение настроек телеграмм

  1. Ускорение работы для файловых баз

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

:beginning
    curl "http://localhost:88/uit_webhook/hs/messengers/ключ_вебхука"
    cls
    ping -n 1 -w 10000 192.168.254.254> NUL
goto beginning

Замените адрес ...localhost:88/uit_webhook... на свой локальный адрес расположения вебхука, а ключ_вебхука — на ключ из карточки бота. Добавьте *.bat файл в планировщик заданий, чтобы он запускался при запуске компьютера.

Настройка вебхука завершена!

Сделано в Софтонит с любовью