В HelpDeskEddy есть возможность подключить бота из мессенджера MAX и обработки обращения клиентов в виде заявок в хелпдеске. Боты в MAX — это специальные аккаунты, созданные для автоматической обработки и отправки сообщений. Пользователи могут взаимодействовать с ботами через личные или групповые чаты. В инструкции описаны шаги по созданию бота в MAX и его подключению к HelpDeskEddy.
1. Откройте приложение и напишите пользователю @MasterBot.
2. Для создания нового бота напишите /create и далее следуйте инструкциям/. После создания бота @MasterBot сообщит Вам API токен, скопируйте его:
3. В HelpDeskEddy перейдите в меню "Настройки каналов связи", нажмите кнопку "Добавить канал", выберите в списке "MAX", а также департамент куда по умолчанию будут поступать заявки от бота:
4. Вставьте ранее скопированный API токен в поле "Ключ бота" и нажмите кнопку "Синхронизировать и сохранить":
5. В случае успешного подключения в канала будет отображено "Соединение успешно установлено!".
Теперь все сообщения отправленные боту от пользователей будут поступать в хелпдеск в виде заявок, а ответы операторов в тикете будут отправляться клиентам от имени бота. Также вы можете добавить бота в групповой чат MAX, и тогда в заявке хелпдеске будут отображаться сообщения от участников группы.
Отправка push уведомлений в MAX
Вы можете отправлять оповещения в MAX при срабатывании событий в HelpDeskEddy (создание заявки, новый ответ, нарушение SLA и т.д.). Для этого перейдите в меню "Диспетчер" и создайте новое правило. В действиях правила выберите "Отправить вебхук" и заполните заголовок и тело запроса как на примере ниже. Условия правила укажите на своё усмотрение — от этого зависит когда сработает правило и отправиться уведомление в MAX. Для примера будем отправлять уведомление при создании новой заявки в HelpDeskEddy:
В поле URL необходимо указать токен бота MAX, через который будет осуществляться отправка, а также user_id пользователя (получателя уведомления).
Токен можно узнать обратившись к @masterbot в MAX, выбрав ранее созданного бота:
user_id можно подсмотреть в карточке контакта пользователя в HelpDeskEddy, для этого нужно чтобы бот был подключен к системе и пользователь написал ему сообщение. Тогда в хелпдеске создастся заявка и контакт пользователя с канала. Открыв контакт, вы увидите его user_id в MAX:
URL будет выглядеть следующим образом:
- https://botapi.max.ru/uploads?access_token=%access_token&user_id=123456
где %access_token — токен телеграм бота, а user_id — айди пользователя в MAX.
Например: https://botapi.max.ru/messages?access_token=f9ABCDEFGHIJKLMN&user_id=123456
Тело запроса заполняется в JSON формате. Например:
{
"text": "Поступила новая заявка! Ссылка: {link_staff}"
}
Содержимое шаблона можно выбирать на ваше усмотрение, также не забывайте использовать доступные теги Диспетчера для отправки данных из заявки: статус, имя клиента, приоритет, ссылка на тикет т.д.