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
1С: УНФ
Arrow
HubSpot
Arrow
Zoho
Arrow
Pipedrive
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
}
}
Параметр ответа. Обязательные отмечены * Тип  Описание 
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 — лимит возвращаемых записей. По умолчанию: 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 Отсутствуют обязательные поля или нарушены ограничения Исправьте запрос