Адаптация бота для разных мессенджеров на LEADTEX
Telegram, MAX, ВКонтакте и WhatsApp
Практические рекомендации по адаптации одного чат-бота под Telegram, MAX, ВКонтакте и WhatsApp в LEADTEX.
На платформе LEADTEX один бот можно подключить сразу к четырём мессенджерам: Telegram, ВКонтакте, MAX и WhatsApp. При этом каждый мессенджер имеет свою специфику — учитывайте её при настройке сценариев и клавиатуры.
Для подключения перейдите в раздел Мессенджеры и следуйте инструкциям по подключению к LEADTEX.
Выбор мессенджера
Запуск чат-бота
Telegram
- Основная стартовая команда — /start (запускает главный сценарий).
- Поддерживаются deeplinks — для отслеживания трафика и перенаправления пользователей на нужные сценарии.
ВКонтакте
- Запуск бота — начало диалога в рамках подключенного сообщества.
- Deeplinks настраиваются аналогично Telegram, но работают только для новых пользователей (первый запуск).
- Для повторного запуска бота при тестировании используйте команду 000.
MAX
- Настройка дополнительных ссылок производится на стороне мессенджера MAX, а не в LEADTEX.
- Deeplinks в MAX пока не поддерживаются (находятся в разработке).
- Вместо deeplinks используются заготовленные фразы-триггеры.
Подробнее о настройке запуска чат-бота в WhatsApp
Клавиатура
Возможности клавиатуры существенно отличаются в каждом мессенджере. Ниже — ключевые параметры и ограничения.
Telegram
- Доступны инлайн и не инлайн кнопки - нельзя комбинировать в одном сообщении.
- Поддерживаются цветные кнопки.
- Максимальная длина видимого текста кнопки — 64 символа.
- Дополнительно доступны команды для запуска отдельных сценариев или блоков.
Подробнее о клавиатуре в Telegram
ВКонтакте
- Доступны инлайн и не инлайн кнопки.
- Максимальная длина видимого текста кнопки — 40 символов.
MAX
- Доступна только инлайн-клавиатура.
- Максимальная длина видимого текста кнопки — 128 символов, рекомендуемое значение — 20.
- Команды доступны, но настраиваются на стороне MAX — в LEADTEX обрабатываются как обычные текстовые сообщения через блок Переключатель.
- Меню работает в режиме ответа цифрами.
Подробнее о настройке меню для WhatsApp
Важно
LEADTEX автоматически обрезает названия кнопок при превышении допустимой длины — это исключает ошибки отправки. Тем не менее, следите за длиной текста при проектировании сценария.
Настройка клавиатуры производится внутри блока сценария: раздел Настройки клавиатуры → выбор нужного мессенджера.
Настройка клавиатуры
Текущие ограничения по мессенджерам
При адаптации сценария под MAX и ВКонтакте учитывайте следующие ограничения:
MAX
- Рассылки недоступны — требование мессенджера.
- Форматирование текста (разметка) не поддерживается — уберите из сообщений все теги форматирования. Поддержка будет добавлена в ближайших спринтах.
- Реферальная система и deeplinks в разработке.
- Проверка членства пользователя в группе недоступна — соответствующие блоки сценария просто не будут срабатывать.
ВКонтакте
- Проверка членства пользователя в группе недоступна — аналогично MAX.
Таблица возможностей
| Функция | Telegram | ВКонтакте | MAX | |
|---|---|---|---|---|
| Инлайн-кнопки | ✅ Да | ✅ Да | ✅ Да | ❌ Нет |
| Не инлайн-кнопки | ✅ Да | ✅ Да | ❌ Нет | ❌ Нет |
| Цветные кнопки | ✅ Да | ❌ Нет | ❌ Нет | ❌ Нет |
| Deeplinks | ✅ Да | ✅ Да | ✅ Да (через MAX) | ✅ Да, аналог заготовленные фразы |
| Команды | ✅ Да | ✅ Да | ✅ Да (через MAX) | ❌ Нет |
| Рассылки | ✅ Да | ✅ Да | ❌ Нет | ✅ Да |
| Реферальная система | ✅ Да | ✅ Да | ❌ Нет | ✅ Да |
| Проверка членства в группе | ✅ Да | ❌ Нет | ❌ Нет | ❌ Нет |
| Форматирование текста | ✅ Да | ✅ Да | ❌ Нет | ✅ Да |
Подробные материалы о создании чат-ботов для каждого из мессенджеров доступны по ссылкам: