Введение
Вы ищете информацию о том, как создать бота в MAX и подключить его к HelpDeskEddy? Значит, вы на правильном пути. MAX — это российский мессенджер, который становится важным каналом коммуникации для бизнеса. А HelpDeskEddy позволяет превратить обычного бота в полноценную систему поддержки клиентов с тикетами, автоматизацией и аналитикой.
В этом документе мы разберем:
- что нужно для создания бота в MAX;
- два способа создания бота: через @MasterBot и через платформу MAX для партнеров;
- как подключить созданного бота к HelpDeskEddy;
- как настроить автоматизацию через конструктор ботов.
Что нужно знать перед созданием бота в MAX
Прежде чем приступить к созданию бота, важно понимать несколько ключевых моментов:
Требования к созданию бота
Существует два пути создания ботов в MAX, и требования к ним отличаются:
Через @MasterBot
Кому доступен: Любому пользователю MAX
Особенности: Простой способ, бот создается быстро, но с ограничениями
Через платформу MAX для партнеров
Кому доступен: Юридическим лицам и ИП — резидентам РФ
Особенности: Требуется верификация организации, но открывает больше возможностей
Что такое @MasterBot
@MasterBot — это главный бот в MAX, который отвечает за регистрацию новых ботов. Именно через него происходит создание ботов в MAX.
Зачем подключать бота к HelpDeskEddy
HelpDeskEddy — это система для работы с клиентами (help desk), которая позволяет:
- принимать обращения из MAX в виде заявок (тикетов);
- вести всю переписку с клиентом в едином окне;
- использовать автораспределение заявок между операторами;
- настраивать автоматические ответы и сценарии;
- собирать статистику и аналитику по обращениям.
Способ 1: Создание бота через @MasterBot (простой способ)
Этот способ подходит для тех, кто хочет быстро создать базового бота и протестировать его работу.
Пошаговая инструкция
Шаг 1. Найдите @MasterBot в MAX
1. Откройте мессенджер MAX
2. В поиске введите @MasterBot
3. Нажмите на профиль бота
4. Нажмите кнопку «Начать» — откроется чат с MasterBot
Шаг 2. Создайте нового бота
1. В чате с MasterBot отправьте команду /create
2. Бот попросит придумать никнейм (уникальное имя) для бота
Правила создания ника:
— Используйте только латиницу и символ подчеркивания
— Ник должен заканчиваться на bot или _bot
— Минимальная длина — 11 символов с учетом окончания
— Пример: myshop_bot, support_bot, newsbot
3. ⚠️ Важно: никнейм изменить нельзя, выбирайте внимательно!
4. Отправьте придуманный никнейм
5. Бот попросит ввести полное имя бота
— Это название, которое будут видеть пользователи
— Максимум 59 символов
— Можно использовать русские и латинские буквы
— Пример: «Интернет-магазин BOT», «Поддержка клиентов»
6. Отправьте имя
Шаг 3. Получите API-токен
После успешного создания бота MasterBot отправит вам API-токен — это длинная строка букв и цифр.
🔐 Важно: храните токен в безопасности, не публикуйте его в открытых источниках. Это ключ доступа к управлению ботом.
Шаг 4. Настройте бота (дополнительно)
Вы можете управлять ботом через дополнительные команды MasterBot:
- /set_description — Добавить описание бота (до 512 символов)
- /set_name — Изменить отображаемое имя бота
- /set_avatar — Загрузить фото-аватар бота
- /refresh_token — Обновить токен (в случае компрометации)
- /revoke — Отозвать токен и отключить бота
- /list — Посмотреть все ваши боты
Пример добавления описания:
1. Отправьте команду /set_description
2. Напишите, что делает ваш бот (до 512 символов)
3. Пример: «Этот бот помогает оформить заказ в нашем интернет-магазине за 2 минуты»
Пример загрузки аватара:
1. Отправьте команду /set_avatar
2. MasterBot попросит отправить изображение
3. Прикрепите фото с помощью скрепки
✅ Результат: ваш бот создан и готов к подключению!
Способ 2: Создание бота через платформу MAX для партнеров (для бизнеса)
Этот способ подходит для компаний, которым нужен полноценный бизнес-бот с расширенными возможностями.
Требования
- Ваша организация должна быть зарегистрирована в РФ как юридическое лицо или ИП
- Рекомендуется использовать корпоративную электронную почту
Пошаговая инструкция
Шаг 1. Зарегистрируйтесь на платформе MAX для партнеров
1. Перейдите на сайт https://dev.max.ru/docs/maxbusiness/connection
2. Пройдите регистрацию
3. Создайте и верифицируйте профиль организации (потребуется указать ИНН)
4. Процесс верификации может занять до 48 часов
Шаг 2. Создайте чат-бота
1. В личном кабинете перейдите в раздел «Чат-боты»
2. Нажмите «Создать»
3. Заполните карточку бота:
— Название: имя, которое увидят пользователи
— Ник (Nickname): уникальное имя для публичной ссылки (нельзя изменить позже)
— Сайт: ссылка на официальный сайт компании
— Логотип и описание: аватар и краткая информация о функциях
Шаг 3. Пройдите модерацию
После создания бот отправляется на проверку. Модерация может занять до 48 часов. Когда бот получит статус «Готов к публикации», он станет доступен для поиска в MAX.
Шаг 4. Получите API-токен
1. В бизнес-кабинете MAX перейдите в раздел «Чат-боты» → «Интеграция»
2. Выберите нужного бота из списка
3. Нажмите значок «Скопировать» в поле «Токен доступа»
Шаг 5. Настройте параметры бота
После модерации вы можете настроить дополнительные параметры:
— Разрешить или запретить добавление бота в групповые чаты
— Настроить кнопку запуска мини-приложения (если есть)
— Подключить сервисы партнеров
Подключение бота MAX к HelpDeskEddy
После того как бот создан и у вас есть API-токен, можно приступать к подключению к HelpDeskEddy.
Пошаговая инструкция
Шаг 1. Войдите в HelpDeskEddy
Авторизуйтесь в своей учетной записи HelpDeskEddy.
Шаг 2. Перейдите в настройки каналов связи
1. В главном меню выберите «Управление» → «Настройки каналов связи»
2. Нажмите кнопку «Добавить канал»
Шаг 3. Выберите тип канала
В выпадающем списке выберите «MAX» (или «MAX Messenger»).
Шаг 4. Укажите департамент
Выберите департамент, в который по умолчанию будут поступать заявки от бота.
Шаг 5. Вставьте API-токен
В поле «Ключ бота» вставьте API-токен, полученный при создании бота.
Шаг 6. Сохраните настройки
Нажмите кнопку «Синхронизировать и сохранить».
Шаг 7. Проверьте подключение
Если все настройки указаны корректно, отобразится статус «Соединение успешно установлено!».
✅ Результат: бот подключен к HelpDeskEddy. Все сообщения, отправленные боту пользователями, теперь будут поступать в HelpDeskEddy в виде заявок (тикетов), а ответы операторов будут отправляться клиентам от имени бота.
Настройка бота для работы в группах
Если вы планируете использовать бота в групповых чатах, необходимо выполнить дополнительные настройки:
- Назначьте бота администратором группы — это обязательное условие для получения всех сообщений
- Включите опцию «Групповой чат MAX» в настройках канала в HelpDeskEddy
После этого все сообщения участников группы будут попадать в заявки HelpDeskEddy.
Создание сценариев бота в HelpDeskEddy
После подключения бота вы можете настроить его поведение с помощью встроенного конструктора ботов.
Что такое конструктор ботов
Конструктор ботов в HelpDeskEddy — это визуальный инструмент, который позволяет создавать сценарии общения без программирования. Он работает для всех подключенных каналов, включая MAX.
Основные элементы конструктора
Ответ
Отправка текстового сообщения клиенту
Кнопки
Создание набора интерактивных кнопок для выбора
Текстовое меню
Альтернатива кнопкам для каналов без их поддержки
Запрос ввода данных
Сбор информации от клиента (телефон, email и т.д.) с проверкой формата
Остановка бота
Завершение работы бота и передача заявки оператору
Вызов сотрудника
Остановка бота с подключением оператора
Пример: создание простого сценария
1. Перейдите в конструктор
Перейдите в «Конструктор ботов» в меню HelpDeskEddy
2. Добавьте первый шаг
Нажмите «+», чтобы добавить первый шаг
3. Добавьте ответ
Например: «Здравствуйте! Чем могу помочь?»
4. Добавьте кнопки
— «Узнать статус заказа»
— «Задать вопрос оператору»
— «Оставить отзыв»
5. Настройте действия
Для каждой кнопки настройте дальнейшие действия
6. Сохраните сценарий
Сохраните созданный сценарий
Использование переменных
Вы можете сохранять данные, введенные клиентом, во временные переменные:
- В блоке «Запрос ввода данных» укажите название переменной, например phone
- После остановки бота используйте тег {temporary_field:phone} для отображения сохраненных данных в заявке
Особенности работы конструктора
- Пока бот является исполнителем заявки, правила диспетчера не применяются
- После остановки бота исполнитель автоматически меняется на «Неприсвоенный», и заявка поступает в общую очередь
- Вы можете отслеживать в отчетах, сколько заявок было обработано ботом
Отправка push-уведомлений в MAX
HelpDeskEddy позволяет отправлять уведомления в MAX при различных событиях: создание заявки, новый ответ, нарушение SLA и т.д.
Настройка через Диспетчер
- Перейдите в меню «Диспетчер»
- Создайте новое правило с нужными условиями
- В действиях выберите «Отправить вебхук»
- Заполните URL в формате:
https://botapi.max.ru/uploads?access_token=%access_token&user_id=123456
где %access_token — токен бота, user_id — ID пользователя в MAX - Заполните тело запроса в JSON формате, например:
{"text": "Поступила новая заявка! Ссылка: {link_staff}"}
Как узнать user_id
- Дождитесь, пока пользователь напишет сообщение боту
- В HelpDeskEddy откройте карточку контакта этого пользователя
- В карточке будет указан user_id в MAX
Альтернативный способ: подключение персонального MAX через Green API
Если у вас уже есть личный аккаунт в MAX и вы не хотите создавать отдельного бота, существует возможность подключить персональный MAX к HelpDeskEddy через сервис Green API.
Для чего это нужно
- Превратить обычный мессенджер в полноценный канал поддержки
- Не создавать отдельного бота, использовать существующий аккаунт
- Все обращения автоматически попадают в HelpDeskEddy
Как подключить
- Зарегистрируйтесь на сайте Green API
- Получите параметры доступа: apiUrl, idInstance, apiTokenInstance
- В HelpDeskEddy добавьте канал «MAX персональный Green API»
- Вставьте полученные параметры и сохраните
Важные ограничения
Аккаунт MAX может быть заблокирован при:
- жалобах от пользователей;
- массовых рассылках и спаме;
- частых проверках номеров;
- сообщениях на несуществующие номера.
Сравнение способов создания бота
@MasterBot
Сложность: Низкая
Время создания: 5–10 минут
Требования: Аккаунт MAX
Возможности: Базовые
Подходит для: Тестирования, личных проектов
Платформа MAX для партнеров
Сложность: Средняя
Время создания: До 48 часов (верификация + модерация)
Требования: Юрлицо или ИП, верификация
Возможности: Расширенные (мини-приложения, партнерские сервисы)
Подходит для: Бизнеса, официальных компаний
Часто задаваемые вопросы
Можно ли изменить никнейм бота после создания?
Нет, никнейм бота в MAX изменить нельзя. Выбирайте его внимательно при создании.
Что делать, если я потерял токен бота?
Вы можете получить новый токен через @MasterBot с помощью команды /refresh_token или в личном кабинете MAX для партнеров.
Поддерживает ли MAX отправку кнопок?
Да, MAX поддерживает интерактивные кнопки. В HelpDeskEddy вы можете создавать кнопки через конструктор ботов.
Сколько времени занимает модерация бота?
При создании бота через платформу MAX для партнеров модерация может занять до 48 часов.
Можно ли подключить одного бота к нескольким системам?
Технически да, но рекомендуется использовать один бот для одной платформы для избежания конфликтов.
Заключение
Создание бота в MAX и его подключение к HelpDeskEddy — это последовательный процесс, который включает три основных этапа:
- Создание бота — через @MasterBot или платформу MAX для партнеров
- Получение API-токена — уникального ключа для управления ботом
- Подключение к HelpDeskEddy — добавление канала и настройка автоматизации
После подключения вы получаете мощный инструмент для работы с клиентами: все обращения превращаются в удобные заявки, доступны сценарии автоматизации, автораспределение, аналитика и многое другое.
Готовы создать бота в MAX и подключить его к HelpDeskEddy?
👉 Зарегистрируйтесь в HelpDeskEddy и следуйте инструкциям из этого документа. Если остались вопросы — напишите в чат поддержки, поможем с настройкой.
Протестировать HelpDeskEddy бесплатно