Как создать бота в MAX и подключить его к HelpDeskEddy: полная инструкция

Введение

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

В этом документе мы разберем:

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

Что нужно знать перед созданием бота в MAX

Прежде чем приступить к созданию бота, важно понимать несколько ключевых моментов:

Требования к созданию бота

Создание ботов в MAX осуществляется через официальный портал для разработчиков. Этот способ доступен для:

Юридических лиц – компаний, зарегистрированных в РФ;
Индивидуальных предпринимателей (ИП);
Самозанятых – физических лиц, применяющих специальный налоговый режим «Налог на профессиональный доход».

Для всех категорий требуется верификация профиля на портале. Самозанятые могут пройти верификацию как физические лица с указанием ИНН.

Что такое портал MAX для разработчиков

Портал MAX для разработчиков – это официальная платформа, где вы можете создавать ботов, управлять ими и получать API-токены для интеграции. Здесь же проходят модерацию все боты перед публикацией.

Зачем подключать бота к HelpDeskEddy

HelpDeskEddy — это система для работы с клиентами (help desk), которая позволяет:

принимать обращения из MAX в виде заявок (тикетов);
вести всю переписку с клиентом в едином окне;
использовать автораспределение заявок между операторами;
настраивать автоматические ответы и сценарии;
собирать статистику и аналитику по обращениям.

Создание бота через портал MAX для разработчиков

Это официальный способ создания ботов для бизнеса и частных лиц. Он предоставляет все необходимые инструменты для интеграции и управления.

Пошаговая инструкция

Шаг 1. Перейдите на портал разработчиков

Откройте сайт https://dev.max.ru и нажмите «Войти» или «Зарегистрироваться».

Шаг 2. Зарегистрируйтесь и создайте профиль

Укажите свои данные (для юридических лиц, ИП или самозанятых – потребуется ИНН). Пройдите верификацию – процесс может занять до 48 часов.

Шаг 3. Создайте нового бота

В личном кабинете перейдите в раздел «Чат-боты» → «Создать». Заполните карточку бота:

Название – отображаемое имя (до 59 символов, можно на русском).
Никнейм (Nickname) – уникальное имя для ссылки (только латиница, обязательно заканчивается на bot или _bot, минимум 11 символов). Внимание: никнейм изменить нельзя!
Сайт – ссылка на ваш официальный сайт (опционально).
Логотип и описание – аватар и краткая информация о функциях бота.

Шаг 4. Пройдите модерацию

После создания бот отправляется на проверку. Модерация обычно занимает до 48 часов. Как только статус изменится на «Готов к публикации», бот станет доступен для поиска в MAX.

Шаг 5. Получите API-токен

В личном кабинете перейдите в раздел «Чат-боты» → выберите нужного бота → вкладка «Интеграция». Скопируйте «Токен доступа» – это длинная строка, которая понадобится для подключения к HelpDeskEddy.

🔐 Важно: храните токен в безопасности, не публикуйте его в открытых источниках.

Шаг 6. Дополнительные настройки (опционально)

После модерации вы можете настроить:

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

✅ Результат: ваш бот создан, прошёл модерацию, и у вас есть API-токен для интеграции.

Более подробную информацию вы всегда найдёте в официальной документации MAX.

Подключение бота MAX к HelpDeskEddy

После того как бот создан и у вас есть API-токен, можно приступать к подключению к HelpDeskEddy.

Пошаговая инструкция

Шаг 1. Войдите в HelpDeskEddy

Авторизуйтесь в своей учетной записи HelpDeskEddy.

Шаг 2. Перейдите в настройки каналов связи

1. В главном меню выберите «Управление» → «Настройки каналов связи»
2. Нажмите кнопку «Добавить канал»

Шаг 3. Выберите тип канала

В выпадающем списке выберите «MAX» (или «MAX Messenger»).

Шаг 4. Укажите департамент

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

Шаг 5. Вставьте API-токен

В поле «Ключ бота» вставьте API-токен, полученный на портале MAX.

Шаг 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 изменить нельзя. Выбирайте его внимательно при создании на портале.

Что делать, если я потерял токен бота?

Вы можете получить новый токен в личном кабинете на портале MAX для разработчиков в разделе «Интеграция» вашего бота.

Поддерживает ли MAX отправку кнопок?

Да, MAX поддерживает интерактивные кнопки. В HelpDeskEddy вы можете создавать кнопки через конструктор ботов.

Сколько времени занимает модерация бота?

Модерация на портале MAX может занять до 48 часов.

Можно ли подключить одного бота к нескольким системам?

Технически да, но рекомендуется использовать один бот для одной платформы для избежания конфликтов.

Могут ли самозанятые создать бота в MAX?

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

Заключение

Создание бота в MAX и его подключение к HelpDeskEddy — это последовательный процесс, который включает три основных этапа:

Создание бота на официальном портале MAX для разработчиков
Получение API-токена для управления ботом
Подключение к HelpDeskEddy — добавление канала и настройка автоматизации

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

Готовы создать бота в MAX и подключить его к HelpDeskEddy?

👉 Зарегистрируйтесь на портале MAX для разработчиков, создайте бота, получите токен и следуйте инструкциям из этого документа. Если остались вопросы — напишите в чат поддержки HelpDeskEddy, поможем с настройкой.

Протестировать HelpDeskEddy бесплатно