Руководство по API блокировки пользователей | Документация для разработчиков

Руководство по API блокировки пользователей

Обновлено: 23 февраля 2026 г

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

Как это работает

При блокировке пользователя WhatsApp происходит следующее:

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

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

API для блокировки пользователей работает синхронно.

Ограничения

Вы можете заблокировать только тех пользователей, которые отправляли сообщения вашей компании в течение последних 24 часов.Вы не можете использовать этот API для блокировки другого аккаунта WhatsApp Business.В черный список включено не более 64 000 пользователей.

Функции

API содержит три конечные точки:

// Блокировка номеров пользователей WhatsApp
POST /<PHONE_NUMBER_ID>/block_users

// Разблокировка номеров пользователей WhatsApp
DELETE /<PHONE_NUMBER_ID>/block_users

// Получить список заблокированных номеров пользователей WhatsApp
GET /<PHONE_NUMBER_ID>/block_users

Блокировать пользователей

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

Конечная точка

POST /<PHONE_NUMBER_ID>/block_users

Текст запроса

{
"messaging_product": "whatsapp",
"block_users": [
    {
"user": "
    }
  ]
}

Параметры запроса

Параметр	Описание
`messaging_product` Нить	Необходимый Для отправки запроса необходимо использовать мессенджер `WhatsApp`.
`block_users` Множество	Необходимый Список пользователей для блокировки. Каждый элемент содержит `пользователя` .
`пользователь` нить	Номер телефона или идентификатор WhatsApp, который вы хотите заблокировать.

Объект ответа

УСПЕХ (200)

{
"messaging_product": "whatsapp",
"block_users": {
"added_users": [
      {
"input": ",
"wa_id": "
      }
    ]
  }
}

Параметры отклика

Параметр Описание

block_users

Объект

Содержит два списка:

added_users — Список успешно заблокированных пользователей.failed_users — Список пользователей, которые не были заблокированы.

добавленные_пользователи

Объект

Список успешно заблокированных пользователей.

Содержит значения обоих параметров:

вход

Строка — номер телефона пользователя WhatsApp

wa_id

Строка — Уникальный идентификатор пользователя WhatsApp

failed_users

Объект

Список пользователей, которые не были заблокированы.

Содержит значения:

вход

Строка — номер телефона пользователя WhatsApp

wa_id

Строка — Уникальный идентификатор пользователя WhatsApp (может отсутствовать, если номер недействителен)

ошибки

Массив — Подробная информация об ошибке для пользователя

Смешанный успех/неудача (400)

{
"messaging_product": "whatsapp",
"block_users": {
"added_users": [
      {
"input": ",
"wa_id": "
      },
      {
"вход": ",
"wa_id": "
      },
      ...
    ],
"failed_users": [
      {
"input": ",
"wa_id": "// Может отсутствовать, если число неверное
"errors": [
          {
"message": ",
"code": 
"error_data": {
"details": "
            }
          }
        ]
      }
    ]
  },
"error": {
"message": "(#139100) Не удалось заблокировать/разблокировать пользователей",
"type": "OAuthException",
"code": 139100,
"error_data": {
"details": "Не удалось заблокировать некоторых пользователей,подробности см. в списке ответов block_users"
    },
"fbtrace_id": "
  }
}

Разблокировать пользователей

Используйте этот адрес электронной почты, чтобы разблокировать список номеров пользователей WhatsApp.

Конечная точка

Удалить /<Номер_телефона_ID>/block_users

Текст запроса

{
"messaging_product": "whatsapp",
"block_users": [
     {
"user": "
     }
   ]
}

Параметры запроса

Параметр	Описание
`messaging_product` Нить	Необходимый Для отправки запроса необходимо использовать мессенджер `WhatsApp`.
`block_users` Множество	Необходимый Список пользователей, которых нужно разблокировать. Каждый элемент содержит `пользователя` .
`пользователь` нить	Номер телефона или идентификатор WhatsApp, который вы хотите разблокировать.

Объект ответа

УСПЕХ (200)

{
"messaging_product": "whatsapp",
"block_users": {
"removed_users": [
      {
"input": ",
"wa_id": "
      }
    ]
  }
}

Параметры отклика

Параметр Описание

block_users

Объект

Содержит два списка:

removed_users — Список успешно разблокированных пользователей.failed_users — Список пользователей, которые не были разблокированы.

удаленные_пользователи

Объект

Список успешно разблокированных пользователей.

Содержит значения обоих параметров:

вход

Строка — номер телефона пользователя WhatsApp

wa_id

Строка — Уникальный идентификатор пользователя WhatsApp

failed_users

Объект

Список пользователей, которые не были разблокированы.

Содержит значения:

вход

Строка — номер телефона пользователя WhatsApp

wa_id

Строка — Уникальный идентификатор пользователя WhatsApp (может отсутствовать, если номер недействителен)

ошибки

Массив — Подробная информация об ошибке для пользователя

Смешанный успех/неудача (400)

{
"messaging_product": "whatsapp",
"block_users": {
"removed_users": [
      {
"input": ",
"wa_id": "
      },
      {
"вход": ",
"wa_id": "
      },
      ...
    ],
"failed_users": [
      {
"input": ",
"wa_id": "// Может отсутствовать, если число неверное
"errors": [
          {
"message": ",
"code": 
"error_data": {
"details": "
            }
          }
        ]
      }
    ]
  },
"error": {
"message": "(#139100) Не удалось заблокировать/разблокировать пользователей",
"type": "OAuthException",
"code": 139100,
"error_data": {
"details": "Не удалось разблокировать некоторых пользователей, подробности см. в списке ответов block_users"
    },
"fbtrace_id": "
  }
}

Получить список заблокированных номеров

Используйте этот адрес электронной почты, чтобы получить список заблокированных номеров для вашего бизнес-номера WhatsApp.

Конечная точка

GET /<PHONE_NUMBER_ID>/block_users

Параметры запроса

?limit=10&after=<AFTER_CURSOR>&before=<BEFORE_CURSOR>

Параметры запроса

Параметр	Описание
`лимит` Необязательный	Максимальное количество заблокированных пользователей, которое можно получить в запросе.
`после` Необязательный	Узнайте больше о постраничных результатах в Graph API.
`до` Необязательный	Узнайте больше о постраничных результатах в Graph API.

Объект ответа

УСПЕХ

{
"data": [
    {
"messaging_product": "whatsapp",
"wa_id": "
    }
  ],
"paging": {
"cursors": {
"after": "eyJvZAmZAzZAXQiOjAsInZAlcnNpb25JZACI6IjE3Mzc2Nzk2ODgzODM1ODQifQZDZD",
"before": "eyJvZAmZAzZAXQiOjAsInZAlcnNpb25JZACI6IjE3Mzc2Nzk2ODgzODM1ODQifQZDZD"
    }
  }
}

Параметры отклика

Параметр	Описание
`данные` Множество	Список заблокированных пользователей. Каждый элемент содержит `messaging_product` и `wa_id` .
`messaging_product` Нить	Необходимый Для отправки запроса необходимо использовать мессенджер `WhatsApp`.
`wa_id` Нить	Уникальный идентификатор пользователя WhatsApp
`пейджинг` Объект	Узнайте больше о постраничных результатах в Graph API.

коды ошибок

ОШИБКА
{
"messaging_product": "whatsapp",
"error": {
"message": "(#139102) Одновременное обновление списка блокировки",
"type": "OAuthException",
"code": 139102,
"error_data": {
"details": "Список блокировки был обновлен во время получения - повторная попытка сосмещением 0"
    },
"fbtrace_id": "
  }
}

Код	Описание
`139100` Не удалось заблокировать/разблокировать некоторых пользователей	Массовая блокировка не смогла заблокировать некоторых или всех пользователей.
`139101` Достигнут лимит черного списка	В черный список добавлено 64 000 пользователей.
`139102` Одновременное обновление списка заблокированных устройств	Проблема возникает, когда список заблокированных пользователей обновляется во время выполнения запроса на пагинацию, и `значение version_id` не совпадает.
`139103` Внутренняя ошибка	Внутренняя ошибка. Пожалуйста, попробуйте еще раз.
`130429` Превышен лимит запросов	Происходит при одном из следующих событий: В самом запросе слишком много цифр.Или же, слишком много запросов поступает за короткий промежуток времени.
`131021` Самоблокировка	Не удалось заблокировать собственный номер телефона.
`131047` Требуется возобновление взаимодействия	Это происходит, если компания не получала сообщений с этого номера в течение последних 24 часов. Эта ошибка также будет возвращена, если номер принадлежит недействительному пользователю WhatsApp.