Аккаунт клиента (дочерний аккаунт, дочка) необходим, чтобы подключать мессенджеры, отправлять и получать сообщения, работать с CRM и другими инструментами Wazzup.
Чтобы управлять дочерними аккаунтами, используйте Basic-авторизацию с вашими данными для входа в кабинет партнёра Wazzup: Authorization: Basic base64(email:password)
Метод для партнёров White Label: используйте, чтобы самостоятельно создать дочерний аккаунт клиента. После вы получите account_id клиента, который нужен для получения пользовательских токенов.
Метод POST /v2/accounts
| Параметр запроса. Обязательные отмечены * | Тип | Описание |
name* |
string |
Название аккаунта. Минимум 3 символа |
lang* |
string |
Язык аккаунта: en, es, pt, ru |
currency* |
string |
Валюта аккаунта: RUR, EUR, USD, KZT |
country* |
string |
Страна аккаунта: RU, US, EU, KZ |
timezone* |
number |
Часовой пояс аккаунта. Минимум -12, максимум 14. Например, для московского часового пояса укажите 3 |
Пример запроса:
curl -L 'https://tech.wazzup24.com/v2/accounts'
-H 'Authorization: Basic base64(email:password)'
-H 'Content-Type: application/json'
-d '{
"name": "Demo Client",
"lang": "ru",
"currency": "RUR",
"country": "RU",
"timezone": 13
}'
Пример ответа:
{
"data": {
"account": {
"account_id": 12345678,
"name": "Demo Client"
}
},
"meta": {
"timestamp": 1763026882
}
}
Результат: создан дочерний аккаунт. Сохраните его account_id. Далее получите клиентские токены, чтобы добавлять каналы, отправлять сообщения и пользоваться другими методами от имени клиента.
Метод помогает узнать о каналах и оплатах дочернего аккаунта.
Метод GET /v2/accounts/{account_id}
Path-параметрыaccount_id — ID дочернего аккаунта в формате, состоит из 8 цифр.
Query-параметры
Укажите expand со значениями:
billing, чтобы узнать, кто оплачивал сервис в последний раз: партнёр или клиент;channels, чтобы получить информацию о каналах аккаунта;subscriptions, чтобы получить информацию о подписках аккаунта.Пример запроса
curl -L 'https://tech.wazzup24.com/v2/accounts/12345678?expand=billing,channels,subscriptions' -H 'Authorization: Basic base64(email:password)'
Пример ответа
{
"data": {
"id": 12345678,
"registered_at": "01.01.2022",
"assigned_at": "01.01.2022",
"billing": {
"last_payment": "client"
},
"channels": [
{
"id": "5a3a14e-2ea3-4fdd-953e-caf12609fb",
"name": "79528462093",
"transport": "tgapi",
"subscription_id": "16fdb3-998d-4948-888c-672233e6be"
}
],
"subscriptions": {
"id": "16fdb3-998d-4948-888c-6729c2e6be",
"expired_at": "01.01.2022",
"has_auto_renewal": true,
"tariff": "max"
}
},
"meta": {
"timestamp": 1762372398
}
}
| Параметр ответа. Обязательные отмечены * | Тип | Описание |
data* |
object |
Данные дочернего аккаунта |
data.id* |
number |
ID аккаунта |
data.registered_at* |
string |
Дата регистрации |
data.assigned_at* |
string |
Дата закрепления клиента за партнером |
data.billing |
object |
Информация о биллинге |
data.billing.last_payment* |
string |
Кто проводил последнюю оплату: client, partner |
data.channels |
array(object) |
Список каналов дочернего аккаунта |
data.channels.id* |
string |
ID канала |
data.channels.name* |
string |
Название канала |
data.channels.transport* |
string |
Тип транспорта канала: instagram, telegram для Telegram Bot, tgapi для Telegram, vk, wapi для WABA, whatsapp, viber, max, avito |
data.channels.subscription_id* |
string |
ID подписки |
data.subscriptions |
object |
Список подписок дочернего аккаунта |
data.subscriptions.id* |
string |
ID подписки |
data.subscriptions.expired_at* |
string |
Дата истечения подписки |
data.subscriptions.has_auto_renewal* |
boolean |
Наличие автопродления |
data.subscriptions.tariff* |
string |
Тариф подписки: start, inbox, pro, max, waba, free |
meta* |
object |
Метаданные ответа |
meta.timestamp* |
number |
Дата ответа |
Результат Информация об account_id, который вы ранее создали.
Метод GET /v2/accounts
Query-параметры
Укажите expand со значениями:
billing, чтобы узнать, кто оплачивал сервис в последний раз: партнёр или клиент;channels, чтобы получить информацию о каналах аккаунта;subscriptions, чтобы получить информацию о подписках аккаунта.limit — лимит возвращаемых записей. По умолчанию: 50offset — смещение по пагинации. По умолчанию: 0
Пример запроса без дополнительных query-параметров:
curl -L 'https://tech.wazzup24.com/v2/accounts' -H 'Authorization: Basic base64(email:password)'
Пример ответа:
{
"data": [
{
"id": 12345678,
"registered_at": "2025-11-06T09:32:09.760Z",
"assigned_at": "2025-11-06T09:32:09.760Z"
},
{
"id": 11111111,
"registered_at": "2025-11-06T09:35:12.765Z",
"assigned_at": "2025-11-06T09:35:12.765Z"
},
{
"id": 22222222,
"registered_at": "2025-11-12T10:08:25.814Z",
"assigned_at": "2025-11-12T10:08:25.814Z"
}
],
"meta": {
"timestamp": 1763031150
}
}
Результат: В массиве придёт список дочерних аккаунтов, связанных с вашим партнёрским аккаунтом.
Метод PATCH /v2/accounts/{account_id}
Path-параметрыaccount_id — ID аккаунта.
Параметры запроса
Сейчас с помощью метода можно изменить только часовой пояс, поэтому в параметрах передавайте только timezone с новым значением.
Если передать другие параметры, то информация по ним не обновится в аккаунте, ошибка в ответ не вернётся.
Пример
curl -L -X PATCH 'https://tech.wazzup24.com/v2/accounts/12345678'
-H 'Authorization: Basic base64(email:password)'
-H 'Content-Type: application/json'
-d '{
"timezone": 3
}'
Пример ответа
{
"data": {
"account_id": 12345678,
"timezone": 3,
"currency": "RUR",
"email": "[email protected]",
"lang": "en",
"name": "Demo Client LTD",
"type": "CHILD_POSTPAY"
},
"meta": {
"timestamp": 1762372398
}
}
Результат Часовой пояс аккаунта обновлен.
| HTTP | error | Когда возникает | Что делать |
| 400 | BAD_REQUEST |
Неверные поля: язык, валюта, часовой пояс или другие | Проверьте значения и формат |
| 401 | UNAUTHORIZED |
Ошибка авторизации | Проверьте, что в заголовке передан верный токен |
| 403 | FORBIDDEN |
Партнёр не владеет указанным account_id |
Проверьте указанный account_id — он должен относиться к вам |
| 404 | NOT_FOUND |
Аккаунт не найден | Проверьте account_id |
| 422 | VALIDATION_FAILED |
Отсутствуют обязательные поля или нарушены ограничения | Исправьте запрос |