Что это
WhatsApp подключает бота-конструктора к WhatsApp Business через Meta Cloud API. Клиенты пишут на бизнес-номер; Botconsole запускает сценарии и показывает переписку в чатах аккаунта.
У WhatsApp более строгие правила, чем у Telegram: лимиты кнопок, размеры файлов и окно общения 24 часа.
Требования
- Бот-конструктор в Botconsole
- Приложение Meta с WhatsApp Cloud API (настраивает разработчик или агентство)
- Номер WhatsApp Business в Meta
- Phone number ID и access token
На части тарифов канал может быть доступен только на планах с Meta-каналами.
Как подключить
- Боты → бот → Настройки.
- Добавить подключение → WhatsApp.
- Вкладка настройки подключения (Meta).
- Скопируйте Webhook URL и Verify token в Meta App → Webhooks (если приложение ваше).
- Заполните:
- Phone number ID (обязательно)
- Access token (обязательно)
- App secret (рекомендуется)
- WABA ID / отображаемый номер (по желанию)
- Сохранить данные — статус должен показать, что данные заполнены.
- В Meta убедитесь, что webhook подписан на messages.
- Напишите на бизнес-номер с тестового телефона — должен ответить сценарий.
Типы сообщений и ограничения
Доступные типы сообщений
| Тип | Доступно | Примечание |
|---|---|---|
| Текст | Да | |
| Картинка | Да | |
| Видео | Да | |
| Аудио | Да | |
| Голосовое | Да | Уходит как audio в WhatsApp |
| Документ | Да | |
| Стикер | Да | Лучше статичный WebP |
| Геолокация | Да | Координаты |
| Контакт | Да | Нужны имя и телефон |
| Группа медиа | Да | Отдельными сообщениями, не «альбомом» Telegram |
| Опрос | Нет | |
| Счёт Telegram | Нет | Платежи — другими способами |
Кнопки
- Да — через интерактивные сообщения WhatsApp
- До 3 кнопок-ответов под сообщением
- Больше 3 (до 10) — режим списка
- Текст кнопки до 20 символов
- Кнопки-URL здесь не как отдельные CTA Meta: ссылка обычно добавляется текстом
- Медиа + кнопки: сначала медиа, затем отдельное сообщение с кнопками
Дополнительные настройки
| Опция | Доступно |
|---|---|
| Эффект сообщения | Нет |
| Ответ на сообщение | Нет |
| Превью ссылки (переключатель) | Нет |
| Пересылка в другой чат | Нет |
| Форум | Нет |
| Потоковый ИИ | Нет (ответ уходит целиком) |
| Редактирование / удаление | Нет |
Лимиты
| Ограничение | Значение |
|---|---|
| Текст | до 4 096 символов |
| Подпись | до 1 024 |
| Тело интерактивного сообщения | до 1 024 |
| Картинка | ~5 МБ |
| Видео / аудио | ~16 МБ |
| Документ | ~100 МБ |
| Стикер | ~500 КБ, WebP |
Форматирование
Поддерживается разметка в стиле WhatsApp:
- Жирный (
*текст*), курсив (_текст_),зачёркивание(~текст~) - Блоки кода
- Цитаты
- Ссылки
[текст](url)превращаются в текст + URL
Подчёркивание и спойлеры как в Telegram недоступны.
Особенности и примечания
Окно 24 часа. После сообщения клиента свободные ответы сценария доступны примерно сутки. Вне окна WhatsApp разрешает в основном одобренные шаблоны (это не то же самое, что свободный текст из конструктора).
Обычно клиент должен написать первым. Холодная массовая рассылка свободным текстом запрещена правилами WhatsApp.
Это не токен BotFather. Нужны данные Meta Cloud API.
Делайте подписи кнопок короткими (до 20 символов). Длинные клавиатуры из Telegram на WhatsApp упростятся.