Настройка Telegram бота

Для настройки необходимо создать бота в Telegram и подключить его к системе используя полученный токен. При необходимости получения более подробных инструкций обращайтесь в нашу техническую поддержку по адресу cs@ITSM 365.com.

Обновление ключа доступа для существующего бота

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

Если ранее вы не использовали бота, то перейти к пункту "Создание своего Telegram-бота".

Чтобы обновить ключ доступа для существующего бота, выполните следующие действия:

  1. Наберите @BotFather в строке поиска Telegram и откройте контакт соответствующего бота.

    Название официального бота @BotFather содержит доверительный значок.

  2. Выполните команду /mybots в @BotFather.

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

  3. Выберите нужного бота и нажмите кнопку "API token", затем кнопку "Revoke current token".
  4. Скопируйте новый токен доступа и сохраните его, он потребуется для подключения бота к ITSM 365.
  5. Перейдите к пункту "Подключение бота к ITSM 365" этой инструкции

Создание своего Telegram-бота

Как найти BotFather

Выполните следующие действия:

  1. Наберите @BotFather в строке поиска Telegram и откройте контакт соответствующего бота.

    Название официального бота @BotFather содержит доверительный значок.

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

  2. Нажмите /start, если вы еще не использовали бота или перейти к следующему пункту.

Как создать своего бота

Во время первого контакта @BotFather покажет вам справку с перечнем доступных команд.

Выполните следующие действия:

  1. Нажмите на /newbot, чтобы создать нового бота.

  2. Дайте название своему боту.

    Название может состоять из наименования вашей компании и осуществляемой функции.

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

  4. Скопируйте токен доступа и сохраните его, он потребуется для подключения бота к нашему шлюзу.

Настройка описания бота

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

Выполните следующие действия:

  1. Выполните команду /setdescription.

  2. Выберите бота и добавить к нему описание.

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

Подключение бота к ITSM 365

Выполните следующие действия:

  1. В интерфейсе оператора перейдите на карточку "Компании" → вкладка "Настройки".

  2. Перейдите на вкладку "Боты (Telegram)" и нажмите кнопку "Добавить".

  3. На форме добавления заполните параметры в соответствии с информацией, которую сохранили при получении бота:

    • "Токен" — ключ доступа, который сохранили в пункте "Обновление ключа доступа для существующего бота" или "Создание своего Telegram-бота".
    • "Доступен зарегистрированным пользователям" — установите флажок, чтобы нелицензированные пользователи могли получить ссылку на бота в личном кабинете.
    • "Доступен специалистам" — установите флажок, чтобы лицензированные пользователи могли получить ссылку на бота в личном кабинете.

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

      Поля блока "Информация по работе с незарегистрированными пользователями":

      • "Отдел/Компания для создания незарегистрированных пользователей" — незарегистрированные пользователи будут создаваться в выбранном отделе/компании.
      • "Тип пользователей, соответствующий выбранному отделу/компании" — тип пользователей, которые находятся в выбранном для создания отделе/компании: контактное лицо или сотрудник.

  4. Нажмите кнопку "Сохранить" на форме добавления.

    На экране отобразится карточка бота.

  5. На карточке бота нажмите кнопку "Включить webhook".

  6. На форме смены статуса проверьте заполнение параметров и нажмите кнопку "Сохранить".

    • "Логин пользователя для авторизации" — логин пользователя, на которого будет зарегистрирован ключ доступа для внешнего канала/бота.
    • "Токен" — ключ доступа, который указали при добавлении Telegram-бота.

  7. Зарегистрируйте тестовую заявку для проверки работы Telegram-канала.

Как рассказать пользователям о новом канале поддержки

Пользователи могут авторизоваться и узнать о новом канале обращений в личном кабинете.

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