Справочник ошибок

При создании аккаунта этот способ требует provider_data.phone.

Действия и повторы: Исправьте параметры с учётом операции и канала. Повтор неизменённого неверного запроса не устранит ошибку.

{
  "request_id": "req_example",
  "error": {
    "code": "auth_mode_phone_required",
    "numeric_code": "20019",
    "message": "Phone number is required for this auth mode"
  }
}

Операция отклонена. Проверьте запрос и сохраните request_id.

Действия и повторы: Перед повторным созданием проверьте список или состояние ресурсов: возможно, первая попытка уже сработала. Устраните причину и сохраните request_id; не создавайте дубликаты автоматически.

{
  "request_id": "req_example",
  "error": {
    "code": "create_api_key_failed",
    "numeric_code": "11101",
    "message": "Failed to create API key"
  }
}

type должен быть user, group или channel.

Действия и повторы: Исправьте параметры с учётом операции и канала. Повтор неизменённого неверного запроса не устранит ошибку.

{
  "request_id": "req_example",
  "error": {
    "code": "invalid_conversation_type",
    "numeric_code": "37000",
    "message": "Field 'type' must be one of: user, group, channel"
  }
}

Проверьте идентификатор канала в URL.

Действия и повторы: Исправьте параметры с учётом операции и канала. Повтор неизменённого неверного запроса не устранит ошибку.

{
  "request_id": "req_example",
  "error": {
    "code": "invalid_provider",
    "numeric_code": "30000",
    "message": "Invalid provider parameter"
  }
}

Токен цитирования не читается. Передайте data.message.reply_token входящего события без изменений.

Действия и повторы: Исправьте параметры с учётом операции и канала. Повтор неизменённого неверного запроса не устранит ошибку.

{
  "request_id": "req_example",
  "error": {
    "code": "invalid_reply_token",
    "numeric_code": "36006",
    "message": "Invalid or unreadable reply_token"
  }
}

Проверьте JSON и обязательные поля.

Действия и повторы: Исправьте параметры с учётом операции и канала. Повтор неизменённого неверного запроса не устранит ошибку.

{
  "request_id": "req_example",
  "error": {
    "code": "invalid_request",
    "numeric_code": "10000",
    "message": "Invalid request parameters"
  }
}

Целевое рабочее пространство в заголовке переопределения пусто или задано неверно. Удалите этот заголовок и используйте API-ключ нужного пространства.

Действия и повторы: Исправьте параметры с учётом операции и канала. Повтор неизменённого неверного запроса не устранит ошибку.

{
  "request_id": "req_example",
  "error": {
    "code": "invalid_target_workspace",
    "numeric_code": "11003",
    "message": "Invalid target workspace"
  }
}

Проверьте поля и форматы, специфичные для канала.

Действия и повторы: Исправьте параметры с учётом операции и канала. Повтор неизменённого неверного запроса не устранит ошибку.

{
  "request_id": "req_example",
  "error": {
    "code": "provider_invalid_request",
    "numeric_code": "30001",
    "message": "Provider rejected the request"
  }
}

Операция отклонена. Проверьте запрос и сохраните request_id.

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

{
  "request_id": "req_example",
  "error": {
    "code": "rotate_api_key_failed",
    "numeric_code": "11103",
    "message": "Failed to rotate API key"
  }
}

Действие аккаунта не распознано; используйте документированное действие.

Действия и повторы: Выберите поддерживаемые канал и действие. Повтор запроса не добавит возможностей и не откроет доступ к бета-функциям.

{
  "request_id": "req_example",
  "error": {
    "code": "unsupported_action",
    "numeric_code": "30005",
    "message": "Action not supported"
  }
}

Канал не поддерживает операцию; выберите доступную в таблице возможностей.

Действия и повторы: Выберите поддерживаемые канал и действие. Повтор запроса не добавит возможностей и не откроет доступ к бета-функциям.

{
  "request_id": "req_example",
  "error": {
    "code": "unsupported_conversation_type",
    "numeric_code": "37001",
    "message": "Operation not supported for this conversation type"
  }
}

Используйте поддерживаемый каналом message.type.

Действия и повторы: Выберите поддерживаемые канал и действие. Повтор запроса не добавит возможностей и не откроет доступ к бета-функциям.

{
  "request_id": "req_example",
  "error": {
    "code": "unsupported_message_type",
    "numeric_code": "36000",
    "message": "Message type not supported"
  }
}

Используйте поддерживаемый каналом auth_mode.

Действия и повторы: Выберите поддерживаемые канал и действие. Повтор запроса не добавит возможностей и не откроет доступ к бета-функциям.

{
  "request_id": "req_example",
  "error": {
    "code": "unsupported_provider_auth_mode",
    "numeric_code": "20018",
    "message": "Auth mode not supported by this provider"
  }
}

Операция отклонена. Проверьте запрос и сохраните request_id.

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

{
  "request_id": "req_example",
  "error": {
    "code": "update_api_key_failed",
    "numeric_code": "11102",
    "message": "Failed to update API key"
  }
}

Операция отклонена. Проверьте запрос и сохраните request_id.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "update_workspace_failed",
    "numeric_code": "41001",
    "message": "Failed to update workspace"
  }
}

Проверьте параметры создания с баланса и необязательный заголовок Idempotency-Key.

Действия и повторы: Исправьте параметры с учётом операции и канала. Повтор неизменённого неверного запроса не устранит ошибку.

{
  "request_id": "req_example",
  "error": {
    "code": "wallet_invalid_request",
    "numeric_code": "20021",
    "message": "Invalid wallet account request"
  }
}

Проверьте правильность и активность ключа API.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "invalid_api_key",
    "numeric_code": "11001",
    "message": "Invalid API key"
  }
}

Добавьте заголовок X-Api-Key.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "missing_api_key",
    "numeric_code": "11000",
    "message": "Missing X-Api-Key header"
  }
}

Для API звонков и явной подписки на события нужен доступ рабочего пространства к закрытому тестированию.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "beta_feature_not_enabled",
    "numeric_code": "41002",
    "message": "Beta feature not enabled"
  }
}

Источник, метод или заголовки CORS не разрешены. Проверьте среду вызова.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "cors_forbidden",
    "numeric_code": "11009",
    "message": "CORS preflight request is not allowed"
  }
}

Публикации и комментарии

Проверьте аккаунт и только те идентификаторы цели, которые требует этот API. post_not_found подтверждает отсутствие публикации. comment_not_found означает, что целевой комментарий верхнего уровня не найден после проверки, а не что проверены все ответы. post_inaccessible означает недоступность, но не доказывает отсутствие и не указывает причину. Сохраните ошибку и выясните результат перед выбором следующего действия.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "post_inaccessible",
    "numeric_code": "39005",
    "message": "Post is not accessible"
  }
}

Запрос пытается переопределить рабочее пространство без необходимых прав. Удалите заголовок переопределения и используйте API-ключ нужного рабочего пространства.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "workspace_override_forbidden",
    "numeric_code": "11002",
    "message": "Workspace override is not allowed"
  }
}

Проверьте account_id и используйте X-Api-Key рабочего пространства владельца аккаунта. Текущий ключ не даёт доступа к аккаунту, которого нет в этом пространстве.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "account_not_found",
    "numeric_code": "20020",
    "message": "Account not found"
  }
}

Операция отсутствует или относится к другому пространству. Проверьте исходный operation_id и область API Key.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "account_operation_not_found",
    "numeric_code": "20029",
    "message": "Account operation not found"
  }
}

Звонки

Звонок не найден в этом аккаунте и рабочем пространстве.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "call_not_found",
    "numeric_code": "38003",
    "message": "Call not found"
  }
}

Публикации и комментарии

Проверьте аккаунт и только те идентификаторы цели, которые требует этот API. post_not_found подтверждает отсутствие публикации. comment_not_found означает, что целевой комментарий верхнего уровня не найден после проверки, а не что проверены все ответы. post_inaccessible означает недоступность, но не доказывает отсутствие и не указывает причину. Сохраните ошибку и выясните результат перед выбором следующего действия.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "comment_not_found",
    "numeric_code": "39001",
    "message": "Comment not found"
  }
}

Контакт не найден для этого аккаунта; проверьте идентификатор.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "contact_not_found",
    "numeric_code": "35000",
    "message": "Contact not found"
  }
}

Канал не нашёл беседу. Проверьте идентификатор и аккаунт.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "conversation_not_found",
    "numeric_code": "37002",
    "message": "Conversation not found"
  }
}

Группа не найдена для этого аккаунта; проверьте ID группы.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "group_not_found",
    "numeric_code": "34004",
    "message": "Group not found"
  }
}

Проверьте путь API и HTTP-метод.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "not_found",
    "numeric_code": "10001",
    "message": "Endpoint not found"
  }
}

Публикации и комментарии

Проверьте аккаунт и только те идентификаторы цели, которые требует этот API. post_not_found подтверждает отсутствие публикации. comment_not_found означает, что целевой комментарий верхнего уровня не найден после проверки, а не что проверены все ответы. post_inaccessible означает недоступность, но не доказывает отсутствие и не указывает причину. Сохраните ошибку и выясните результат перед выбором следующего действия.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "post_not_found",
    "numeric_code": "39000",
    "message": "Post not found"
  }
}

Переопределённое рабочее пространство не найдено или недоступно. Проверьте его принадлежность, удалите заголовок переопределения и используйте нужный API-ключ; повторы не дадут доступ.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "target_workspace_not_found",
    "numeric_code": "11004",
    "message": "Target workspace not found"
  }
}

Распределение аккаунта занято; повторите позже.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "account_allocation_busy",
    "numeric_code": "20011",
    "message": "Allocation is busy in the current region; please retry later"
  }
}

Аккаунт уже авторизован, повторная авторизация этим действием отклонена. Обновите состояние и используйте завершённый результат; не зацикливайте авторизацию или отмену.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "account_already_authorized",
    "numeric_code": "20016",
    "message": "Account is already authorized; re-authentication is not required"
  }
}

Нет активной привязки к подключению канала; проверьте состояние аккаунта.

Действия и повторы: Проверьте авторизацию и runtime-статус, затем выберите refresh, start или reconnect с учётом нужного состояния и возможностей канала. Сбой соединения сам по себе не означает выход из аккаунта. Перед зависимыми операциями подтвердите running.

{
  "request_id": "req_example",
  "error": {
    "code": "account_binding_not_found",
    "numeric_code": "30006",
    "message": "Account is not bound to an available server"
  }
}

Webhook-эндпоинты

Запросите отдельные endpoint аккаунта с account_id и обновите существующий active. Для переключения сначала отключите прежний active, затем включите другой. Не повторяйте создание или повторное включение автоматически.

Действия и повторы: Перед повторной отправкой прочитайте настройки эндпоинта и его привязку к аккаунту. PATCH заменяет настройки: сохраните нужные подписки, подпись и политику повторов. При конфликте active обновите существующий эндпоинт либо деактивируйте его перед включением другого.

{
  "request_id": "req_example",
  "error": {
    "code": "account_webhook_already_exists",
    "numeric_code": "40008",
    "message": "Account already has an active webhook endpoint"
  }
}

Цена или база расчёта изменились. Проверьте исходный результат, затем запросите новую цену.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "billing_quote_changed",
    "numeric_code": "20027",
    "message": "Pricing changed; request a new quote"
  }
}

Предложение истекло. Перед новым предложением проверьте прежний результат создания.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "billing_quote_expired",
    "numeric_code": "20026",
    "message": "Billing quote expired"
  }
}

Предложение не соответствует пространству или запросу. Проверьте исходный результат, затем запросите подходящее.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "billing_quote_invalid",
    "numeric_code": "20025",
    "message": "Billing quote does not match this request"
  }
}

Звонки

У аккаунта уже есть активный управляемый звонок. Проверьте известный звонок и цель действия; эта ошибка сама по себе не требует завершать звонок или постоянно повторять тот же неудачный запрос.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "call_already_active",
    "numeric_code": "38000",
    "message": "Account already has an active call"
  }
}

Эта учётная запись канала уже привязана к другому аккаунту пространства.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "duplicate_provider_account",
    "numeric_code": "20015",
    "message": "A provider account with the same identity already exists in this workspace"
  }
}

В регионе нет свободной ёмкости; запросите доступные регионы.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "no_allocatable_server",
    "numeric_code": "20013",
    "message": "No allocatable server in the current region"
  }
}

Идентификатор канала в запросе не совпадает с привязкой аккаунта.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "provider_account_mismatch",
    "numeric_code": "20017",
    "message": "Authenticated provider account does not match the bound account; re-scan with the original account"
  }
}

Подключение не готово. Перед повтором проверьте авторизацию и runtime_status.

Действия и повторы: Проверьте авторизацию и runtime-статус, затем выберите refresh, start или reconnect с учётом нужного состояния и возможностей канала. Сбой соединения сам по себе не означает выход из аккаунта. Перед зависимыми операциями подтвердите running.

{
  "request_id": "req_example",
  "error": {
    "code": "provider_not_ready",
    "numeric_code": "30009",
    "message": "Provider client is not ready"
  }
}

В этом пространстве уже создаётся аккаунт с баланса. Дождитесь завершения и повторите запрос.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "wallet_account_creation_in_progress",
    "numeric_code": "20030",
    "message": "Account creation is in progress; please wait"
  }
}

Ключ идемпотентности связан с другими параметрами. Сначала проверьте исходную операцию.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "wallet_idempotency_conflict",
    "numeric_code": "20024",
    "message": "Idempotency key was used for a different request"
  }
}

Баланса недостаточно. Владелец может пополнить кошелёк и проверить исходный запрос.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "wallet_insufficient_funds",
    "numeric_code": "20023",
    "message": "Insufficient wallet balance"
  }
}

Новые покупки с баланса отключены; существующие операции не считаются отменёнными.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "wallet_workspace_disabled",
    "numeric_code": "20022",
    "message": "New wallet purchases are disabled"
  }
}

Достигнут лимит аккаунтов для сообщений; проверьте квоту и использование.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "workspace_account_quota_exceeded",
    "numeric_code": "20014",
    "message": "Workspace account quota exceeded"
  }
}

GET /contacts/info вернул Conversation not found. Проверьте идентификатор цели и аккаунт запроса.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

{
  "request_id": "req_example",
  "error": {
    "code": "contact_not_found",
    "numeric_code": "35000",
    "message": "Conversation not found"
  }
}

Заблокировать контакт: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "block_contact_failed",
    "numeric_code": "35005",
    "message": "Failed to block contact"
  }
}

Звонки

Не удалось получить состояние звонка или завершить его. Проверьте текущую операцию и состояние звонка.

Действия и повторы: Перед созданием или завершением звонка запросите управляемый звонок и его call_id/state. preparing не означает набор номера или ответ; ended и failed — конечные состояния. Сам по себе failed не требует повторного завершения.

{
  "request_id": "req_example",
  "error": {
    "code": "call_control_failed",
    "numeric_code": "38004",
    "message": "Failed to control call"
  }
}

Создать аккаунт: создание ресурса завершилось ошибкой или его результат не подтверждён.

Действия и повторы: Перед повторным созданием проверьте список или состояние ресурсов: возможно, первая попытка уже сработала. Устраните причину и сохраните request_id; не создавайте дубликаты автоматически.

{
  "request_id": "req_example",
  "error": {
    "code": "create_account_failed",
    "numeric_code": "20002",
    "message": "Failed to create account"
  }
}

Звонки

Создать звонок: создание ресурса завершилось ошибкой или его результат не подтверждён.

Действия и повторы: Перед повторным созданием проверьте список или состояние ресурсов: возможно, первая попытка уже сработала. Устраните причину и сохраните request_id; не создавайте дубликаты автоматически.

{
  "request_id": "req_example",
  "error": {
    "code": "create_call_failed",
    "numeric_code": "38002",
    "message": "Failed to create call"
  }
}

Добавить контакт: создание ресурса завершилось ошибкой или его результат не подтверждён.

Действия и повторы: Перед повторным созданием проверьте список или состояние ресурсов: возможно, первая попытка уже сработала. Устраните причину и сохраните request_id; не создавайте дубликаты автоматически.

{
  "request_id": "req_example",
  "error": {
    "code": "create_contact_failed",
    "numeric_code": "35003",
    "message": "Failed to create contact"
  }
}

Создание группы: создание ресурса завершилось ошибкой или его результат не подтверждён.

Действия и повторы: Перед повторным созданием проверьте список или состояние ресурсов: возможно, первая попытка уже сработала. Устраните причину и сохраните request_id; не создавайте дубликаты автоматически.

{
  "request_id": "req_example",
  "error": {
    "code": "create_group_failed",
    "numeric_code": "34002",
    "message": "Failed to create group"
  }
}

Создать Webhook-эндпоинт: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторной отправкой прочитайте настройки эндпоинта и его привязку к аккаунту. PATCH заменяет настройки: сохраните нужные подписки, подпись и политику повторов. При конфликте active обновите существующий эндпоинт либо деактивируйте его перед включением другого.

{
  "request_id": "req_example",
  "error": {
    "code": "create_webhook_endpoint_failed",
    "numeric_code": "40001",
    "message": "Failed to create webhook endpoint"
  }
}

Деактивировать Webhook-эндпоинт: остановка или деактивация не подтверждена; при восстановлении учитывайте намерение остановить ресурс.

Действия и повторы: Проверьте, вступила ли в силу остановка или деактивация. Не запускайте и не переподключайте ресурс, который хотели остановить.

{
  "request_id": "req_example",
  "error": {
    "code": "deactivate_webhook_endpoint_failed",
    "numeric_code": "40004",
    "message": "Failed to deactivate webhook endpoint"
  }
}

Удалить аккаунт: результат удаления не подтверждён.

Действия и повторы: Проверьте, не удалён ли ресурс уже, и затем решайте, нужен ли повтор. Сохраните request_id и обрабатывайте успешный ответ согласно документации этого эндпоинта.

{
  "request_id": "req_example",
  "error": {
    "code": "delete_account_failed",
    "numeric_code": "20004",
    "message": "Failed to delete account"
  }
}

Удалить метку: результат удаления не подтверждён.

Действия и повторы: Проверьте, не удалён ли ресурс уже, и затем решайте, нужен ли повтор. Сохраните request_id и обрабатывайте успешный ответ согласно документации этого эндпоинта.

{
  "request_id": "req_example",
  "error": {
    "code": "delete_label_failed",
    "numeric_code": "37014",
    "message": "Failed to delete label"
  }
}

Удалить Webhook-эндпоинт: результат удаления не подтверждён.

Действия и повторы: Проверьте, не удалён ли ресурс уже, и затем решайте, нужен ли повтор. Сохраните request_id и обрабатывайте успешный ответ согласно документации этого эндпоинта.

{
  "request_id": "req_example",
  "error": {
    "code": "delete_webhook_endpoint_failed",
    "numeric_code": "40005",
    "message": "Failed to delete webhook endpoint"
  }
}

Редактировать сообщение: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "edit_message_failed",
    "numeric_code": "36005",
    "message": "Failed to edit message"
  }
}

Получить аккаунт: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_account_failed",
    "numeric_code": "20001",
    "message": "Failed to get account"
  }
}

Состояние аутентификации: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_auth_state_failed",
    "numeric_code": "20006",
    "message": "Failed to get account auth state"
  }
}

Получить контакт: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_contact_failed",
    "numeric_code": "35002",
    "message": "Failed to get contact"
  }
}

Проверить наличие контакта: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_contact_membership_failed",
    "numeric_code": "35004",
    "message": "Failed to get contact membership"
  }
}

Детали беседы: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_conversation_failed",
    "numeric_code": "37004",
    "message": "Failed to get conversation"
  }
}

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

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_group_failed",
    "numeric_code": "34001",
    "message": "Failed to get group"
  }
}

Пригласительная ссылка группы: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_group_invite_code_failed",
    "numeric_code": "34010",
    "message": "Failed to get group invite code"
  }
}

Чтение текущей сессии аккаунта: сервис не смог загрузить сессию.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_session_failed",
    "numeric_code": "20005",
    "message": "Failed to get account session"
  }
}

Получить Webhook-эндпоинт: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_webhook_endpoint_failed",
    "numeric_code": "40002",
    "message": "Failed to get webhook endpoint"
  }
}

Получить текущий workspace: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_workspace_failed",
    "numeric_code": "41000",
    "message": "Failed to get workspace"
  }
}

Выход из группы: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "leave_group_failed",
    "numeric_code": "34003",
    "message": "Failed to leave group"
  }
}

Список аккаунтов: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_accounts_failed",
    "numeric_code": "20000",
    "message": "Failed to list accounts"
  }
}

Список API-ключей: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_api_keys_failed",
    "numeric_code": "11100",
    "message": "Failed to list API keys"
  }
}

Получить чёрный список: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_blocklist_failed",
    "numeric_code": "35007",
    "message": "Failed to list blocklist"
  }
}

Список контактов: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_contacts_failed",
    "numeric_code": "35001",
    "message": "Failed to list contacts"
  }
}

Список меток бесед: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_conversation_labels_failed",
    "numeric_code": "37012",
    "message": "Failed to list conversation labels"
  }
}

Список участников: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_conversation_members_failed",
    "numeric_code": "37005",
    "message": "Failed to list conversation members"
  }
}

Список бесед: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_conversations_failed",
    "numeric_code": "37003",
    "message": "Failed to list conversations"
  }
}

Заявки на вступление в группу: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_group_join_requests_failed",
    "numeric_code": "34007",
    "message": "Failed to list group join requests"
  }
}

Список групп: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_groups_failed",
    "numeric_code": "34000",
    "message": "Failed to list groups"
  }
}

Список регионов провайдера: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_provider_regions_failed",
    "numeric_code": "30011",
    "message": "Failed to list provider regions"
  }
}

Список Webhook-эндпоинтов: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_webhook_endpoints_failed",
    "numeric_code": "40000",
    "message": "Failed to list webhook endpoints"
  }
}

Отметка беседы прочитанной: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "mark_conversation_read_failed",
    "numeric_code": "37006",
    "message": "Failed to mark conversation as read"
  }
}

Отметка беседы непрочитанной: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "mark_conversation_unread_failed",
    "numeric_code": "37007",
    "message": "Failed to mark conversation as unread"
  }
}

Отключение уведомлений беседы: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "mute_conversation_failed",
    "numeric_code": "37008",
    "message": "Failed to mute conversation"
  }
}

Закрепить беседу: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "pin_conversation_failed",
    "numeric_code": "37010",
    "message": "Failed to pin conversation"
  }
}

Закрепить / открепить сообщение: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "pin_message_failed",
    "numeric_code": "36002",
    "message": "Failed to pin message"
  }
}

Реакция на сообщение: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "react_message_failed",
    "numeric_code": "36004",
    "message": "Failed to react to message"
  }
}

Запросить историю диалога: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Проверьте личный чат WhatsApp и якорь before. request_id нужен только для диагностики HTTP. События истории могут прийти после тайм-аута; не повторяйте запрос автоматически и не считайте отсутствие события, пустой или короткий пакет признаком завершения.

{
  "request_id": "req_example",
  "error": {
    "code": "request_conversation_history_failed",
    "numeric_code": "37016",
    "message": "Failed to request conversation history"
  }
}

Отозвать сообщение: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "revoke_message_failed",
    "numeric_code": "36003",
    "message": "Failed to revoke message"
  }
}

Действие аккаунта: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "run_action_failed",
    "numeric_code": "20007",
    "message": "Failed to run account action"
  }
}

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

Действия и повторы: Проверьте текущий процесс авторизации и необходимость действий пользователя. Не начинайте новую авторизацию только из-за этого сбоя и не отправляйте действия в истёкшую или завершённую сессию.

{
  "request_id": "req_example",
  "error": {
    "code": "run_auth_action_failed",
    "numeric_code": "20010",
    "message": "Failed to run auth action"
  }
}

Изменение состояния runtime: действие runtime не выполнено; ответ сам по себе не определяет итоговое состояние соединения.

Действия и повторы: Проверьте авторизацию и runtime-статус, затем выберите refresh, start или reconnect с учётом нужного состояния и возможностей канала. Сбой соединения сам по себе не означает выход из аккаунта. Перед зависимыми операциями подтвердите running.

{
  "request_id": "req_example",
  "error": {
    "code": "run_runtime_action_failed",
    "numeric_code": "20008",
    "message": "Failed to run runtime action"
  }
}

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

Действия и повторы: Проверьте текущий процесс авторизации и необходимость действий пользователя. Не начинайте новую авторизацию только из-за этого сбоя и не отправляйте действия в истёкшую или завершённую сессию.

{
  "request_id": "req_example",
  "error": {
    "code": "run_session_action_failed",
    "numeric_code": "20009",
    "message": "Failed to run session action"
  }
}

Не удалось отправить сообщение или подтвердить результат отправки.

Действия и повторы: Перед повторной отправкой выясните, создано ли исходное сообщение или ответ. После тайм-аута или ошибки результат может быть неизвестен; отсутствие ответа в последующей выборке не доказывает, что записи не было. Не отправляйте повторно автоматически.

{
  "request_id": "req_example",
  "error": {
    "code": "send_message_failed",
    "numeric_code": "36001",
    "message": "Failed to send message"
  }
}

Заметка о контакте: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "set_contact_note_failed",
    "numeric_code": "35008",
    "message": "Failed to set contact note"
  }
}

Режим одобрения вступления: изменение группы не выполнено; возможны отказ канала или недостаточные права администратора.

Действия и повторы: Проверьте группу, членство, требуемые права администратора и текущее состояние. Устраните проблемы доступа до повторного изменения; при неизвестном результате сначала выполните сверку.

{
  "request_id": "req_example",
  "error": {
    "code": "set_group_join_approval_mode_failed",
    "numeric_code": "34009",
    "message": "Failed to set group join approval mode"
  }
}

Добавить / убрать метку на беседах: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "set_label_members_failed",
    "numeric_code": "37015",
    "message": "Failed to set label members"
  }
}

Разблокировать контакт: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "unblock_contact_failed",
    "numeric_code": "35006",
    "message": "Failed to unblock contact"
  }
}

Включение уведомлений беседы: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "unmute_conversation_failed",
    "numeric_code": "37009",
    "message": "Failed to unmute conversation"
  }
}

Открепить беседу: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "unpin_conversation_failed",
    "numeric_code": "37011",
    "message": "Failed to unpin conversation"
  }
}

Обновить аккаунт: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "update_account_failed",
    "numeric_code": "20003",
    "message": "Failed to update account"
  }
}

Обновить информацию группы: изменение группы не выполнено; возможны отказ канала или недостаточные права администратора.

Действия и повторы: Проверьте группу, членство, требуемые права администратора и текущее состояние. Устраните проблемы доступа до повторного изменения; при неизвестном результате сначала выполните сверку.

{
  "request_id": "req_example",
  "error": {
    "code": "update_group_info_failed",
    "numeric_code": "34006",
    "message": "Failed to update group info"
  }
}

Одобрить / отклонить заявки: изменение группы не выполнено; возможны отказ канала или недостаточные права администратора.

Действия и повторы: Проверьте группу, членство, требуемые права администратора и текущее состояние. Устраните проблемы доступа до повторного изменения; при неизвестном результате сначала выполните сверку.

{
  "request_id": "req_example",
  "error": {
    "code": "update_group_join_requests_failed",
    "numeric_code": "34008",
    "message": "Failed to update group join requests"
  }
}

Изменение участников группы: изменение группы не выполнено; возможны отказ канала или недостаточные права администратора.

Действия и повторы: Проверьте группу, членство, требуемые права администратора и текущее состояние. Устраните проблемы доступа до повторного изменения; при неизвестном результате сначала выполните сверку.

{
  "request_id": "req_example",
  "error": {
    "code": "update_group_members_failed",
    "numeric_code": "34005",
    "message": "Failed to update group members"
  }
}

Обновить Webhook-эндпоинт: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторной отправкой прочитайте настройки эндпоинта и его привязку к аккаунту. PATCH заменяет настройки: сохраните нужные подписки, подпись и политику повторов. При конфликте active обновите существующий эндпоинт либо деактивируйте его перед включением другого.

{
  "request_id": "req_example",
  "error": {
    "code": "update_webhook_endpoint_failed",
    "numeric_code": "40003",
    "message": "Failed to update webhook endpoint"
  }
}

Создать или обновить метку: изменение прервано неклассифицированной ошибкой; итоговое состояние нужно проверить.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "upsert_label_failed",
    "numeric_code": "37013",
    "message": "Failed to upsert label"
  }
}

Канал не поддерживает операцию; выберите доступную в таблице возможностей.

Действия и повторы: Выберите поддерживаемые канал и действие. Повтор запроса не добавит возможностей и не откроет доступ к бета-функциям.

{
  "request_id": "req_example",
  "error": {
    "code": "unsupported_by_provider",
    "numeric_code": "30003",
    "message": "Operation not supported by this provider"
  }
}

Публикации и комментарии

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

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "get_post_failed",
    "numeric_code": "39006",
    "message": "Failed to get post"
  }
}

Публикации и комментарии

Комментарии верхнего уровня: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_post_comments_failed",
    "numeric_code": "39003",
    "message": "Failed to list post comments"
  }
}

Публикации и комментарии

Публикации аккаунта: сервис не смог получить достоверный результат запроса.

Действия и повторы: Сохраните request_id, проверьте идентификаторы и доступ аккаунта. Повторяйте чтение после проверки причины; неудачный запрос не доказывает отсутствие ресурса или пустой результат.

{
  "request_id": "req_example",
  "error": {
    "code": "list_posts_failed",
    "numeric_code": "39002",
    "message": "Failed to list posts"
  }
}

Сервис канала недоступен. Проверьте состояние или повторите позже; перед повтором записи проверьте предыдущий результат.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "provider_adapter_not_found",
    "numeric_code": "30004",
    "message": "Provider adapter unavailable"
  }
}

Сервис канала недоступен. Проверьте состояние или повторите позже; перед повтором записи проверьте предыдущий результат.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "provider_unavailable",
    "numeric_code": "30002",
    "message": "Provider service unavailable"
  }
}

Публикации и комментарии

Проверьте пост, подтверждённый комментарий верхнего уровня и классификацию ошибки. При неизвестном результате записи сохраните request_id и выясните результат до повтора. Отсутствия ответа в последующем чтении недостаточно для повторной записи.

Действия и повторы: Перед повторной отправкой выясните, создано ли исходное сообщение или ответ. После тайм-аута или ошибки результат может быть неизвестен; отсутствие ответа в последующей выборке не доказывает, что записи не было. Не отправляйте повторно автоматически.

{
  "request_id": "req_example",
  "error": {
    "code": "reply_post_comment_failed",
    "numeric_code": "39004",
    "message": "Failed to confirm comment reply; result may be unknown, do not automatically retry"
  }
}

Сервис распределения временно недоступен; повторите позже.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "allocation_service_unavailable",
    "numeric_code": "20012",
    "message": "Allocation service is temporarily unavailable"
  }
}

Звонки

Сервис звонков недоступен. Проверьте соединение и настройки Provider/Gateway.

Действия и повторы: Перед созданием или завершением звонка запросите управляемый звонок и его call_id/state. preparing не означает набор номера или ответ; ended и failed — конечные состояния. Сам по себе failed не требует повторного завершения.

{
  "request_id": "req_example",
  "error": {
    "code": "call_service_unavailable",
    "numeric_code": "38001",
    "message": "Call service unavailable"
  }
}

Сервис сессий авторизации недоступен или не настроен для этого запроса. Обратитесь к оператору сервиса для проверки.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

{
  "request_id": "req_example",
  "error": {
    "code": "internal_auth_not_configured",
    "numeric_code": "11006",
    "message": "Internal endpoint authentication is not configured"
  }
}

Данные или настройки кошелька недоступны. Результат записи может быть неизвестен; проверьте исходную операцию.

Действия и повторы: Перед повторным изменением прочитайте текущее состояние ресурса и выясните результат предыдущей попытки. Сохраните request_id; не повторяйте запись автоматически при неизвестном результате.

{
  "request_id": "req_example",
  "error": {
    "code": "wallet_unavailable",
    "numeric_code": "20028",
    "message": "Wallet service is unavailable"
  }
}

Провайдер не выполнил операцию. message может содержать исходную причину после «Provider operation failed:»; текст меняется и не является стабильным программным интерфейсом.

Действия и повторы: Проверьте, не удалён ли ресурс уже, и затем решайте, нужен ли повтор. Сохраните request_id и обрабатывайте успешный ответ согласно документации этого эндпоинта.

Provider operation failed

Отсутствует экземпляр провайдера, нужный аккаунту. Это проблема доступности среды выполнения, а не доказательство истечения авторизации.

Действия и повторы: Проверьте авторизацию и runtime-статус, затем выберите refresh, start или reconnect с учётом нужного состояния и возможностей канала. Сбой соединения сам по себе не означает выход из аккаунта. Перед зависимыми операциями подтвердите running.

Provider instance is missing

Среда выполнения провайдера остановлена. Перед запуском выясните, не было ли это намеренным; остановка сама по себе не означает выход из аккаунта.

Действия и повторы: Проверьте авторизацию и runtime-статус, затем выберите refresh, start или reconnect с учётом нужного состояния и возможностей канала. Сбой соединения сам по себе не означает выход из аккаунта. Перед зависимыми операциями подтвердите running.

Provider runtime is stopped

Провайдер явно отклонил отправленный код авторизации. Проверьте процесс ввода и срок действия кода. Существующие пути могут возвращать 30001 вместо определённого контрактом 30016.

Действия и повторы: Проверьте текущий процесс авторизации и необходимость действий пользователя. Не начинайте новую авторизацию только из-за этого сбоя и не отправляйте действия в истёкшую или завершённую сессию.

Provider rejected the authentication code

Канал явно отклонил запрос из-за слишком высокой частоты. Числовая классификация сохраняет прежние HTTP-статус и code операции.

Действия и повторы: Приостановите запросы и повторите позже с ограничением числа попыток. Фиксированная задержка и обработка Retry-After здесь не гарантированы. Перед повторной записью выясните предыдущий результат.

Provider rate limit exceeded

Базовый App State аккаунта рассинхронизирован у провайдера. Это состояние синхронизации аккаунта, а не обычная ошибка формата запроса.

Действия и повторы: Дождитесь восстановления базового App State у провайдера, затем проверьте состояние перед повтором. Эта классификация сама по себе не означает недействительные учётные данные и не требует новой авторизации.

Provider app state is out of sync

Платформа явно ограничила отправку сообщения: HTTP 502, provider_unavailable, 30019. Это не доказывает постоянную блокировку аккаунта и не задаёт время снятия ограничения.

Действия и повторы: Остановите автоматические повторы при таком ограничении отправки. Возобновляйте отправку только после подтверждённого снятия ограничения; фиксированного срока нет, сама ошибка не требует повторной авторизации.

Message sending is restricted by the platform

Синхронный запрос whatsapp-protocol выявил ограничение входа с numeric_code=30020. Это может затронуть импорт сессии, runtime, отправку и запросы контактов; HTTP-статус и code текущей операции сохраняются. Не переносите на этот канал контракт событий WhatsApp с 20102.

Действия и повторы: Остановите автоматическую отправку и повторы. Попросите пользователя проверить и устранить ограничение в официальном приложении WhatsApp. Возобновляйте работу после устранения и необходимой повторной авторизации. Прежний running не доказывает снятие ограничения.

Account login is restricted. Check the official WhatsApp app for details.

Во время операции WhatsApp не был подключён. Исходный текст ошибки соединения сохраняется. Это не доказывает выход или недействительную авторизацию и не запускает переподключение, повторную отправку либо изменение состояния аккаунта.

Действия и повторы: Приостановите операции, которым нужно соединение. Сначала вызовите POST /v1/accounts/{account_id}/runtime/refresh, восстановите соединение по актуальному состоянию и подтвердите runtime_status=running перед бизнес-запросами. Перед повторной отправкой выясните результат предыдущей записи.

Account is not connected to the messaging platform

Группа не найдена для этого аккаунта; проверьте ID группы.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

Group not found

Группа может существовать, но аккаунт в ней не участвует. В деталях беседы WhatsApp 404 conversation_not_found / 34011 означает, что группа не видна этому аккаунту, а не временный сбой шлюза.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

Account is not participating in this group

Для отправки в эту группу WhatsApp аккаунту нужны права администратора. Сначала измените его роль в группе; не повторяйте запрос без изменений.

Действия и повторы: Сохраните request_id и структурированные коды; выясните причину текущего сбоя перед следующим действием.

Group administrator privileges are required to send messages to this group

Медиа стикера не прошло проверку до отправки провайдеру. Ответ может уточнять причину подготовки; numeric_code=36007 не означает, что отправка была выполнена.

Действия и повторы: Исправьте указанную проблему со стикером перед отправкой. Эта ошибка возникает при подготовке медиа до вызова отправки у провайдера; она не означает неизвестный результат уже выполненной отправки.

Invalid sticker media

Целевой API-ключ не найден в рабочем пространстве. Обновление и ротация сохраняют HTTP 400 и прежний update_api_key_failed или rotate_api_key_failed; 11104 уточняет причину.

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

API key not found

Webhook-эндпоинт не найден в этой области. GET, PATCH и деактивация сохраняют код своей операции и HTTP 500 с numeric_code=40006. Это уточнение не относится к идемпотентному DELETE: при отсутствии эндпоинта он возвращает 204.

Действия и повторы: Проверьте идентификатор, принадлежность ресурса и текущее рабочее пространство. Не повторяйте запрос автоматически, считая подтверждённое отсутствие или недоступность временным сбоем сервиса.

Webhook endpoint not found

При синхронной отправке WhatsApp выявлено ограничение входа: HTTP 502, provider_unavailable, 20102. В событии сбоя WhatsApp та же числовая причина имеет code=account_restricted. Сам HTTP-ответ не обновляет состояние аккаунта и не создаёт дополнительное событие.

Действия и повторы: Остановите автоматическую отправку и повторы. Попросите пользователя проверить и устранить ограничение в официальном приложении WhatsApp. Возобновляйте работу после устранения и необходимой повторной авторизации. Прежний running не доказывает снятие ограничения.

Account login is restricted. Check the official WhatsApp app for details.

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

Действия и повторы: Проверьте текущий процесс авторизации и необходимость действий пользователя. Не начинайте новую авторизацию только из-за этого сбоя и не отправляйте действия в истёкшую или завершённую сессию.

{
  "id": "<EVENT_ID>",
  "type": "account.auth.failed",
  "provider": "whatsapp",
  "account_id": "<ACCOUNT_ID>",
  "occurred_at": "2026-10-16T00:00:00Z",
  "data": {
    "auth_status": "failed",
    "runtime_status": "disconnected",
    "event": {
      "kind": "account_auth_status",
      "auth_status": "failed",
      "runtime_status": "disconnected"
    },
    "error": {
      "code": "account_auth_failed",
      "numeric_code": "20100",
      "message": "Account authentication failed. The specific cause could not be determined."
    }
  }
}

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

Действия и повторы: Попросите пользователя заново авторизоваться поддерживаемым способом канала. Затем проверьте runtime и готовность соединения перед возобновлением зависимых операций.

{
  "id": "<EVENT_ID>",
  "type": "account.auth.failed",
  "provider": "whatsapp",
  "account_id": "<ACCOUNT_ID>",
  "occurred_at": "2026-10-16T00:00:00Z",
  "data": {
    "auth_status": "failed",
    "runtime_status": "disconnected",
    "event": {
      "kind": "account_auth_status",
      "auth_status": "failed",
      "runtime_status": "disconnected"
    },
    "error": {
      "code": "account_logged_out",
      "numeric_code": "20101",
      "message": "The account session is no longer valid. Reauthorization is required."
    }
  }
}

Событие WhatsApp account.auth.failed указывает текущее ограничение входа через data.error.code=account_restricted и numeric_code=20102. Это не доказывает постоянную блокировку и не задаёт срок восстановления.

Действия и повторы: Остановите автоматическую отправку и повторы. Попросите пользователя проверить и устранить ограничение в официальном приложении WhatsApp. Возобновляйте работу после устранения и необходимой повторной авторизации. Прежний running не доказывает снятие ограничения.

{
  "id": "<EVENT_ID>",
  "type": "account.auth.failed",
  "provider": "whatsapp",
  "account_id": "<ACCOUNT_ID>",
  "occurred_at": "2026-10-16T00:00:00Z",
  "data": {
    "auth_status": "failed",
    "runtime_status": "disconnected",
    "event": {
      "kind": "account_auth_status",
      "auth_status": "failed",
      "runtime_status": "disconnected"
    },
    "error": {
      "code": "account_restricted",
      "numeric_code": "20102",
      "message": "Account login is restricted. Check the official WhatsApp app for details."
    }
  }
}