База знаний GetMyBot

WhatsApp

Как подключить бизнес-номер 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.

Шаги в интерфейсе:

  1. Откройте Проекты, найдите нужный проект, нажмите Добавить канал и выберите WhatsApp.
  2. Заполните пять полей выше и, при желании, название канала (необязательно).
  3. Нажмите Проверить: GetMyBot проверит реквизиты через Meta.
  4. Нажмите Подключить.

Настройка вебхука в Meta

После подключения у канала появляется Callback URL вида {адрес}/ch/{channelID} (в интерфейсе: иконка вебхука 🔗). Его вместе с вашим Verify token нужно указать в приложении Meta: WhatsApp → Configuration → Webhook.

Как это работает:

  1. Meta отправляет на Callback URL проверочный запрос и сравнивает переданный verify_token с вашим Verify token. При совпадении адрес уведомлений подтверждается.
  2. Дальше Meta шлёт на этот адрес события (входящие сообщения, статусы доставки, вердикты модерации шаблонов).
  3. Каждый входящий запрос подписан заголовком 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. Имя и язык менять нельзя; у одобренных шаблонов категория тоже заблокирована.

Использование шаблона в реакции

Отправка шаблона: это действие реакции:

  1. В конструкторе реакции откройте «Действия» → «Добавить действие» → «Отправить шаблон WhatsApp».
  2. Действие доступно, только если у бота подключён WhatsApp-канал с поддержкой шаблонов.
  3. Выбирается только одобренный (APPROVED) шаблон.
  4. Заполняются параметры: значения переменных {{n}} в теле, текстовый заголовок, медиа-заголовок по ссылке, параметры URL-кнопок. В параметрах можно использовать подстановки-переменные.

Реальный канал отправки определяется каналом события: если событие пришло из WhatsApp, шаблон уйдёт в WhatsApp.

Диалоги и вложения

Оператор может отвечать в WhatsApp-диалоге и отправлять вложения: изображение, видео или документ: с учётом 24-часового окна (вне окна свободная переписка недоступна). Входящие медиа от подписчиков подтягиваются через прокси и отображаются в диалоге.

Тарификация

GetMyBot считает разговоры WhatsApp по категориям marketing, utility, authentication и service. Сейчас этот учёт нужен только для просмотра статистики (record-only): баланс за разговоры не списывается.

Что дальше

  • Каналы: мультиканальность и матрица возможностей.
  • Реакции: основы: как собрать поведение бота.
  • Рассылки: массовая отправка (в WhatsApp: через одобренные шаблоны).