Краткий ответ
По документации Meta, каждый бизнес-номер WhatsApp Cloud API по умолчанию поддерживает до 80 сообщений в секунду, а подходящие номера автоматически повышаются до 1 000. Отдельные лимиты действуют для одного получателя, вызовов управления Graph API и суточных сообщений. Превышение пропускной способности возвращает ошибку 130429: снизьте скорость, поставьте отправки в очередь и повторяйте с задержкой.
Как выйти на 1 000 сообщений в секунду
Лимит действует для каждого бизнес-номера и учитывает входящие и исходящие сообщения всех типов. Meta автоматически и бесплатно повышает подходящие номера, когда выполнены все три условия. Повышение может занять до 1 минуты, и всё это время номер недоступен.
Для номеров, которые используются и в приложении WhatsApp Business, и в Cloud API, действует фиксированный лимит 20 сообщений в секунду.
| Требование | Подробности |
|---|---|
| Лимит сообщений | Без ограничений для бизнес-портфолио |
| Объём | 100 000 и более уникальных пользователей, которым отправлены сообщения вне окон обслуживания клиентов, за скользящие 24 часа |
| Качество | Оценка качества YELLOW (средняя) или выше |
Четыре разных лимита и их ошибки
| Лимит | Что ограничивает | Типичная ошибка |
|---|---|---|
| Пропускная способность | Сообщений в секунду на номер | 130429 |
| Парный лимит (pair rate limit) | Сообщения с одного номера одному и тому же получателю за короткое время | 131056 |
| Лимиты Graph API | Вызовы управления на приложение и аккаунт | 4, 80007, 80008 |
| Лимит сообщений | Уникальные люди, до которых дошли сообщения за скользящие 24 часа | Ограничения на отправку |
Как безопасно повторять отправку
- Ставьте каждую отправку в очередь и разбирайте её пулом обработчиков.
- Держите скорость ниже лимита, оставляя запас для ответов.
- Записывайте каждое сообщение перед отправкой, чтобы повтор не создал дубликат.
- Повторяйте только при ограничении скорости и временных ошибках сервера, с экспоненциальной задержкой и джиттером, ограничив задержку и число попыток.