Перейти к содержанию

Telegram-бот Дистансис

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

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

Возможности Telegram-бота

Через Telegram-бота можно:

  • найти и выбрать управляемый компьютер;
  • посмотреть текущий выбранный компьютер;
  • выбрать базу 1С, если команда должна выполняться в 1С;
  • запускать быстрые команды;
  • запускать команды, настроенные в личном кабинете;
  • указывать параметры команды через Web App-форму;
  • создавать задачи на управляемом компьютере;
  • получать результат выполнения задачи в Telegram.

1. Привязка Telegram к личному кабинету

Для работы с Telegram-ботом нужно указать свой Chat ID в личном кабинете Дистансис.

Откройте личный кабинет:

https://lk.distansys.ru/

На главной странице выберите раздел Данные Telegram.

В поле Chat id укажите свой Telegram Chat ID и сохраните данные.

Для привязки Telegram достаточно указать только Chat ID. После этого бот сможет отправлять вам сообщения и результаты выполнения задач.

2. Как узнать свой Chat ID

Чтобы узнать свой Chat ID в Telegram:

  1. Откройте Telegram.
  2. Найдите бота @userinfobot.
  3. Отправьте ему команду /start.
  4. Бот ответит сообщением, в котором будет указан ваш Chat ID.
  5. Скопируйте Chat ID.
  6. Вставьте его в личном кабинете Дистансис в разделе Данные Telegram.

3. Запуск Telegram-бота

После сохранения Chat ID откройте Telegram-бота Дистансис и отправьте команду:

/help

Бот отправит краткую справку и покажет доступные команды.

В справке отображаются основные команды для работы с ботом:

  • /find_comp — найти компьютер;
  • /select_comp — выбрать компьютер;
  • /current_comp — показать текущий компьютер;
  • /basic_commands — открыть быстрые команды;
  • /select_task — выбрать задачу;
  • /select_base_1c — выбрать базу 1С;
  • /help — показать справку.

4. Выбор компьютера

Перед запуском команды нужно выбрать компьютер, на котором будет выполняться задача.

Для поиска компьютера используйте команду:

/find_comp

Также можно выбрать компьютер из списка командой:

/select_comp

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

Чтобы проверить, какой компьютер выбран сейчас, используйте команду:

/current_comp

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

5. Быстрые команды

Для открытия быстрых команд используйте:

/basic_commands

Бот покажет список доступных быстрых команд.

Примеры быстрых команд:

  • Закрытие месяца;
  • Запустить приложение;
  • Исправить БД;
  • Очистить кеш 1С;
  • Очистить очередь печати;
  • Провести документ;
  • Список организаций.

Список быстрых команд зависит от настроек в личном кабинете Дистансис.

6. Выбор задачи

/select_task

Через эту команду можно выбрать любую команду, которая настроена в личном кабинете Дистансис.

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

Например:

  • запуск приложения;
  • выполнение скрипта;
  • очистка кеша 1С;
  • очистка очереди печати;
  • перезапуск службы;
  • выполнение команды 1С;
  • запуск внешней обработки 1С;
  • выполнение регламентной операции.

7. Выбор базы 1С

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

Для выбора базы используйте команду:

/select_base_1c

После выбора базы 1С бот будет использовать ее при запуске команд, связанных с 1С.

Если команда не связана с 1С, выбирать базу не нужно.

8. Ввод параметров команды

Некоторые команды требуют дополнительных параметров.

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

  • имя модуля 1С;
  • имя службы Windows;
  • дополнительные параметры выполнения.

Бот может предложить два способа ввода параметров:

  1. Через Web App-форму.
  2. Текстом в сообщении.

Рекомендуемый способ — Web App-форма. Так проще заполнить параметры и меньше риск ошибиться.

9. Запуск команды через Web App

Если команда поддерживает Web App, бот покажет кнопку Открыть форму.

Нажмите кнопку, заполните параметры и нажмите Запустить.

После нажатия кнопки Запустить Дистансис создаст задачу для выбранного компьютера.

10. Что происходит после запуска задачи

После запуска команды выполняется следующий сценарий:

  1. В Дистансис создается задача.
  2. Задача отображается в личном кабинете.
  3. Управляемый компьютер получает задачу.
  4. Клиент Дистансис выполняет команду на компьютере.
  5. Результат выполнения отправляется обратно в Telegram.

После выполнения задачи, в чат приходит результат выполнения.

Если во время выполнения возникла ошибка, сообщение с ошибкой также приходит в Telegram.

11. Где посмотреть созданную задачу

Все задачи, созданные через Telegram-бота, отображаются в личном кабинете Дистансис.

В личном кабинете можно проверить:

  • дату создания задачи;
  • компьютер, на котором должна выполниться задача;
  • название команды;
  • параметры команды;
  • статус выполнения;
  • результат выполнения.

Это удобно, если нужно проконтролировать выполнение задачи не только из Telegram, но и через веб-интерфейс.

12. Общий порядок работы

Обычно работа с Telegram-ботом выглядит так:

  1. Указать Chat ID в личном кабинете.
  2. Открыть Telegram-бота Дистансис.
  3. Выполнить команду /help.
  4. Найти или выбрать компьютер через /find_comp или /select_comp.
  5. При необходимости выбрать базу 1С через /select_base_1c.
  6. Выбрать задачу через /select_task или открыть быстрые команды через /basic_commands.
  7. Указать параметры команды.
  8. Запустить задачу.
  9. Получить результат выполнения в Telegram.

13. Пример сценария

Пример запуска задачи через Telegram:

  1. Пользователь открывает Telegram-бота.
  2. Выполняет команду /find_comp.
  3. Находит нужный компьютер.
  4. Выбирает компьютер.
  5. При необходимости выбирает базу 1С командой /select_base_1c.
  6. Открывает быстрые команды через /basic_commands.
  7. Выбирает команду, например Закрытие месяца.
  8. Заполняет параметры в Web App-форме.
  9. Нажимает Запустить.
  10. Дистансис создает задачу.
  11. Управляемый компьютер выполняет задачу.
  12. Результат выполнения приходит в Telegram.

14. Важные рекомендации

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

Если команда связана с 1С, дополнительно проверьте выбранную базу 1С.

Если команда требует параметров, лучше использовать Web App-форму, а не ручной ввод текстом.

Если задача не выполняется, проверьте:

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

15. Кратко

Telegram-бот Дистансис позволяет запускать задачи на удаленных компьютерах без входа в личный кабинет.