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: через одобренные шаблоны).