Интеграция ClubIS с мессенджером MAX: переписка с клиентами и рассылки через чат-бота MAX.
Канал в ClubIS называется MAX. Для него создаётся отдельный оператор рассылок.
Официальная документация для разработчиков: MAX API.
| Поле в ClubIS | Что указать |
|---|---|
| Токен | Токен чат-бота из кабинета MAX |
| Секрет webhook | Необязательно, но рекомендуется: строка из латинских букв, цифр, - и _ (от 5 символов). Та же строка будет приходить в заголовке запросов от MAX |
| Webhook URL | Базовый адрес площадки по HTTPS, например https://ваш-сайт.ru/. ClubIS сам допишет путь вида max/номер_оператора |
| Период опроса | Альтернатива webhook: ClubIS сам периодически запрашивает новые сообщения у MAX. Для постоянной работы на площадке предпочтителен webhook |
Также в карточке оператора настраиваются период отправки рассылок, разрешённое время суток и при необходимости задержка между сообщениями.
Важно: адрес webhook должен начинаться с https://. Самоподписанные сертификаты MAX не принимает — нужен сертификат доверенного центра (в том числе допускается сертификат Минцифры). HTTP и нестандартные порты не поддерживаются.
Адрес API MAX в ClubIS задан программой автоматически — в настройках оператора его указывать не нужно.
После настройки:
Начать новый диалог: Менеджер → Мессенджеры → Добавить, выберите клиента и оператор MAX. Либо откройте чат из анкеты кнопкой Чат.
Права на работу с чатами задаются в настройках сотрудников (раздел прав Менеджер — Чат).
В рассылках и триггерах выберите нужный оператор MAX.
Период отправки, разрешённое время суток и задержка между сообщениями настраиваются в карточке оператора.
| Симптом | Что проверить |
|---|---|
| Не сохраняется оператор с webhook | Адрес начинается с https://; сертификат сайта доверенный |
| Входящие не появляются в ClubIS | Webhook включён и успешно установлен; web-service доступен из интернета; оператор активен; токен бота верный |
| Исходящие не уходят | Активность оператора; токен; клиент уже писал боту или известен идентификатор чата |
| Нет канала MAX в списке | Обновление ClubIS и базы данных на площадке |