Arrow
Начало работы с Wazzup
Arrow
Как подключить мессенджер
Arrow
Как пользоваться чатами Wazzup
Arrow
Как оплатить
Arrow
Битрикс24
Arrow
Как подключить Wazzup
Arrow
Как переписываться
Arrow
Как настроить автоматизацию
Arrow
Сквозная аналитика
Arrow
Решение проблем
Arrow
amoCRM
Arrow
Как подключить Wazzup
Arrow
Как переписываться
Arrow
Как настроить автоматизацию
Arrow
Сквозная аналитика
Arrow
Решение проблем
Arrow
Другие CRM
Arrow
Как продавать еще удобнее
Arrow
Всё о WABA
Arrow
Для партнеров
Arrow
Пользовательское API
Для партнеров
Arrow

Аккаунты клиентов

Аккаунт клиента (дочерний аккаунт, дочка) необходим, чтобы подключать мессенджеры, отправлять и получать сообщения, работать с 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
}
}
response
│
├── data *
│ ├── id *
│ ├── registered_at *
│ ├── assigned_at *
│ ├── billing
│ │ └── last_payment *
│ │
│ ├── channels[]
│ │ ├── id *
│ │ ├── name *
│ │ ├── transport *
│ │ └── subscription_id *
│ │
│ └── subscriptions
│   ├── id *
│   ├── expired_at *
│   ├── has_auto_renewal *
│   └── tariff *
│
└── meta *
  └── timestamp *
Параметр ответа.
Обязательные отмечены *
Тип Описание
data* object data Данные дочернего аккаунта
meta* object meta Метаданные ответа

data (объект)

Параметр.
Обязательные отмечены *
Тип Описание
id* number ID аккаунта
registered_at* string Дата регистрации
assigned_at* string Дата закрепления клиента за партнером
billing object billing Информация о биллинге
channels array(object) channels Список каналов дочернего аккаунта
subscriptions object subscriptions Список подписок дочернего аккаунта

billing (объект)

Параметр.
Обязательные отмечены *
Тип Описание
last_payment* string Кто проводил последнюю оплату: client, partner

channels (объект)

Параметр.
Обязательные отмечены *
Тип Описание
id* string ID канала
name* string Название канала
transport* string Тип транспорта канала: instagram, telegram для Telegram Bot, tgapi для Telegram, vk, wapi для WABA, whatsapp, viber, max, avito
subscription_id* string ID подписки

subscriptions (объект)

Параметр.
Обязательные отмечены *
Тип Описание
id* string ID подписки
expired_at* string Дата истечения подписки
has_auto_renewal* boolean Наличие автопродления
tariff* string Тариф подписки: start, inbox, pro, max, waba, free

meta (объект)

Параметр.
Обязательные отмечены *
Тип Описание
timestamp* number Дата ответа

Результат Информация об account_id, который вы ранее создали.

Список дочерних аккаунтов партнёра

Метод GET /v2/accounts

Query-параметры
Укажите expand со значениями:

  • billing, чтобы узнать, кто оплачивал сервис в последний раз: партнёр или клиент;
  • channels, чтобы получить информацию о каналах аккаунта;
  • subscriptions, чтобы получить информацию о подписках аккаунта.

limit — лимит возвращаемых записей. По умолчанию: 50
offset — смещение по пагинации. По умолчанию: 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 Отсутствуют обязательные поля или нарушены ограничения Исправьте запрос