К содержанию
Все статьи справки
  1. Справка
  2. Интеграции

Бот клиники в MAX

Тот же бот, что в Telegram, в мессенджере MAX: подтверждение и перенос приёма кнопками, переписка в «Чатах», код входа в кабинет. Как создать бота и подключить его.

Не проверено вживую Бот MAX проверен тестами и в браузере на поддельном API MAX. С настоящим ботом клиники ещё не проверяли: нужен бот, прошедший проверку на business.max.ru.

В DentOS у бота одна логика на два мессенджера. Всё, что умеет Telegram-бот, умеет и бот в MAX: «Мои записи», подтверждение, перенос и отмена кнопками, напоминания, переписка с администратором, ночной ИИ-автоответ и код входа в кабинет МойДент.

Создать бота

  1. Бота создаёт юрлицо или ИП на business.max.ru. Сначала MAX проверяет организацию, потом модерирует самого бота.
  2. Когда бот одобрен, возьми токен в разделе «Чат-боты → Настройки».

Подключить

  1. В DentOS: «Чаты → Каналы» (или «Настройки → Интеграции → MAX → Настроить»), карточка MAX.
  2. Вставь токен и сохрани. Неверный токен программа не сохранит.
  3. Появятся ссылка на бота, счётчик привязанных пациентов и время последнего события. «Проверить связь» покажет, отвечает ли бот и доходят ли события до сервера.

Токен хранится зашифрованным и передаётся в MAX только в заголовке запроса.

Как пациент привязывается

Пациент нажимает «Начать», бот просит отправить номер кнопкой. Карточка привязывается, только если это собственный контакт пациента в MAX. Чужую визитку или контакт из записной книжки бот не примет: иначе по чужому номеру можно было бы попасть в чужой кабинет. Бот работает только в личной переписке, группы и каналы он игнорирует.

Как выбирается мессенджер

Если пациент привязан и к Telegram, и к MAX, сообщение уходит туда, где он привязался последним. В автосценариях и рассылках по умолчанию стоит порядок «Telegram, MAX, SMS». Подробнее — в статье SMS.

Как бот получает события

  • Вебхук — MAX сам присылает события на адрес сервера. Нужен адрес по https без порта. В облачной версии это режим по умолчанию.
  • Опрос — сервер сам спрашивает MAX о новых событиях. Режим по умолчанию для сервера в клинике. Если адрес сервера не подходит для вебхука, настройки об этом предупредят.

Кнопки чатов на страницах пациента

Онлайн-запись и кабинет показывают кнопки «Telegram», «MAX» и «WhatsApp». Настраиваются в «Настройки → Интеграции → Кнопки чатов на страницах пациента»:

  • пустое поле Telegram или MAX ведёт в бот клиники, и переписка попадает в «Чаты»;
  • WhatsApp — только переход в чат по ссылке wa.me, переписка в DentOS не попадает. С февраля 2026 года WhatsApp в России заблокирован, без VPN пациент чат может не открыть.