Как подключить бизнес-номер WhatsApp, принимать сообщения и использовать одобренные шаблоны для напоминаний. Реквизиты и настройки Meta.
На этой странице
Подключите бизнес-номер WhatsApp, чтобы бот отвечал на сообщения по вашим реакциям, а оператор мог продолжить разговор в кабинете. GetMyBot использует WhatsApp Cloud API, официальный интерфейс обмена сообщениями Meta. Для подключения нужны реквизиты приложения Meta, перечисленные ниже.
У WhatsApp есть ограничение: обычный ответ можно отправить в течение 24 часов после сообщения клиента. Для более позднего напоминания нужен одобренный шаблон. Общий порядок работы нескольких мессенджеров: Каналы.
Подключение WhatsApp-канала
Для подключения понадобятся пять значений из настроек вашего приложения Meta (WhatsApp Cloud API). Все они обязательны:
- Phone number ID: идентификатор номера WhatsApp Business.
- WABA ID: идентификатор WhatsApp Business Account.
- Access token: токен доступа приложения Meta.
- Verify token: произвольная строка, которую вы придумываете сами. Она используется при верификации вебхука в Meta (см. ниже).
- App secret: секрет приложения Meta. По нему GetMyBot проверяет, что уведомление действительно пришло от Meta. Технически проверяется HMAC-подпись в заголовке
X-Hub-Signature-256.
Шаги в интерфейсе:
- Откройте Проекты, найдите нужный проект, нажмите Добавить канал и выберите WhatsApp.
- Заполните пять полей выше и, при желании, название канала (необязательно).
- Нажмите Проверить: GetMyBot проверит реквизиты через Meta.
- Нажмите Подключить.
Настройка вебхука в Meta
После подключения у канала появляется Callback URL вида {адрес}/ch/{channelID} (в интерфейсе: иконка вебхука 🔗). Его вместе с вашим Verify token нужно указать в приложении Meta: WhatsApp → Configuration → Webhook.
Как это работает:
- Meta отправляет на Callback URL проверочный запрос и сравнивает переданный
verify_tokenс вашим Verify token. При совпадении адрес уведомлений подтверждается. - Дальше Meta шлёт на этот адрес события (входящие сообщения, статусы доставки, вердикты модерации шаблонов).
- Каждый входящий запрос подписан заголовком
X-Hub-Signature-256; GetMyBot проверяет подпись с помощью App secret: поэтому этот реквизит и требуется при подключении.
24-часовое сессионное окно
WhatsApp ограничивает инициативную переписку: свободные сообщения можно отправлять пользователю только в течение 24 часов после его последнего входящего сообщения. Каждое новое входящее сообщение от пользователя обновляет окно.
Например, клиент написал в понедельник в 15:00. Обычные ответы разрешены до вторника 15:00, если он не напишет снова. После этого для сообщения нужен одобренный шаблон. Новое входящее сообщение клиента заново открывает 24-часовое окно.
Шаблоны сообщений
Шаблон сообщения (message template) – заранее одобренный Meta текст, который можно отправить после окончания 24-часового окна. Шаблонами можно управлять в GetMyBot.
Где управлять шаблонами
На странице Проекты у WhatsApp-канала нажмите Шаблоны сообщений (иконка 📄), чтобы открыть диалог «Шаблоны WhatsApp-канала». В диалоге есть кнопки:
- «Создать шаблон»: собрать новый шаблон.
- «Синхронизировать»: подтянуть каталог шаблонов из Meta (актуализировать статусы и список).
Категории шаблонов
- MARKETING (Маркетинг): акции, анонсы, рассылки.
- UTILITY (Сервисный): уведомления по действиям пользователя (статусы заказов, напоминания).
- AUTHENTICATION (Аутентификация): коды подтверждения.
Поля шаблона
- Имя: строчные латинские буквы, цифры и
_, до 512 символов. - Язык: локаль Meta.
- Категория: одна из трёх выше.
Для категорий Маркетинг и Сервисный дополнительно:
- Заголовок: нет / текст / изображение / видео / документ. Для медиа-заголовка загружается файл-пример.
- Тело: обязательно, до 1024 символов. Переменные обозначаются
{{1}},{{2}}, … строго по порядку от 1 до N, без пропусков. - Футер: до 60 символов.
- Кнопки: до 10: быстрый ответ, ссылка (до 2), телефон (1), копирование кода (1).
- На каждую переменную
{{n}}нужно задать пример значения: это требование Meta для модерации.
Для категории Аутентификация тело фиксировано самой Meta; настраиваются: срок действия кода (1-90 минут), рекомендация по безопасности и текст кнопки копирования кода.
Модерация
Кнопка «Создать» сразу отправляет шаблон на проверку Meta: отдельного шага для этого нет. Результат проверки приходит позже через уведомление Meta, а список шаблонов обновляется автоматически. Статусы:
- PENDING (На проверке)
- APPROVED (Одобрен)
- REJECTED (Отклонён): с указанием причины
- а также PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.
Редактировать можно шаблоны в статусах APPROVED, REJECTED, PAUSED. Имя и язык менять нельзя; у одобренных шаблонов категория тоже заблокирована.
Использование шаблона в реакции
Отправка шаблона: это действие реакции:
- В конструкторе реакции откройте «Действия» → «Добавить действие» → «Отправить шаблон WhatsApp».
- Действие доступно, только если у бота подключён WhatsApp-канал с поддержкой шаблонов.
- Выбирается только одобренный (APPROVED) шаблон.
- Заполняются параметры: значения переменных
{{n}}в теле, текстовый заголовок, медиа-заголовок по ссылке, параметры URL-кнопок. В параметрах можно использовать подстановки-переменные.
Реальный канал отправки определяется каналом события: если событие пришло из WhatsApp, шаблон уйдёт в WhatsApp.
Диалоги и вложения
Оператор может отвечать в WhatsApp-диалоге и отправлять вложения: изображение, видео или документ: с учётом 24-часового окна (вне окна свободная переписка недоступна). Входящие медиа от подписчиков подтягиваются через прокси и отображаются в диалоге.
Тарификация
GetMyBot считает разговоры WhatsApp по категориям marketing, utility, authentication и service. Сейчас этот учёт нужен только для просмотра статистики (record-only): баланс за разговоры не списывается.
Что дальше
- Каналы: мультиканальность и матрица возможностей.
- Реакции: основы: как собрать поведение бота.
- Рассылки: массовая отправка (в WhatsApp: через одобренные шаблоны).