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

В HelpDeskEddy есть возможность подключить бота из мессенджера MAX и обрабатывать обращения клиентов в виде заявок в хелпдеске. Боты в MAX — это специальные аккаунты, созданные для автоматической обработки и отправки сообщений. Пользователи могут взаимодействовать с ботами через личные или групповые чаты. В инструкции описаны шаги по созданию бота в MAX и его подключению к HelpDeskEddy.

1. Откройте документацию MAX и создайте бота согласно инструкции.

2. По окончанию процедуры верификации и создания бота, перейдите в HelpDeskEddy в меню "Настройки каналов связи", нажмите кнопку "Добавить канал", выберите в списке "MAX", а также департамент куда по умолчанию будут поступать заявки от бота:

3. Вставьте ранее скопированный API токен в поле "Ключ бота" и нажмите кнопку "Синхронизировать и сохранить".

4. В случае успешного подключения в канала будет отображено "Соединение успешно установлено!".

Теперь все сообщения отправленные боту от пользователей будут поступать в хелпдеск в виде заявок, а ответы операторов в тикете будут отправляться клиентам от имени бота. Также вы можете добавить бота в групповой чат MAX, и тогда в заявке хелпдеске будут отображаться сообщения от участников группы. Для того, чтобы в систему поступали сообщения из группового чата, бот должен быть назначен администратором группы, и в настройках канала должен быть включена опция "Групповой чат MAX".

Отправка push уведомлений в MAX

Уведомление в личные сообщения.

Вы можете отправлять оповещения в MAX при срабатывании событий в HelpDeskEddy (создание заявки, новый ответ, нарушение SLA и т.д.). Для этого перейдите в меню "Диспетчер" и создайте новое правило. В действиях правила выберите "Отправить вебхук" и заполните заголовок и тело запроса как на примере ниже. Условия правила укажите на своё усмотрение — от этого зависит когда сработает правило и отправиться уведомление в MAX. Для примера будем отправлять уведомление при создании новой заявки в HelpDeskEddy:

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

URL будет выглядеть следующим образом:

https://platform-api.max.ru/messages?disable_link_preview=false&user_id=123456

где user_id — айди пользователя в MAX, которому будет отправлено оповещение. user_id можно подсмотреть в карточке контакта пользователя в HelpDeskEddy, для этого нужно чтобы бот был подключен к системе и пользователь написал ему сообщение. Тогда в хелпдеске создастся заявка и контакт пользователя с канала. Открыв контакт, вы увидите его user_id в MAX:

Тело запроса заполняется в JSON формате. Например:

{
"format": "HTML",
"text": "Новая заявка: {link_staff}"
}

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

ВАЖНО! Отправить оповещение можно только тому пользователю, который хотя бы раз написал боту.

2. Уведомление в групповой чат.

URL будет выглядеть следующим образом:

https://platform-api.max.ru/messages?disable_link_preview=false&chat_id=-1234567890123

где chat_id— айди группового чата в MAX, в который будет отправлено оповещение. chat_id можно узнать, например, при помощи тега {meta_chat_id} в комментариях:

Тело запроса заполняется в JSON формате. Например:

{
"format": "HTML",
"text": "Новая заявка: {link_staff}"
}

Каналы приёма заявок