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

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

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

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

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

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

    Ограничения

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

      Функции

      API содержит три конечные точки:
      // Блокировка номеров пользователей WhatsApp
ПОЧТА /<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/block_users
      // Разблокировка номеров пользователей WhatsApp
УДАЛИТЬ /<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/block_users
      // Получить список заблокированных номеров пользователей WhatsApp
ПОЛУЧАТЬ /<НОМЕР_ТЕЛЕФОНА_ИДЕНТИФИКАТОР>/block_users

      коды ошибок

      

      

      

      


      
Код 
Описание 
      


      


      

      139100
      

      Не удалось заблокировать/разблокировать некоторых пользователей
      		


      

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

      


      

      139101
      

      Достигнут лимит черного списка
      		


      

      В черный список добавлено 64 000 пользователей.
      

      


      

      139102
      

      Одновременное обновление списка заблокированных устройств
      		


      

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

      


      

      139103
      

      Внутренняя ошибка
      		


      

      Внутренняя ошибка. Пожалуйста, попробуйте еще раз.
      

      


      

      130429
      

      Превышен лимит запросов
      		


      

      Происходит при одном из следующих событий:
      

        В самом запросе слишком много цифр.Или же, слишком много запросов поступает за короткий промежуток времени.
        

        


        

        131021
        

        Самоблокировка
        		


        

        Не удалось заблокировать собственный номер телефона.
        

        


        

        131047
        

        Требуется возобновление взаимодействия
        		


        

        Это происходит, если компания не получала сообщений с этого номера в течение последних 24 часов.
        

        Эта ошибка также будет возвращена, если номер принадлежит недействительному пользователю WhatsApp.
        
    
                
        
    
        

            
        
        
        
    
        

    
        

    
    
        
        
        
             Вернуться наверх