WhatsApp

GetMyBot подключает WhatsApp через WhatsApp Cloud API (Meta Graph API). После подключения бот принимает входящие сообщения из WhatsApp и применяет к ним ваши реакции, а операторы могут вести переписку в диалогах. Общий обзор мультиканальности — на странице Каналы.

Подключение WhatsApp-канала

Для подключения нужны пять реквизитов из вашего приложения Meta (WhatsApp Cloud API). Все они обязательны:

  • Phone number ID — идентификатор номера WhatsApp Business.
  • WABA ID — идентификатор WhatsApp Business Account.
  • Access token — токен доступа приложения Meta.
  • Verify token — произвольная строка, которую вы придумываете сами. Она используется при верификации вебхука в Meta (см. ниже).
  • App secret — секрет приложения 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-запрос и сверяет переданный verify_token с вашим Verify token. При совпадении вебхук считается подтверждённым.
  2. Дальше Meta шлёт на этот адрес события (входящие сообщения, статусы доставки, вердикты модерации шаблонов).
  3. Каждый входящий запрос подписан заголовком X-Hub-Signature-256; GetMyBot проверяет подпись с помощью App secret — поэтому этот реквизит и требуется при подключении.

24-часовое сессионное окно

WhatsApp ограничивает инициативную переписку: свободные сообщения можно отправлять пользователю только в течение 24 часов после его последнего входящего сообщения. Каждое новое входящее сообщение от пользователя обновляет окно.

Вне 24-часового окна отправить свободное сообщение нельзя — единственный способ снова написать пользователю (re-engage) — это одобренный шаблон сообщения. Поэтому шаблоны — ключевой инструмент для рассылок и напоминаний в WhatsApp.

Шаблоны сообщений

Шаблон (message template) — заранее согласованное с Meta сообщение, которое можно отправлять вне сессионного окна. Управление шаблонами — в интерфейсе 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 — отдельного шага «отправить на проверку» нет. Вердикт приходит асинхронно (через вебхук), список шаблонов автообновляется. Статусы:

  • 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-разговоров (conversations) по категориям — marketing / utility / authentication / service. В текущей версии это только запись для наблюдаемости (record-only): баланс за разговоры не списывается.

Что дальше

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