Пропускная способность | Документация для разработчиков
Пропускная способность
Обновлено: 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 .Критерии отбора
YELLOW ( отображается как средний рейтинг качества в WhatsApp Manager) или выше.Вебхуки
Ваши серверы веб-хуков должны выдерживать нагрузку, в 3 раза превышающую пропускную способность исходящего трафика сообщений, и в 1 раз превышающую ожидаемую пропускную способность входящего трафика сообщений. Например, при отправке 1000 сообщений в секунду с ожидаемым коэффициентом ответа 30%, ваши серверы должны быть способны обработать до 3000 веб-хуков статуса сообщений плюс еще 300 входящих веб-хуков сообщений.
Мы стараемся отправлять веб-хуки одновременно, поэтому рекомендуем настроить и протестировать ваш сервер веб-хуков на обработку одновременных запросов со следующим стандартом задержки:
Мы будем пытаться повторно доставить неудавшиеся веб-хуки в течение 7 дней с экспоненциальной задержкой.
Сообщения СМИ
Для максимальной эффективности использования более высокой пропускной способности мы рекомендуем загружать ваши медиафайлы на наши серверы и использовать полученные идентификаторы медиафайлов, вместо размещения файлов на собственных серверах и использования URL-адресов медиафайлов при отправке сообщений содержащих медиафайлы. Если вы предпочитаете (или вынуждены) размещать файлы на собственных серверах, мы рекомендуем использовать кэширование медиафайлов .
Получение уровня пропускной способности
Используйте WhatsApp Business Phone Number , чтобы узнать текущий уровень пропускной способности телефонного номера:
GET /< WHATSAPP_BUSINESS_PHONE_NUMBER_ID >? fields = throughput
Комментарии отсутствуют
Комментарии отсутствуют