Что это
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 часа написать клиенту можно только шаблоном, одобренным Meta. Шаблоны настраиваются в настройках бота: WhatsApp → Шаблоны сообщений.
- Нажмите Синхронизировать, чтобы загрузить шаблоны из WhatsApp Business Account (нужен WABA ID в настройках подключения), или Создайте шаблон прямо здесь — он уйдёт на проверку в Meta.
- Откройте шаблон и для каждой переменной
{{1}},{{2}}… выберите источник: поле контакта (имя, телефон, город…), поле последнего заказа (номер, сумма, дата доставки, состав…) или фиксированный текст. Укажите значение по умолчанию: Meta не принимает пустые переменные. - Проверьте результат в предпросмотре и тестовой отправкой на свой номер.
В чате WhatsApp нажмите значок Шаблоны WhatsApp в панели ввода: переменные уже заполнены данными клиента, их можно поправить перед отправкой.
Особенности и примечания
Окно 24 часа. Оно отсчитывается от последнего сообщения клиента: каждое его новое сообщение (в том числе ответ на шаблон) открывает окно заново ещё на сутки. Пока окно открыто, можно писать свободным текстом. Когда оно закрыто, чат покажет предупреждение и предложит отправить шаблон. Отправка шаблона окно не открывает.
Обычно клиент должен написать первым. Холодная массовая рассылка свободным текстом запрещена правилами WhatsApp.
Это не токен BotFather. Нужны данные Meta Cloud API.
Делайте подписи кнопок короткими (до 20 символов). Длинные клавиатуры из Telegram на WhatsApp упростятся.