МАКС на сайте: кнопка, ссылка на бота и выбор виджета

Выберите действие посетителя

Под словом «виджет МАКС» могут иметь в виду кнопку перехода, окно стороннего сервиса поддержки или собственную интеграцию. Сначала определите результат: человек подписывается на канал, задаёт вопрос оператору или запускает сценарий бота. Для каждого результата нужен свой адрес и свой способ проверки.

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

Ссылка на канал и ссылка на бота

Для канала используйте его действительную ссылку из МАКС. Где взять адрес и QR, описано в инструкции по приглашениям. Откройте её с отдельного устройства и убедитесь, что она ведёт в нужный проект. Не составляйте адрес по названию компании: видимое имя и фактическая ссылка могут различаться. Подробную проверку адреса проводите до размещения кнопки на всех страницах сайта.

Для бота официальная документация описывает формат https://max.ru/<botName>?start=<payload>. Параметр передаёт контекст запуска, например источник перехода. Это не универсальный формат для каналов. Замените botName настоящим никнеймом своего бота, а значение параметра согласуйте с разработчиком сценария.

Пример разметки источников

Представим сайт курсов с тремя точками входа: главной страницей, программой курса и разделом поддержки. Для бота можно согласовать значения home, course_photo и support. Тогда команда сможет различать назначение обращений и показывать подходящий первый вопрос. Это учебная схема; сами значения не создают обработчик автоматически.

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

Что проверить у разработчика

Документация МАКС связывает получение параметра запуска с событием bot_started. Разработчик должен проверить обработку этого события, сопоставление источника с нужным сценарием и поведение при повторном обращении. Нажатие кнопки на сайте и фактический запуск бота — разные события, поэтому отчёты по ним могут различаться.

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

Если нужен сторонний виджет

В официальном каталоге партнёров МАКС представлены сервисы общения с клиентами и интеграций. Сам факт присутствия в каталоге не подтверждает конкретный тариф, интерфейс или все необходимые функции выбранного продукта. Перед подключением попросите демонстрацию именно вашего сценария: сайт, МАКС, оператор и история обращения.

Проверьте стоимость, доступы сотрудников, порядок удаления переписки и возможность выгрузить свои данные. Выясните, кто отвечает при сбое и можно ли оставить простую ссылку на МАКС как резервный маршрут. Не вставляйте случайный скрипт из чужого примера: код на сайте должен поступать от выбранного вами поставщика.

Приёмка на телефоне и компьютере

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

Для приёмки запишите четыре результата: правильный адрес, понятный первый экран, полученное тестовое обращение и правильный источник в отчёте. После изменения никнейма или сценария повторите проверку. Если кнопка ведёт в редакционный канал, подготовьте там полезный закреплённый пост и регулярные публикации; их расписание удобно вести через Отложку.

Источники и проверка

Официальные материалы просмотрены 23 октября 2026 года: Документация МАКС: prepare, Документация МАКС: partners-integration. Рабочие примеры и план проверки подготовлены редакцией.

Канал или группа · Персональные данные · Как подключить Отложку