Шаг 1: настройки на стороне Mах

Войдите на платформу для бизнеса, зарегистрируйте компанию и создайте бота. Подробнее

После успешного прохождения модерации, которая может занимать до 48 рабочих часов, бот:

• получит статус «Готов к публикации»;
• станет доступен пользователям через поиск по никнейму;
• для него будет сгенерирован токен, который нужен для подключения к Омнидеску.

Шаг 2: настройки на стороне Омнидеска
Способ подключения бота зависит от его типа.

Вариант 1: Если у вас бот без разработки, выберите вариант «нет бота или он ничего не умеет», вставьте токен и нажмите на кнопку «Подключить».

Вариант 2: Если у вас бот с разработкой, то есть ваши разработчики прописали для него кастомную логику, выберите вариант подключения «есть рабочий бот», укажите API-токен, а затем нажмите кнопку «Подключить».

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

⚠️ В первом пункте этой инструкции будет ссылка на файл с примером JavaScript-кода. Файл содержит уникальный webhook URL, который ваши разработчики должны будут указать в своем скрипте как конечный адрес для передачи сообщений в Омнидеск.

Чтобы Max-бот мог получать сообщения из групповых чатов и отправлять ответы в них, добавьте его в группу в качестве администратора. Дополнительные разрешения для этой роли не требуются.

В форме подключения и редактирования Max-бота вы можете выбрать, какие сообщения будут поступать в Омнидеск из групповых чатов, в которые добавлен бот:

• все сообщения — чекбокс отключен;
• только сообщения с упоминанием бота — чекбокс отмечен.

⚠️ В групповых чатах вложения, кроме изображений, отправляются отдельными сообщениями, поэтому при отмеченном чекбоксе в Омнидеск они не поступят. Мы дали обратную связь коллегам из Мах по этому поводу, но пока не знаем, обновят ли они данную логику в будущем.

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

• отдельные стикеры могут не отображаться в виде изображения;
• видео- и аудиофайлы, отправленные сотрудниками через подключенного к сторонним сервисам бота, не отображаются у получателя;
• если пользователь отправит видео со сжатием, в Омнидеске оно корректно не отобразится;
• реакции на сообщения не поддерживаются.

Как минимум часть этих моментов коллеги из Max планируют поправить, но точных сроков пока нет.

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

Когда поступает новый чат (Max, Mattermost, Slack, Telegram, Viber, WhatsApp, ВК-сообщения, ОК-сообщения, Авито-сообщения, ФБ-сообщения, IG-сообщения, Line, онлайн-чат, кастомные каналы синхронного типа), в правом верхнем углу аккаунта сотрудника появляется зелёная иконка. Входящие чаты или новые ответы в чатах отображаются именно через неё:

Подробнее о логике работы чатов рассказываем в видеоруководстве по чатам.