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

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

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

 

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

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

 

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

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

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

 

Как создать робота?

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

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

 

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

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

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

 

Настройка в системе

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

 

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

 

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

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

  • /setprivacy — определяет, все ли сообщения видит ваш бот в группах. В выключенном состоянии роботу будут отправляться все сообщения. /setprivacy = disabled.

 

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

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

1356