Перейти к основному содержимому

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

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

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

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

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

Ограничения

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

Функции

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

коды ошибок

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