Полная авторизация (для Wazzup Label)

Авторизация позволяет получить доступ к дочернему аккаунту, чтобы подключать каналы, отправлять сообщения и выполнять другие действия от имени клиента.

Используйте этот вариант авторизации, если работаете по Wazzup Label. Клиент зарегистрируется или войдёт в аккаунт Wazzup → подтвердит доступ партнёра к своему аккаунту через iframe/редирект, а вы получите client_access_token и refresh_token клиента, которые позволяют выполнять запросы от его имени.

Шаг 1. Направьте клиента на /v2/oauth/authorize

На первом шаге вы создаёте ссылку, по которой клиенту необходимо залогиниться в Wazzup.

Когда создадите ссылку с заполненными параметрами, направьте клиента по этой ссылке → клиент войдёт в Wazzup → вы получите на ваш redirect_uri код в параметре code, который сможете обменять на пользовательские токены на втором шаге.

Query-параметры:

Мы используем OAuth с расширением PKCE, Поэтому в запросах нужно использовать code_verifier и code_challenge.

code_verifier — это секретная случайная строка, которая:

• сгенерирована вами
• состоит только из английских букв, цифр и символов: -, ., _, ~
• длина: от 43 до 128 символов включительно

Пример: dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk

code_challenge — это защищённое представление code_verifier, которое:

• cоздаётся путём хеширования code_verifier алгоритмом SHA-256
• затем кодируется в Base64URL

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

GET https://tech.wazzup24.com/v2/oauth/authorize
?response_type=code
&client_id=partner_client_id
&redirect_uri=https%3A%2F%2Fyour.website%2Fcallback
&scope=transport%2Ccrm
&state=state_tech_partner_123
&code_challenge=EADnwig85jbEO4pP09-AMi-JnGf7VnO9DS9rvHsq5sY
&code_challenge_method=S256

Когда клиент залогинится в Wazzup по ссылке, Wazzup сделает редирект на ваш redirect_uri с параметрами:
?code=...&state=....

Проверьте, что полученный от нас и переданный вами в запросе state совпадают.

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

Типовые ошибки на шаге 1

Шаг 2. Обменяйте полученный code на пользовательские токены

POST
│
├── grant_type *
│
└── authorize_code_data *
  ├── code *
  ├── redirect_uri *
  ├── client_id *
  └── code_verifier

authorize_code_data (объект)

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

curl -X POST 'https://tech.wazzup24.com/v2/oauth/token' \
-H 'Authorization: Basic base64(email:password)' \
-H 'Content-Type: application/json' \
-d '{
"grant_type": "authorization_code",
"authorize_code_data": {
"code": "AUTH_CODE_FROM_REDIRECT",
"redirect_uri": "https://your.app/callback",
"client_id": "your_client_id",
"code_verifier": "ORIGINAL_CODE_VERIFIER"
}
}'

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

{
"data": {
"access_token": "eyJhbGciOieyJhbGciOieyJhbGciOieyJhbGciOieyJhbGciOieyJhbGciOieyJhbGciOieyJhbGciOi",
"refresh_token": "def50200def50200def50200def50200def50200def50200def50200",
"token_type": "Bearer",
"expires_in": 86400
},
"meta": {
"timestamp": 1759481570
}
}

Результат: у вас есть client_access_token (в ответе указан как access_token) клиента для вызовов API и refresh_token для продления.

Теперь вы можете добавлять каналы, отправлять сообщения и выполнять другие действия.

Все вызовы от лица клиента подписывайте заголовком: Authorization: Bearer <client_access_token>

Типовые ошибки на шаге 2

Что дальше

После авторизации:

• подключайте каналы, 
• подписывайтесь на вебхуки.