Интеграция с Telegram

В системе HelpDeskEddy есть возможность обработки заявок из канала Telegram.

 

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

 


Что такое боты?

Боты — специальные аккаунты в Telegram, созданные для того, чтобы автоматически обрабатывать и отправлять сообщения. Пользователи могут взаимодействовать с ботами при помощи сообщений, отправляемых через обычные или групповые чаты.

 

Как работают боты?

Как уже было сказано ранее, роботы — особые аккаунты, которые не требуют номера телефона при создании. По сути, эти аккаунты играют роль интерфейса к вашему сервису, который работает на удалённом сервере.

Самое интересное в роботах это то, что для их создания вам не нужно изучать низкоуровневые методы работы с MTProto и шифрованием — общение с роботом организовано при помощи обычного HTTPS интерфейса с упрощёнными методами Telegram API.

 


 

Первый шаг - Создаем робота:

 

Обратитесь к пользователю @BotFather и следуйте его инструкциям:

 

 

  • Напишите команду /newbot , чтобы создать нового робота.
  • BotFather спросит у вас имя нового бота и предложит придумать name и username

Имя (name) будет отображаться в контактах и чатах.

 


Username — короткое имя на латинице, которое используется для упоминаний бота и в ссылках на профиль в telegram.me

Username должен состоять из букв латинского алфавита, подчёркиваний и цифр и быть длиной от 5 до 32 символов. Также имя пользователя обязательно должно заканчиваться на «bot», например: «test_hde_bot»


 

 

  • После чего Вы можете настроить своего бота по желанию: установить картинку, описание и т.д. Полный список возможных команд доступен по команде /help.  

 

Второй шаг - Настройка в системе:

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

 

 

Как только вы создали бота и получили свой ключ (токен) авторизации, Вы можете подключить созданного бота к системе HelpDeskEddy.  Для этого перейдите из Управления в раздел "Департаменты" для редактирования выбранного Департамента или в раздел "Настройка входящей почты" и далее в подраздел "Каналы", после чего введите в необходимое поле созданный ключ.

 

 

Также, для того чтобы бот мог работать как с обычными личными сообщениями, так и с групповыми чатами в настройках своего бота необходимо указать:

  • /setjoingroups — определяет, можно ли добавлять вашего бота в группы.

 

По умолчанию этот параметр включен (ENABLED). При необходимости его можно отключить (Disable).

 

 

  • /setprivacy — переключает режим конфиденциальности в группах (все ли сообщения видит ваш бот в группах). В отключенном состоянии (DISABLED) роботу будут отправляться все сообщения.

 

 

 


Обратите внимание, что сообщения из Telegram доходят в систему в режиме реального времени, без ожидания.


 

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