Создание интеграции в маркетплейсе

Маркетплейс — это каталог CRM, к которым можно подключить Wazzup. Он находится в разделе «Интеграция с CRM» личного кабинета Wazzup и отображается, если у пользователя ещё не подключена интеграция.

В статье описано, как создать, отправить на модерацию и обновить вашу интеграцию в маркетплейсе. Чтобы работать с маркетплейсом, используйте Basic-авторизацию с вашими данными для входа в кабинет партнёра Wazzup: Authorization: Basic base64(email:password)

Методы

POST /v2/marketplaces — создать интеграцию в маркетплейсе
PATCH /v2/marketplaces — обновить интеграцию в маркетплейсе

Создание интеграции

Метод POST /v2/marketplaces

Body-параметр. Обязательные отмечены *	Тип	Описание
`crm_code`*	`string`	Внутренняя идентификация CRM. Строка из латинских букв и цифр, допускаются дефис и нижнее подчёркивание. Уникальна в рамках Wazzup
`auth_redirect_uri`*	`string`	Стартовый URL установки интеграции — адрес на вашей стороне, на который Wazzup перенаправляет клиента по клику «Подключить» в маркетплейсе. Когда получите запрос на этот адрес, запустите сценарий полной авторизации. Это не OAuth redirect_uri — он не обязан совпадать с адресом, зарегистрированным для OAuth. У этих адресов разное назначение.
`secret`*	`string`	Ключ (токен) для подтверждения установки интеграции. Используется только в сервер-сервер запросах, клиенту не отправляется

Эти параметры будут использованы, когда ваш клиент выберет в маркетплейсе Wazzup CRM и нажмет «Подключить». Процесс подключения интеграции описан в конце статьи.

Пример запроса

curl -X POST \
'https://tech.wazzup24.com/v2/marketplaces' \
-H 'Authorization: Basic base64(email:password)'\
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"crm_code": "YouCrmCode123",
"secret": "secret key",
"auth_redirect_uri": "https://example.com/redirect"
}'

Пример ответа

{
"data": null,
"meta": {
"timestamp": 1759492896
}
}

Результат: интеграция создана. Теперь добавьте логотип и имя методом ниже.

Обновление интеграции в маркетплейсе

Метод PATCH /v2/marketplaces

Body-параметр. Обязательные отмечены *	Тип	Описание
`crm_name`*	`string`	Публичное название CRM, которое отображается в ЛК Wazzup. Может содержать буквы, цифры и дефис. Максимальная длина — 50 символов
`logo`*	`object`	Объект с данными логотипа. Требования: прозрачный или белый фон, формат SVG, без внутренних отступов, название компании на английском языке
`logo.name`*	`string`	Название файла с логотипом
`logo.content`*	`string`	base64-кодированный файл с логотипом

Пример запроса

curl -X PATCH \
'https://tech.wazzup24.com/v2/marketplaces' \
-H 'accept: application/json' \
-H 'Authorization: Basic base64(email:password)'\
-H 'Content-Type: application/json' \
-d '{
"crm_name": "The Cool CRM",
"logo": {
"name": "the-cool-crm.svg",
"content": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxAQDQ0NDQ0NDQ8NDw..."
}
}'

Пример ответа

{
"data": null,
"meta": {
"timestamp": 1759492896
}
}

Результат: Интеграция обновлена и отправлена на модерацию.

Как пользователь подключает интеграцию из нашего маркетплейса

1. Пользователь выбирает CRM в маркетплейсе интеграций Wazzup → кликает «Подключить».

2. Wazzup перенаправляет пользователя на ваш auth_redirect_uri стартовый адрес установки на вашей стороне.

3. Вы выполняете шаги полной авторизации.

В параметре scope метода /v2/oauth/authorize обязательно передавайте значение marketplace — оно означает, что авторизация является установкой интеграции.

Готово — пользователь подключил Wazzup к CRM.

После этого CRM загружает информацию о пользователях, сделках, контактах, воронках с этапами и устанавливает URL для вебхуков.