Интеграция
Получение новых сообщений ВКонтакте → Создание клиента в maxma.com
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Получение входящих сообщений сообщества ВКонтакте: подключение аккаунта, выбор группы и подтверждение доступа к сообществу.
- Создание клиента в maxma.com через HTTP POST JSON на /new-client: заголовок X-Processing-Key и поля карточки клиента по документации сервиса лояльности.
Отдельные инструкции: источник «Получение новых сообщений ВКонтакте» · действие «Создание клиента в maxma.com»
Создание подключений
Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.
Подключение ВКонтакте
Создание подключения
- В меню откройте «Подключения» и нажмите «+».
- Выберите тип «ВКонтакте» и нажмите «Выбрать».
- Укажите название подключения и нажмите «Подключить».
Авторизация
- Авторизуйтесь во ВКонтакте под аккаунтом, у которого есть права администратора нужной группы.
- Подтвердите доступ приложения к группам.
- После возврата в кабинет подключение появится в списке.
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «ВКонтакте: Новое сообщение» и нажмите кнопку «Выбрать».
Источник «ВКонтакте: Новое сообщение»
Входящие сообщения сообщества ВКонтакте начнут поступать в обработку после выбора подключения и группы. При первом сохранении подтвердите доступ к группе.
Подключение и группа
- В поле «Подключение» выберите аккаунт ВКонтакте.
- Укажите «Группа ВКонтакте», из которой нужно получать сообщения.
Сохранение и доступ к группе
- Нажмите «Сохранить».
- Если доступ к группе ещё не выдан, подтвердите права сообщества ВКонтакте в окне авторизации.
- После подтверждения вернитесь к обработке - сервер Callback API для события новых сообщений настроится автоматически.
Действие «Создание клиента в maxma.com»
maxma.com регистрирует клиентов через API new-client. Передайте X-Processing-Key и JSON с полями карточки клиента.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
X-Processing-Key
- В кабинете maxma.com скопируйте X-Processing-Key.
Параметры запроса
Действие настраивается через «HTTP-запрос».
- Выберите «HTTP-запрос» и нажмите «Выбрать».
- В поле «HTTP-метод» выберите
POST. - В поле «Адрес» укажите
https://api.maxma.com/new-client. - В «Заголовки» добавьте
X-Processing-KeyиContent-Type: application/json. - В поле «Тело» через «Компоновщик JSON» передайте поля клиента.
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».