Работа с тикетами через Telegram

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

Настройка на стороне Telegram

Создайте бота в Telegram. Для этого:

1. Перейдите по ссылке https://t.me/BotFather или найдите в поиске Telegram — @BotFather.
   

1. Запустите бота при помощи команды /start.
2. Создайте своего бота командой /newbot. 
3. Введите название бота. Например, Notify Me.
4. Введите уникальное имя пользователя для бота. Оно должно оканчиваться сочетанием bot. Например, notifyme876bot.
5. Сохраните имя бота и значение токена из ответа.

6. Чтобы бот мог отправлять сообщения в группу Telegram:

   1. Добавьте бота в группу. 
   2. Введите любую команду в чате группы. Например, /start.
7. Чтобы бот мог отправлять сообщения пользователю Telegram, пользователь должен открыть диалог с ботом и нажать Запустить.
   

   Пример создания бота

Настройка на стороне BILLmanager

Со стороны провайдера

Чтобы установить модуль, перейдите в Интеграция → Модули → выберите Telegram → кнопка Установить.

Чтобы настроить модуль, перейдите в Поддержка → Telegram  → кнопка Создать:

1. Выберите Провайдера.
2. Укажите Имя бота в Telegram.
3. Укажите Токен бота.
4. Укажите Telegram API URL. Оставьте поле пустым, если вы не используете сторонние прокси для Telegram.
5. Введите в поле Ссылка для Webhook адрес вида https://URL_BILLmanager/mancgi/telegram_support_webhook . Telegram будет посылать на этот адрес вебхуки о том, что клиент и бот связаны. Вы можете оставить поле пустым. В этом случае будет использоваться адрес сервера с BILLmanager.
6. Выберите опцию Использовать прокси, если нужно отправлять запросы через прокси-сервер. При включённой опции укажите:
   • URL прокси — адрес прокси-сервера. Например, socks5://host:1080, socks5h://host:1080, или  http://host:8080;
   • Имя пользователя — имя пользователя для авторизации на прокси-сервере;
   • Пароль — пароль для авторизации на прокси-сервере.
7. Нажмите Ok.

Добавленные Telegram-боты и их состояние отображаются в таблице.

Вы можете выполнить следующие действия с ботами:

• изменить;
• удалить;
• включить или выключить.

Со стороны клиента

Для работы с Telegram клиент указывает в Настройках пользователя логин своего аккаунта в Telegram (без @). Подробнее см. в статье Уведомления.

В настройках отображаются включённые боты для получения уведомлений и работы с поддержкой.

Работа с тикетами

Для работы с ботом используются команды (аргумент передаётся через _, /command_value, например /ticket_159):

• /start — список тикетов пользователя с возможностью выбрать тикет;
• /ticket_{номер тикета} — информация о тикете, включая последнее сообщение с прикреплёнными файлами. Доступен выбор действий:
  • Добавить ответ. Максимальная длина сообщения 255 символов и не более 5 файлов;
  • Поместить в архив. Кнопка появляется для тикетов в статусе "Ожидает ответа от клиента".
    
• /createticket — создание нового тикета. При создании нового тикета:
  1. Клиент выбирает провайдера, если их несколько и клиент пользуется услугами от разных провайдеров.
  2. Клиент выбирает отдел, куда будет направлен запрос.
  3. Система проверяет не настроена ли на них платная поддержка по предоплаченным обращениям. Если настроена, то проверяет есть ли у клиента предоплаченные обращения. Если нет, то выводит сообщение о невозможности создать обращение.  
  4. Клиент выбирает услугу, по которой возникла проблема.
  5. Клиент пишет тему запроса.
  6. Клиент пишет сообщение о своей проблеме. Клиент может прикрепить до 5 файлов.