Каналы связи

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

Кратко

Канал MAX Bot подключает бота мессенджера MAX (бывший TamTam) к tuk-tuk.online: сообщения пользователей приходят в «Диалоги», ответы уходят от имени бота, поддерживаются медиа и inline-кнопки.

  • Путь в кабинете: Каналы связи → Подключить → MAX Bot → токен → Сохранить.
  • Предусловие: токен бота от @PrimeBot в MAX (команда /create).
  • Приём через Long Polling, публичный IP и домен не нужны; API: platform-api.max.ru; медиа через MAX Upload API.
  • Inline-кнопки: callback, link, request_contact, request_geo_location, open_app.
  • Входящие: текст, фото, видео, аудио, файлы, локация, контакт, нажатие кнопки. Исходящие: текст, фото, видео, файлы, inline-кнопки.
  • Пауза около 3 секунд между сообщениями.
На этой странице

Канал MAX Bot подключает бота в мессенджере MAX (мессенджер от VK, бывший TamTam) к tuk-tuk.online. Пользователь пишет боту, сообщение приходит в раздел Диалоги, ответ уходит от имени бота. Сообщения принимаются через Long Polling, поэтому свой IP-адрес или домен не нужны.

#Когда это нужно

  • Ваши клиенты пользуются мессенджером MAX.
  • Обрабатывать сообщения из MAX вместе с другими каналами.
  • Поставить AI-ассистента, который отвечает пользователям MAX автоматически.

#Как подключить

#Создать бота в MAX

  1. Откройте мессенджер MAX и найдите бота @PrimeBot, официального бота для создания ботов.
  2. Отправьте команду /create: PrimeBot создаст нового бота.
  3. Скопируйте токен бота из ответа.

#Добавить канал

Форма подключения MAX Bot
  1. Название канала.

  2. Bot Token из MAX BotFather.

  3. Кнопка «Подключить».

  4. Откройте Каналы связи.

  5. Нажмите «Подключить» на карточке MAX Bot.

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

  7. Нажмите «Сохранить»: платформа подключит Long Polling, канал получит статус «Активен».

#Проверить, что работает

  1. Найдите бота в MAX и напишите ему.
  2. Откройте Диалоги: сообщение появится в списке.

#Что умеет

#Входящие

ТипОписание
ТекстТекстовые сообщения
ФотоИзображения
ВидеоВидеозаписи
АудиоГолосовые сообщения
ФайлыДокументы любых форматов
ЛокацияГеолокация пользователя
КонтактКарточка контакта
Нажатие кнопкиCallback от inline-кнопок

#Исходящие

ТипОписание
ТекстТекстовые сообщения
ФотоИзображения, загружаются через MAX Upload API
ВидеоВидеозаписи
ФайлыДокументы
Inline-кнопкиИнтерактивные кнопки под сообщением

#Inline-кнопки

ТипЧто делает
callbackОтправляет callback-данные боту
linkОткрывает ссылку в браузере
request_contactЗапрашивает контакт пользователя
request_geo_locationЗапрашивает геолокацию
open_appОткрывает мини-приложение

Кнопки размещаются горизонтально или вертикально, в несколько рядов. Примеры: «Записаться», «Задать вопрос», «Посмотреть цены». Кнопки задаются в цепочках автоматизации.

#Индикатор набора текста

Пока AI формирует ответ, бот показывает пользователю индикатор «печатает…».

#Ограничения

  • Между сообщениями пауза около 3 секунд: защита от лимитов API.
  • Приём через Long Polling: работает без публичного IP и домена.
  • Медиафайлы загружаются через MAX Upload API.
  • Адрес MAX API: platform-api.max.ru.

#Частые проблемы

ПроблемаЧто делать
Канал не получает сообщенияПроверьте, что токен бота актуален
Бот не отвечаетУбедитесь, что канал активен: зелёная точка в списке каналов
Изображения не отправляютсяПроверьте размер файла: у MAX есть лимит
Кнопки не работаютПроверьте тип кнопки