Клиентская инструкция MaxClient
Эта страница помогает пройти весь путь запуска: зарегистрироваться, собрать проект, подключить MAX и Bitrix24, а затем проверить, что комментарии и ответы уже ходят по рабочей связке.
Как это работает
После запуска MaxClient становится прослойкой между комментариями в MAX и открытой линией Bitrix24. Ниже — короткий рабочий сценарий, который вы в итоге должны получить.
Вы публикуете пост в MAX-канале.
Под постом появляется кнопка комментариев.
Пользователь открывает mini app и оставляет комментарий.
Комментарий уходит в открытую линию Bitrix24.
Оператор отвечает в Bitrix24.
Ответ возвращается пользователю в MAX.
Подготовка
Короткий маршрут
Шаг 1
Откройте страницу входа в личный кабинет и нажмите «Регистрация» в правом нижнем углу формы.
Укажите имя, email, пароль и ИНН компании или ИП. После ввода полного ИНН система автоматически проверит его и, если нужно, покажет несколько вариантов организации для выбора.
Что должно получиться
Шаг 2
После регистрации MaxClient отправит письмо с ссылкой подтверждения на email, который вы указали в форме.
Откройте письмо, перейдите по ссылке и дождитесь экрана с сообщением, что почта подтверждена и вход уже активирован.
Что должно получиться
Шаг 3
После входа откройте профиль и проверьте реквизиты, которые были получены из DaData.
Сразу заполните контактные данные: фактический адрес, телефон, email для документов, контактное лицо, должность, сайт и комментарий. Эти поля пригодятся уже на реальной работе с проектом.
Что должно получиться
Шаг 4
Перейдите в раздел «Проекты», нажмите «Создать проект» и укажите название проекта. При необходимости проект можно сначала сохранить как черновик, а позже вернуться к нему.
Заполните MAX-поля: ссылку на бота или имя бота, токен бота, ссылку на канал, текст кнопки комментариев и приветственный текст. Рядом с полями есть подсказки, если нужно вспомнить формат.
После сохранения у проекта появятся Bitrix24 Install URL и Bitrix24 Handler URL — они понадобятся на следующем этапе.
Что должно получиться
Шаг 5
Откройте портал Bitrix24 и перейдите по пути «Разработчикам → Другое → Локальное приложение». Для этого проекта используйте именно те Install URL и Handler URL, которые показывает карточка проекта в MaxClient.
Выберите серверный тип приложения, заполните URL, укажите права и сохраните приложение. Для интеграции ориентируйтесь на права imconnector, imopenlines, placement, rest и contact_center.
Что должно получиться
Шаг 6
После сохранения приложения вернитесь в проект MaxClient и заполните Bitrix Client ID и Bitrix Client Secret. Затем активируйте проект.
Дальше откройте в Bitrix24 контакт-центр, найдите коннектор MaxClient и откройте его именно из карточки нужной открытой линии. Это важный момент: не отдельно, а именно из линии, куда должны падать комментарии.
После подключения опубликуйте тестовый пост в MAX-канале, дождитесь кнопки комментариев, откройте mini app и оставьте тестовый комментарий. Затем ответьте оператором в Bitrix24 и проверьте, что ответ вернулся в MAX.
Что должно получиться
Финальная проверка
Если нужна помощь
Самые частые ошибки происходят, когда приложение создано в одном Bitrix24-портале, а коннектор открыт из другой линии или когда в проекте указаны не те MAX-данные. Если идти по инструкции сверху вниз и не перескакивать шаги, связка поднимается без ручной технической настройки.