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

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

Пропускная способность

Обновлено: 21 ноября 2025 г
Для каждого зарегистрированного корпоративного телефонного номера Cloud API по умолчанию поддерживает до 80 сообщений в секунду (мп/с), а при автоматическом обновлении — 1000 мп/с
Пропускная способность включает входящие и исходящие сообщения, а также все типы сообщений. Обратите внимание, что на номера телефонов компаний, независимо от пропускной способности, по-прежнему распространяются ограничения по количеству запросов и лимиты на отправку шаблонных сообщений, .
Если вы попытаетесь отправить больше сообщений, чем позволяет ваш текущий уровень пропускной способности, API вернет код ошибки 130429 , пока вы снова не окажетесь в пределах допустимого уровня. Кроме того, уровни пропускной способности предназначены для кампаний обмена сообщениями с участием разных телефонных номеров пользователей WhatsApp. Если вы попытаетесь отправить слишком много сообщений на один и тот же номер пользователя WhatsApp, вы можете столкнуться с ограничения скорости отправки .

Номера телефонов приложения WhatsApp Business

Для обеспечения совместимости с приложением WhatsApp Business, для бизнес-номеров телефонов, используемых как с приложением WhatsApp Business, так и с облачным API (« номера для сосуществования »), установлен фиксированный лимит пропускной способности в 20 Мбит/с.

Более высокая пропускная способность

Если вы соответствуете нашим требованиям , мы автоматически бесплатно повысим пропускную способность вашего корпоративного телефонного номера до 1000 Мбит/с. Более высокая пропускная способность не влечет за собой дополнительных расходов и не влияет на ценообразование.
Сам процесс обновления может занять до 1 минуты. В течение этого времени номер не будет доступен на нашей платформе. При использовании в API-запросе API вернет код ошибки 131057. После обновления бизнес-номера телефона он будет автоматически обновляться при любом будущем увеличении пропускной способности без простоев.
После повышения пропускной способности вашего номера будет запущен веб-перехватчик phone_number_quality_update событием THROUGHPUT_UPGRADE и параметром max_daily_conversations_per_business , установленным на TIER_UNLIMITED .

Критерии отбора

    В портфеле бизнес-услуг, связанном с данным телефонным номером, должен быть установлен неограниченный лимит на отправку сообщений .Рабочий номер телефона необходимо использовать для отправки сообщений на 100 000 или более уникальных номеров телефонов пользователей WhatsApp вне времени обслуживания клиентов , в течение 24-часового периода.Рабочий номер телефона должен иметь рейтинг качества YELLOW ( отображается как средний  рейтинг качества в WhatsApp Manager) или выше.

    Вебхуки

    Ваши серверы веб-хуков должны выдерживать нагрузку, в 3 раза превышающую пропускную способность исходящего трафика сообщений, и в 1 раз превышающую ожидаемую пропускную способность входящего трафика сообщений. Например, при отправке 1000 сообщений в секунду с ожидаемым коэффициентом ответа 30%, ваши серверы должны быть способны обработать до 3000 веб-хуков статуса сообщений плюс еще 300 входящих веб-хуков сообщений.
    Мы стараемся отправлять веб-хуки одновременно, поэтому рекомендуем настроить и протестировать ваш сервер веб-хуков на обработку одновременных запросов со следующим стандартом задержки:
      Медианная задержка не должна превышать 250 мс.Менее 1% задержки превышает 1 секунду.
      Мы будем пытаться повторно доставить неудавшиеся веб-хуки в течение 7 дней с экспоненциальной задержкой.

      Сообщения СМИ

      Для максимальной эффективности использования более высокой пропускной способности мы рекомендуем загружать ваши медиафайлы на наши серверы и использовать полученные идентификаторы медиафайлов, вместо размещения файлов на собственных серверах и использования URL-адресов медиафайлов при отправке сообщений содержащих медиафайлы. Если вы предпочитаете (или вынуждены) размещать файлы на собственных серверах, мы рекомендуем использовать кэширование медиафайлов .

      Получение уровня пропускной способности

      Используйте WhatsApp Business Phone Number , чтобы узнать текущий уровень пропускной способности телефонного номера:
      GET /< WHATSAPP_BUSINESS_PHONE_NUMBER_ID >? fields = throughput