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

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

Методы

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

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

Метод POST /v2/marketplaces

Эти параметры будут использованы, когда ваш клиент выберет в маркетплейсе 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

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

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. Пользователя редиректит в CRM → он подтверждает, что хочет подключить интеграцию.

   На этом шаге Wazzup сделает редирект на ваш redirect_uri с параметрами:
   ?code=...&state=...

   Сохраните значение code из адресной строки браузера: нужно скопировать значение "code=" до знака "&state".

   Обменяйте code на пользовательские токены, чтобы отправлять сообщения, получать вебхуки и пользоваться другими методами от лица клиента. Как это сделать, описали в инструкции по OAuth → раздел «Шаг 2. Обменяйте полученный code на токены»

3. Готово — пользователь подключил Wazzup к CRM, а вы получили клиентские токены.

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