# Конструктор ботов Телеграм, инструкция по установке на конфигурацию

## Конфигурация 1С должна удовлетворять следующим требованиям:

- Платформа 8.3.7.1759 и выше
- Режим совместимости не используется или не ниже 8.3.7
- Управляемые формы
- Включённая возможность внесения изменений в конфигурацию. Достаточно установить правило поддержки "Объект поставщика редактируется с сохранением поддержки" для корневого элемента конфигурации

## Процесс установки

### Действия в конфигураторе

1. Запустите конфигуратор
2. Сделайте архивную копию Вашей информационной базы — абсолютно необходимое требование перед действиями любого характера с конфигурацией, пункт меню "Администрирование — Выгрузить информационную базу..."
3. Пункт пункт меню "Конфигурация — Сравнить, объединить с конфигурацией из файла..."
4. Выберите поставляемый файл с расширением CF
5. Если появится вопрос "Обнаружена возможность объединения с постановкой на поддержку...... поставить на поддержку?", нажмите НЕТ
6. В открывшемся окне "Сравнение, объединение Основная конфигурация - Файл .....cf" выключите ВСЕ пункты, для этого достаточно выключить корневой элемент
7. Далее, нажмите кнопку "Действия" и выберите пункт меню "Отметить по подсистемам файла"
8. В открывшемся окне "Отбор по подсистемам" необходимо оставить только флажок "Телеграм", далее нажать "Установить"
9. Таким образом, если Вы всё сделали правильно, для переноса в конфигурацию будут отмечены все объекты, кроме:
   1. Свойства конфигурации Перенос должен быть обязательно исключён
   2. Общие — Роли — ТелеграмАдминистратор Роль содержит административные права и не должна переноситься
   3. Общие — Роли — ТелеграмПользователь Роль содержит корневые права на доступ к клиентам и прочее и не должна переноситься
10. Снимите флажок "Сохранять настройки автоматически"
11. Нажмите "Выполнить", дождитесь объединения и появления предупреждения "Объединение конфигураций завершено"
12. Выберите пункт меню "Конфигурация — Обновить конфигурацию базы данных", дождитесь обновления конфигурации БД
13. Присвойте избранным пользователям права "Телеграм: редактирование" и "Телеграм: просмотр"

### Действия в конфигурации

А теперь надо обязательно обновить! Если не обновить, никакого чуда не произойдёт!

1. Выберите пункт "Обновление версии" подсистемы "Телеграм"
2. Нажмите "Обновить", дождитесь установки текущей версии в 1.02
3. Заполните параметры бота — жетон (он же токен), способ получения обновлений (для начала — периодический запрос)

### Как запустить бота?

#### Первый вариант — через обработчик ожидания формы, самый простой, но не самый удобный при боевом применении

- Откройте форму списка справочника "Боты"
- Нажмите "Панель получения обновлений"
- Укажите периодичность, секунд (например, 3)
- Нажмите "Вкл"
- В поле "Последнее получение" начнёт обновляться значение. Пока форма списка открыта, все Ваши боты со способом получения обновлений "Периодический запрос" работают

#### Второй вариант — через регламентное задание

Способ корректно работает в клиент-серверном варианте работы, так как регламентные задания в файловом режиме могут иметь неявные ограничения на периодичность вызова (например, не чаще раза в минуту). Для запуска получения через регламентное задание заполните значения на закладке "Настройки получения обновлений" бота

#### Третий вариант — вебхуки

Для использования вебхуков необходимо:

- Уметь публиковать 1С на веб-сервере и настраивать HTTP сервисы
- Иметь зарегистрированное в DNS доменное имя (не просто 111.222.333.444, а www.site.ru)
- Иметь привязанный к домену SSL-сертификат

Если у Вас возникли сложности при настройке получения обновлений через вебхук — пишите в группу ВКонтакте или на форум Инфостарта, и обязательно получите помощь

## Подсистема готова к использованию, спасибо за скачивание NFR-версии или приобретение полной версии

| Понравилось решение? Оставьте свой отзыв здесь: https://goo.gl/forms/8rMqEwN5BEcrl5Y72, Ваши отзывы помогают сделать его лучше! Расскажите о бизнес-кейсах, которые удалось решить с его помощью!