Интеграция WhatsApp Cloud API — это подключение к WhatsApp через официальную платформу Meta (Facebook). Сообщения приходят в ClubIS автоматически, ответы и рассылки уходят с бизнес-номера, зарегистрированного в Meta.
Канал в ClubIS называется WhatsApp Cloud API. Он работает параллельно с другими способами WhatsApp (например, Chat API или Wazzup) — для каждого способа создаётся свой оператор рассылок.
Официальная документация Meta: WhatsApp Cloud API — Get Started.
Ниже — типовой порядок. Точные названия пунктов в кабинете Meta могут немного отличаться.
После первого тестового сообщения из кабинета Meta переходите к настройке webhook и оператора в ClubIS.
| Поле в ClubIS | Что указать |
|---|---|
| Access token | Постоянный токен system user из Meta |
| Phone number ID | Идентификатор номера из API Setup |
| WABA ID | Идентификатор WhatsApp Business Account |
| Verify token | Произвольная строка — ту же нужно будет ввести в Meta при настройке webhook |
| App secret | Секрет приложения Meta (рекомендуется) |
| Версия Graph API | Обычно v23.0 — как в документации Meta |
| Webhook URL | Подставляется автоматически из внешнего URL площадки; в Meta указывается адрес с окончанием whatsapp-cloud/ |
На вкладке Доступ назначьте сотрудников, которым разрешено пользоваться этим оператором.
Webhook нужен, чтобы входящие сообщения и статусы доставки попадали в ClubIS.
whatsapp-cloud/ (полный адрес показывается в настройках оператора ClubIS после сохранения);Важно: адрес webhook должен быть доступен Meta из интернета по HTTPS. Если проверка не проходит — проверьте доступность web-service, внешний URL в параметрах ClubIS и совпадение verify token.
На одном приложении Meta — один Callback URL. Если на площадке несколько операторов WhatsApp Cloud API с разными номерами, ClubIS определяет нужный оператор по идентификатору номера из входящего сообщения.
После настройки:
Начать новый диалог: Менеджер → Мессенджеры → Добавить, выберите клиента и оператор WhatsApp Cloud API. Либо откройте чат из анкеты кнопкой Чат.
Права на работу с чатами задаются в настройках сотрудников (раздел прав Менеджер — Чат).
Правила WhatsApp Business:
В триггерах и авторассылках выберите тип сообщения с WhatsApp и нужный оператор WhatsApp Cloud API.
Период отправки, разрешённое время суток и задержка между сообщениями настраиваются в карточке оператора (как у других мессенджеров).
| Симптом | Что проверить |
|---|---|
| Webhook не проходит проверку в Meta | Совпадение Verify token; доступность web-service из интернета; корректный внешний URL площадки |
| «Проверить подключение» выдаёт ошибку | Access token, Phone number ID; срок действия и права токена в Meta |
| Входящие не попадают в ClubIS | Подписка на поле messages в Meta; активность оператора; совпадение Phone number ID |
| Исходящие не уходят | Активность оператора; 24-часовое окно (для текста без шаблона); номер клиента в международном формате |
| Шаблоны не загружаются | WABA ID; одобренные шаблоны в Meta Business Manager |
| Канала WhatsApp Cloud API нет в списке | Обновление ClubIS и базы данных на площадке |