Веб-виджет

Что это

Веб-виджет — чат на вашем сайте. Посетитель открывает окно на странице, пишет сообщение, а сценарий конструктора (или оператор в «Чатах») отвечает — без Telegram и WhatsApp.

Подходит для лендингов, справки и продуктовых сайтов, где нужен свой брендированный чат.

Требования

  • Бот-конструктор в Botconsole
  • Возможность вставить код виджета на сайт
  • Тариф с доступом к виджету (пробный период или Pro — в зависимости от аккаунта)

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

  1. Боты → бот → Настройки.
  2. Добавить подключениеWeb Widget / виджет (или откройте существующее).
  3. Настройте внешний вид и поведение (цвета, приветствие, языки, позиция и т.д.).
  4. В блоке установки скопируйте код и вставьте на сайт (или в CMS).
  5. Откройте страницу в браузере и отправьте тестовое сообщение.
  6. Убедитесь, что отвечает сценарий и диалог виден в Чатах.

На одном боте можно держать виджет вместе с Telegram и другими каналами — это разные подключения.

Типы сообщений и ограничения

Доступные типы сообщений

Тип Доступно
Текст Да
Картинка Да
Видео Да
Аудио Да
Документ Да
Группа медиа Да
Стикер, геолокация, контакт Нет / ограничено (лучше веб-удобные медиа)
Опросы Telegram Нет как нативные — используйте ветвление сценария

Кнопки

  • Inline-кнопки под сообщением — да
  • Кнопки-ответы в интерфейсе чата — да
  • До 8 кнопок в ряду, до 20 рядов
  • Текст кнопки до 64 символов

Дополнительные настройки

Опция Доступно
Потоковый ответ ИИ Да
Редактирование / удаление сообщений бота Да
Статус «печатает…» Да
Эффект сообщения Нет
Ответ на конкретное сообщение Нет
Пересылка в другой чат Нет
Темы форума Нет
Окно 24 часа Нет — пока посетитель на сайте, можно писать

Лимиты

Ограничение Значение
Текст до 10 000 символов
Подпись до 4 096
Файлы около 50 МБ (браузер и хостинг могут ограничивать сильнее)

Форматирование

Виджет понимает облегчённый Markdown:

  • Жирный, курсив, подчёркивание, зачёркивание
  • Код и блоки кода
  • Цитаты
  • Ссылки

Спойлеры в виджете не используются.

Особенности и примечания

Виджет работает только там, где вставлен код. Отдельного токена BotFather нет.

Делайте короткие тексты и подписи кнопок — на телефоне окно чата узкое.

Если виджет на пробном периоде, завершите настройку до его окончания или перейдите на тариф с виджетом.