Интеграция 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 (на площадке он часто называется WABA).
Старый оператор WhatsApp через Wazzup или Chat API — это другой канал. Выключенный старый WhatsApp в списке не появляется; для официального Cloud API выбирайте оператор канала WhatsApp Cloud API.
В анкете у номера должна стоять галка SMS, номер не в чёрном списке — иначе операторы по телефону в окне Начать чат не показываются.
Права на работу с чатами задаются в настройках сотрудников (раздел прав Менеджер — Чат).
Правила WhatsApp Business:
Первое сообщение клиенту, с которым ещё не переписывались по этому номеру WABA, тоже можно отправить — именно одобренным шаблоном (в списке шаблонов у него отметка WABA / иконка WhatsApp). Свободный текст и обычные заготовки ClubIS без отметки WABA Meta не примет: в чате будет ошибка вроде «Re-engagement message» или «Сообщение не отправлено».
После ответа клиента снова открывается окно свободной переписки (~24 часа).
Подробнее о справочнике и отличии WABA-шаблонов от обычных — Шаблоны сообщений.
В триггерах и авторассылках выберите тип сообщения с WhatsApp и нужный оператор WhatsApp Cloud API.
Период отправки, разрешённое время суток и задержка между сообщениями настраиваются в карточке оператора (как у других мессенджеров).
| Симптом | Что проверить |
|---|---|
| Кнопка Чат в анкете «ничего не делает» | В актуальной версии ClubIS при отсутствии чата открывается Начать чат. Если диалога нет — обновите программу. Убедитесь, что есть активный оператор WhatsApp Cloud API и у телефона стоит галка SMS |
| Не могу написать первым «своим текстом» | Вне 24-часового окна (и при первом касании) нужен шаблон с отметкой WABA, не обычная заготовка ClubIS |
| Ошибка «Re-engagement message» | Отправлен свободный текст или шаблон без WABA вне окна диалога — выберите одобренный WABA-шаблон |
| 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 и базы данных на площадке |