Подключение MAX

1. Что вы получите

• Сообщения клиентов из MAX стекаются в «Чаты» кабинета, в одну очередь с остальными каналами.
• Ответ уходит от имени вашего бота — уводить человека в другой мессенджер не нужно.
• Можно включить AI-режим, а вместе с ним — запись прямо в переписке: бот покажет услуги, найдёт время и оформит бронь. Про это отдельная статья: запись из переписки.

MAX работает и как канал уведомлений. Напоминания, подтверждения и запросы отзыва уходят в MAX наравне с Telegram и ВКонтакте — и бесплатно, в отличие от SMS. Одно условие: у клиента должна быть привязка, иначе адреса в MAX кабинет не знает (шаг 5). Как устроен каскад каналов — см. уведомления.

2. Заведите бота в MAX

1. Откройте бизнес-платформу MAX для бизнеса и заведите бота организации.
2. Задайте имя и адрес бота — по ним клиент найдёт вас в поиске MAX. Имя лучше сделать узнаваемым: это то, что человек увидит в списке своих чатов.
3. Скопируйте выданный токен целиком — он понадобится на следующем шаге.

3. Вставьте токен в кабинет

Откройте Настройки → Мессенджеры, нажмите «Подключить бота MAX» и вставьте токен. Мы сразу спрашиваем MAX, чей это бот: если токен отклонён — подключение не сохранится, и вы увидите, что поправить.

Токен шифруется при сохранении и больше нигде не показывается — ни вам, ни поддержке. Посмотреть текущий нельзя; чтобы сменить, вставьте новый кнопкой «Заменить токен» на карточке канала. Переписки и настройки при замене сохраняются.

4. Как приходят входящие — и почему не мгновенно

• Кабинет сам спрашивает MAX о новых сообщениях, держа соединение открытым. Задержка в пределах нескольких секунд нормальна и починки не требует.
• Старая переписка не подтянется. При первом подключении отсчёт начинается с текущего момента: в «Чаты» попадут сообщения, пришедшие после подключения. Это сделано намеренно — иначе накопленный архив разом влился бы в кабинет новыми обращениями.
• Картинка или файл тоже заводят обращение. Если клиент прислал вложение без подписи, в переписке кабинета оно отобразится строкой «Вложение» — сам файл смотрите в MAX. Молча потерять такое сообщение кабинет не может: пустой журнал при живом диалоге хуже, чем строка без картинки.

5. Обращение из MAX живёт лидом, а не в карточке клиента

Диалог из MAX попадает в «Чаты» лидом — с тем именем, которым клиент подписан в мессенджере. К существующей карточке клиента он не приклеивается, даже если этот человек давно у вас в базе.

Причина не в настройке: MAX адресует переписку профилем мессенджера, а не телефоном (этим он отличается от WhatsApp, где адрес чата и есть номер). Само по себе входящее сообщение связать с карточкой не по чему — и автоматически этого не произойдёт.

Практический вывод: карточка появляется в момент записи. Если бронь оформил бот в переписке, у нового клиента источником карточки встанет MAX; если администратор записал клиента из чата руками — источником будет «из переписки». Записать клиента из чата можно и без AI-режима: работа в чатах.

Связать клиента с MAX вручную при этом можно — и именно так у него появляются уведомления в MAX. Как это делается — следующий шаг.

6. Привязка клиента: код, а не ссылка

Откройте карточку клиента и нажмите «Привязать MAX». Кабинет выдаст одноразовый код и сразу положит его в буфер обмена. Код действует сутки и срабатывает один раз.

Привязку делает код, а не переход по ссылке — этим MAX отличается от ВКонтакте, где достаточно открыть ссылку и нажать «Начать». Клиент должен прислать код сообщениемвашему боту MAX: просто написать его либо отправить /start код — годятся оба варианта. Если клиент откроет бота и напишет «здравствуйте», привязки не будет.

• Отправляет код клиент, а не вы. Привяжется тот, из чьего профиля MAX пришло сообщение: отправив код со своего устройства, администратор привяжет к карточке себя, и напоминания клиента поедут ему.
• Рядом с кодом кабинет показывает адрес вашего бота, если он задан. Иногда адреса нет — у бота MAX он необязателен, да и канал может быть ещё не подключён. Код в этом случае всё равно рабочий: ссылку кабинет не выдумывает, потому что ссылка, которая «вроде должна работать», не привязывает никого.
• После привязки в карточке встанет отметка «MAX привязан», а на вкладке «Каналы» в настройках уведомлений клиент попадёт в охват MAX.

7. Пауза и отключение — разные вещи

• Пауза — временная тишина: входящие из MAX не сохраняются, клиент не получит ответа. Токен остаётся, возобновление мгновенное. В самом мессенджере при этом ничего не меняется — сообщения клиентов продолжают копиться в MAX, просто мимо кабинета.
• Отключить — удаление канала: вся история переписок по нему стирается без возможности восстановить. Если нужно просто «чтобы замолчало» — ставьте паузу.

8. Если токен перестал действовать

Бота в MAX удалили, токен перевыпустили или отозвали — кабинет заметит это сам, не дожидаясь вашей жалобы. Раз в четверть часа он спрашивает у MAX, действует ли токен, и как только MAX отвечает «нет»:

• бейдж канала в настройках мессенджеров становится красным — «Токен отозван», а рядом появляется, с какого момента и что делать;
• в колокольчик приходит сигнал «MAX …: замените токен» — один на эпизод, а не на каждую проверку.

Лечится кнопкой «Заменить токен» на карточке канала: выпустите новый токен в бизнес-платформе MAX и вставьте его. Красная плашка гаснет сразу — ждать следующей проверки не нужно. Старый токен после отзыва не заработает, вставлять его повторно бессмысленно.

Сбой связи с MAX сигналом не считается. Если мы не дозвонились до платформы, кабинет промолчит: «не смогли проверить» — это не «токен плохой», и гнать вас перевыпускать исправный секрет из-за чужой сетевой неполадки мы не станем. Красная плашка появляется только тогда, когда MAX ответил и отказал.

9. Частые грабли

• «MAX отклонил этот токен». Токен скопирован не целиком либо бот удалён. Возьмите значение из бизнес-платформы заново и вставьте целиком.
• «Не удалось связаться с MAX… токен не проверен». Это сбой связи, а не ваша ошибка: токен мы вообще не успели проверить. Перевыпускать его не нужно — попробуйте через несколько минут.
• Подключилось, а в «Чатах» пусто. Сначала посмотрите на дату: старые диалоги не переносятся (шаг 4), нужен новый входящий. Если и новые не приходят — канал на паузе либо токен перестал действовать (шаг 8).
• Клиент есть в базе, а диалог всё равно лид. Так и должно быть — см. шаг 5. Свяжите вручную, записав клиента из чата.
• Клиент не получает напоминаний, хотя писал в MAX. Переписка и уведомления — разные вещи: то, что человек вам написал, адреса для рассылки не даёт. Нужна привязка кодом из карточки (шаг 6); до неё уведомления пойдут другим каналом — Telegram, ВКонтакте, SMS или почтой.
• Клиент привязан, а уведомления в MAX всё равно не идут. Посмотрите вкладку «Каналы» в настройках уведомлений: если MAX там «не подключён», значит дело не в клиенте — токен бота либо не вставлен, либо перестал действовать (шаг 8).