Meta Tech Provider

WhatsApp hata 4: uygulama API çağrı hız sınırına ulaştı

4 numaralı hata kodu, uygulamanın API çağrı hız sınırına ulaştığı anlamına gelir. Meta'nın açıklaması: "Uygulama API çağrı hız sınırına ulaştı." Kayan bir saat boyunca uygulamanın yaptığı çağrılar sayılır, bir numaradan gönderilen mesajlar sayılmaz. Kullanımı uygulama panelinden kontrol edin, bekleyin ve uygulamanın API'yi ne sıklıkla çağırdığını azaltın.

Meta'nın "Uygulama API çağrı hız sınırına ulaştı." açıklamasına karşılık gelen kodu.

200 x users

Graph API Platform Rate Limits kapsamında bir uygulamanın bir saatte yapabileceği çağrı sayısı.

API Too Many Calls

Graph API hata yönetimi kılavuzunun 4 kodu için verdiği ad.

WhatsApp 4 numaralı hata kodu ne anlama gelir?

Uygulamanızın geçerli pencerede çok fazla API çağrısı yaptığı ve sayı düşene kadar yeni çağrıların reddedildiği anlamına gelir.

Meta, 4 kodunu kısıtlama hataları altında "Uygulama API çağrı hız sınırına ulaştı." ayrıntı metniyle listeler. Graph API hata yönetimi kılavuzu bu hataya API Too Many Calls adını verir ve geçici bir kısıtlama sorunu olarak tanımlar.

Karıştırılması kolay iki kısıtlama koduyla yan yanadır. 80007, WhatsApp Business hesabının hız sınırına ulaşması demektir. 130429 ise Cloud API mesaj aktarım hızıdır. 4 kodu bunların hiçbiri değildir: uygulamanın kendi çağrı bütçesidir.

Uygulamanın çağrı sınırı nasıl hesaplanır?

Uygulama erişim token'ı ile yapılan istekler için Meta'nın Graph API hız sınırlama kılavuzu bir formül verir: bir saat içindeki çağrı sayısı, 200 çarpı kullanıcı sayısına eşittir.

Kullanıcı sayısı, uygulamanın benzersiz günlük aktif kullanıcılarına dayanır. Günlük kullanım düştüğünde haftalık ve aylık rakamlar kullanılır. Sınır kullanıcı başına değil, uygulamanın tamamı için geçerlidir; bu yüzden birkaç yoğun kullanıcı sınırın büyük kısmını tüketebilir.

Kılavuz ayrıca kullanımın uygulama panelinde göründüğünü, yeterince çağrı yapıldıktan sonra da yanıtlarda bir X-App-Usage başlığında yer aldığını belirtir. 4 numaralı hata gelmeden önce sınıra yaklaşıldığını görmenin yolu bu başlıktır.

4 numaralı hatadan sonra ne yapmalısınız?

Bir süre çağrı yapmayı bırakın, sonra daha az çağrı yapın.

Meta'nın hız sınırlama kılavuzu ilk kısım konusunda açıktır: sınıra ulaşıldığında API çağrıları yapmayı durdurun, çünkü devam etmek çağrı sayısını artırır ve çağrıların yeniden başarılı olmasına kadar geçen süreyi uzatır.

İkinci kısım tasarımla ilgilidir. İstekleri ani yığılmalar yerine eşit biçimde yayın, yanıtları filtreleyin ki tek çağrı ihtiyacınız olanı döndürsün ve birbiriyle örtüşen veri çeken çağrılardan kaçının. Genellikle suçlu yoklamadır (polling). Aynı hesap durumunu birkaç saniyede bir soran bir entegrasyon, bütçesini zaten bildiği yanıtlara harcar.

Yaygın hatalar

Döngü içinde yeniden denemek. Her ek çağrı sayıyı artırır ve düzelmeyi daha da uzaklaştırır.
Bunu bir gönderim sınırı sanmak. 4 kodu uygulamanın çağrılarını sayar, mesaj aktarım hızı ise 130429'dur.
Durum uç noktalarını kısa aralıklarla yoklamak. Değişmeyen verinin tekrar tekrar okunması saatlik bütçeyi tüketir.

Bunu EasyCoexistence'la yapmak

EasyCoexistence, bağlı her numarayı kendi tarafında 7/24 izler; böylece bağlantı sağlığını kontrol etmek için uygulamanızın çağrı bütçesini tüketen bir yoklama döngüsü kurmanız gerekmez.

Sık sorulan sorular

4 numaralı hata ile 130429 numaralı hata aynı mı?

Hayır. 130429, bir numaranın mesaj aktarım hızıdır. 4 numaralı hata ise uygulamanızın yaptığı API çağrılarının sayısıdır.

4 numaralı hata ne kadar sürer?

Kayan bir saatlik penceredeki çağrı sayısı sınırın altına düşene kadar. Bu sürede çağrı yapmak süreyi uzatır.

Uygulamamın sınıra ne kadar yaklaştığını nerede görebilirim?

Uygulama panelindeki Uygulama Hız Sınırı (Application Rate Limit) bölümünde ve yanıtlarda dönen X-App-Usage başlığında.

4 numaralı hata ile 80007 numaralı hata aynı mı?

Hayır. Meta, WhatsApp Business hesabı hız sınırına ulaştığında 80007'yi kullanır; 4 numaralı hata ise uygulamanın kendi çağrılarını sayar.

Okumaya devam edin

WhatsApp error 130429: throughput limit reachedError 130429 means the messaging throughput limit was reached. What sets the cap, why it is temporary, and why Coexistence numbers hit it sooner.Rate limits and messaging throughputThe four separate WhatsApp Cloud API limits: messaging tier, throughput, per-recipient pairing and management calls.WhatsApp error 131057: business account in maintenance modeError 131057 means the WhatsApp Business Account is in maintenance mode. Why a throughput upgrade triggers it, how long it lasts, and what to do.WhatsApp error 133004: server temporarily unavailableError 133004 means a Meta server was temporarily unavailable. Where to check platform status, what the details value tells you, and when to retry.WhatsApp Cloud API error codesEvery WhatsApp Cloud API error code in one table: what each one means, whether retrying helps, and the page that covers it in full.

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz denemeyi başlatın

Doğrulama tarihi 2026-10-11