WhatsApp Business API hataları: her kod ne anlama gelir ve nasıl düzeltilir

WhatsApp Business API çalışmıyor: önce bu beş şeyi kontrol edin

Tüm mesajlar aynı anda durduğunda neden hemen her zaman beş şeyden biridir ve hepsini birkaç dakikada kontrol edebilirsiniz. İlk kontroller her mesajı etkilediği, sonuncusu ise tek tek müşterileri etkilediği için bunları bu sırayla izleyin.

1. 1

   Meta’nın durum sayfasını kontrol edin

   Meta’nın WhatsApp Business API durum sayfasını açın. Meta bir sorun bildiriyorsa, ayarları değiştirmeden önce giderilmesini bekleyin. 1, 2, 131016 ve 133004 kodları bu duruma işaret eder.
2. 2

   Numaranızın durumunu Whapi’de kontrol edin

   Shopify içindeki Whapi kontrol panelinde WhatsApp numaranız yeşil bir durum göstermelidir. Meta yalnızca durumu Connected olan numaralar için mesaj gönderir ve alır. Bağlı değilse Connect WhatsApp’a tıklayıp yeniden bağlayın.
3. 3

   Meta’daki ödeme yöntemini kontrol edin

   WhatsApp Manager’ı açın ve Overview sayfasında Add payment method istemini arayın. Geçerli bir ödeme yöntemi olmadan şablon mesajları, çoğunlukla 131042 hatasıyla başarısız olur. Ödeme yöntemi rehberini izleyin.
4. 4

   Şablon durumunu kontrol edin

   Her Whapi otomasyonu, Meta’nın onaylaması gereken bir şablon gönderir. Hâlâ incelemede olan, reddedilen veya duraklatılan bir şablon 132001, 132015 veya 132016 ile başarısız olur. Bkz. şablonlar neden reddedilir.
5. 5

   Müşterinin numarasını kontrol edin

   Yalnızca bazı müşteriler mesaj alamıyorsa, başarısız mesajdaki koda bakın. 131026 numaranın WhatsApp mesajı alamadığı, 131047 24 saatlik pencerenin kapandığı anlamına gelir; 131049 ve 131050 marketing mesajları için geçerlidir.

Kurulum ve bağlantı hataları

Kurulum hataları, Whapi’de Connect WhatsApp’a tıkladıktan sonra Meta’nın kayıt penceresinde görünür. Meta’nın Embedded Signup akışından geldikleri için aşağıdaki ifade Meta’nındır ve çözüm Meta veya WhatsApp tarafında gerçekleşir.

“Your phone number isn’t eligible to connect to the WhatsApp Business Platform”

(Telefon numaranız WhatsApp Business Platform’a bağlanmaya uygun değil.) Bu, Meta’nın 3441045 kodudur ve bir WhatsApp Business uygulaması numarasını bağlarken gösterilir. Meta’nın belirttiği tek çözüm, uygunluğu belirlemek için WhatsApp Business uygulamasında daha fazla etkinlik gerektiğidir ve bir asgari değer yayımlamaz. Telefon numarası uygun değil rehberi, ne yapılacağını ve ilgili doğrulama hatalarını kapsar.

“This number is registered to an existing WhatsApp account”

(Bu numara mevcut bir WhatsApp hesabına kayıtlı.) Meta bunu, numara WhatsApp Messenger’da, WhatsApp Business uygulamasında veya WhatsApp Business API’de zaten kullanımdayken gösterir. Numara WhatsApp Business uygulamasındaysa ve uygulamayı kullanmaya devam etmek istiyorsanız Whapi kurulumunda bunun yerine Connect a WhatsApp Business App’i seçin (bu, WhatsApp coexistence’tır). Numarayı yalnızca API’de kullanmak için önce telefondaki WhatsApp hesabını silin. Meta, numaranın kullanılabilir hale gelmesinin 3 dakikaya kadar sürebileceğini söyler.

“The business is already sharing this WhatsApp Business account with a partner”

(İşletme bu WhatsApp Business hesabını zaten bir iş ortağıyla paylaşıyor.) Bu, 2655093 kodudur. WhatsApp Business uygulaması numaranız hâlâ başka bir sağlayıcıya bağlıdır ve Meta bu akışta iş ortağı değiştirmeyi desteklemez. WhatsApp Business uygulamasında Settings > Account > Business Platform altından mevcut iş ortağının bağlantısını kesin, 15 dakika bekleyin, ardından yeniden bağlanın. Numaranızı Whapi’ye taşıma rehberi hem coexistence hem de yalnızca API numaralarını kapsar.

Meta penceresi açılmıyor veya yarıda kapanıyor

Meta’nın kaydı bir açılır pencerede çalışır. Whapi kurulumunu bir bilgisayarda çalıştırın, tarayıcıda Shopify yönetim paneliniz için açılır pencerelere izin verin ve sayfayı yenileyin. Meta “Your Facebook account is too new to create a business account. Try again in an hour” (Facebook hesabınız işletme hesabı oluşturmak için çok yeni. Bir saat sonra tekrar deneyin) derse bekleyin veya daha eski, etkin bir Facebook hesabıyla giriş yapın. “User does not have permission to create WhatsApp Business Accounts” (Kullanıcının WhatsApp Business hesapları oluşturma izni yok) derse seçtiğiniz işletme portföyüne Admin erişiminiz olmalıdır.

Görünen ad reddedildi

Meta, WhatsApp görünen adınızı kendi görünen ad yönergelerine göre kontrol eder. Kayıt sırasında “Your verified name violates WhatsApp guidelines. Please edit your verified name and try again” (Doğrulanmış adınız WhatsApp yönergelerini ihlal ediyor. Lütfen doğrulanmış adınızı düzenleyip tekrar deneyin) görünürse görünen ad yönergelerini inceleyin ve bunlara uyan bir ad girin. Görünen adı WhatsApp Manager’da Account tools > Phone numbers > Profile altından 30 günde en fazla 10 kez değiştirebilirsiniz. 131037 hatası yalnızca onaylı görünen adı olmayan, Meta tarafından sağlanan 555 işletme numaraları için geçerlidir.

İşletme doğrulaması ve numara limitleri

Yeni bir işletme portföyü iki işletme telefon numarası kaydedebilir. Meta, işletme doğrulandığında veya 2.000 mesajlaşma limitine ulaştığında bu sınırı 20’ye çıkarır. Doğrulama tamamlanana kadar Meta, oluşturabileceğiniz WhatsApp Business hesabı sayısını da sınırlar (2388098 kodu). Belgeler ve adımlar için WhatsApp için Meta işletme doğrulaması sayfasına bakın.

Ödeme ve faturalandırma hataları

“There was an error related to your payment method” (Ödeme yönteminizle ilgili bir hata oluştu) olan 131042 hatası, Meta’nın mesajlarınızı gönderen Messaging hesabını faturalandıramadığı anlamına gelir. Meta’nın kendi neden listesinde; bağlı bir ödeme hesabının olmaması, limitini aşmış bir kredi hattı, silinmiş veya askıya alınmış bir WhatsApp Business hesabı ve hiç ayarlanmamış bir saat dilimi ya da para birimi yer alır.

1 Ekim 2026’dan itibaren eksik bir ödeme yöntemi, her işletme numarası için aylık 1.000 ücretsiz hizmet mesajı bittiğinde hizmet mesajlarını da durdurur ve açık bir 24 saatlik pencere içinde gönderilen utility şablonları ücretlendirilir. Ekim 2026 fiyat değişikliği yazısı ayrıntıları kapsar.

Ödeme yöntemi rehberi, WhatsApp Manager’da kart eklemeyi ve Meta’nın gösterdiği “Couldn’t save payment method” gibi kart hatalarını adım adım anlatır. Ülke bazında mesaj fiyatları WhatsApp API fiyatları sayfasındadır.

Mesaj iletim hataları

İletim hataları aynı anda bir müşteriyi veya bir mesajı etkiler; böylece diğer mesajlarınız gitmeye devam eder. Bunları o müşteriyle ilgili bilgi olarak değerlendirin ve aynı mesajı tekrar tekrar denemekten kaçının.

131026: mesaj iletilemiyor

Meta üç neden verir: numara bir WhatsApp numarası değildir, müşteri WhatsApp’ın en son Hizmet Şartları’nı kabul etmemiştir veya müşterinin uygulaması Meta’nın desteklediği asgari sürümden eskidir. Bir sipariş onayı başarısız olursa bunun yerine müşteriyi arayın veya SMS gönderin. 131026 hatası rehberi kontrolleri listeler.

131047: 24 saatlik pencere kapandı

Serbest biçimli yanıtlara yalnızca müşterinin son mesajından sonraki 24 saat içinde izin verilir. Sonrasında onaylı bir şablon gönderin. 131047 hatası ve müşteri hizmetleri penceresi hakkında daha fazlasını okuyun.

131049 ve 131050: tutulan marketing mesajları

131049, Meta’nın o müşteriye giden marketing şablonlarını “to maintain healthy ecosystem engagement” (sağlıklı ekosistem etkileşimini korumak için) sınırladığı anlamına gelir; yeniden göndermeden önce en az 24 saat bekleyin. 131050, müşterinin işletmenizden gelen marketing mesajlarını durdurmayı seçtiği anlamına gelir; bu yüzden yeniden denemeyin. İkisi de marketing şablonları için geçerlidir. 131049 hatası rehberine bakın.

130429 ve 131056: çok hızlı gönderim

130429, numaranın mesaj aktarım hızına ulaşıldığı anlamına gelir; daha sonra yeniden deneyin. 131056, aynı müşteriye kısa sürede çok fazla mesaj gittiği anlamına gelir; o müşteriye yeniden mesaj göndermeden önce bekleyin, diğer müşteriler etkilenmez.

131021: test kendi işletme numaranıza gönderildi

Meta, bir numaradan kendisine mesaj iletmez. Whapi’de Send Test Message’ı kullanırken işletme numarasından farklı, kişisel bir WhatsApp numarası girin.

Şablon hataları

Şablon hataları; Meta’nın şablonu onaylamadığı, mesajdaki değişkenlerin şablonla eşleşmediği veya müşteriler engellediği ya da bildirdiği için Meta’nın şablonu duraklattığı anlamına gelir. Whapi, bir otomasyon kurduğunuzda şablonları Meta’ya gönderir; kategoriye ve onaya Meta karar verir.

• 132001: şablon o dilde mevcut değil veya onaylı değil. Durumunu Whapi’de veya WhatsApp Manager’da kontrol edin.
• 132000 ve 132012: gönderilen değişkenler şablonun sayısıyla veya biçimiyle eşleşmiyor. Eşleştirin veya otomasyonun adını Whapi desteğine gönderin.
• 132005: bir çeviri çok uzun. O dil sürümünü kısaltın.
• 132007: içerik bir WhatsApp politikasını ihlal ediyor. Bkz. Meta şablonları neden reddeder.
• 132015 ve 132016: düşük kalite nedeniyle duraklatıldı, tekrarlanan duraklatmalardan sonra kalıcı olarak devre dışı bırakıldı. Duraklatılmış bir şablonu düzenleyin; devre dışı bırakılmış olanı yeni içerikle değiştirin.
• 131064: hesap, şablon sınıflandırma ihlalleri nedeniyle bir mesajlaşma limitine ulaştı. Sipariş güncellemelerinin utility, tanıtımların marketing olarak yazıldığından emin olun. Utility ve Marketing rehberi farkı açıklar.
• 2388019: hesap zaten en fazla 250 şablona ulaştı. Artık kullanmadıklarınızı silin.
• Şablon marketing olarak yeniden kategorilendirildi: bunun için bir hata kodu yoktur. 9 Nisan 2025’ten itibaren, utility olarak gönderilip Meta’nın marketing olarak değerlendirdiği bir şablon marketing olarak onaylanır; Meta ayrıca onaylı bir şablonun kategorisini daha sonra da değiştirebilir. Sipariş güncellemesine indirim kodu eklemek gibi karışık içerik marketing sayılır. Kategori değişikliğinden sonraki 60 gün içinde inceleme talep edebilirsiniz.

Kalite derecesi, mesajlaşma limitleri ve hesap kısıtlamaları

Müşteriler bir numaranın mesajlarını engellediğinde veya bildirdiğinde ya da işletme bir WhatsApp Business politikasını ihlal ettiğinde Meta limitleri düşürür veya numarayı kısıtlar. Whapi, Meta’nın resmi WhatsApp Business API’sini kullanır; bu, resmi olmayan WhatsApp Web araçlarının tetiklediği engellemelerden kaçınır, ancak Meta politikalarını ihlal eden herhangi bir numarayı yine de sınırlayabilir.

Mesajlaşma limitleri

Mesajlaşma limiti, hareketli 24 saatlik bir dönemde müşteri hizmetleri penceresi dışında kaç benzersiz müşteriye mesaj gönderebileceğinizi sınırlar. İşletme portföyü başına belirlenir ve tüm numaraları arasında paylaşılır. Yeni portföyler 250 ile başlar. 2.000’e ulaşmak için işletmenizi doğrulayın veya yüksek kaliteli şablonlarla 30 gün içinde hizmet pencereleri dışında benzersiz müşterilere 2.000 iletilen mesaj gönderin. Sonrasında kalite yüksek kaldığında ve 7 gün içinde mevcut limitinizin en az yarısını kullandığınızda Meta limiti otomatik olarak 10.000’e, 100.000’e ve sınırsıza yükseltir. Kendi limitinizi WhatsApp Manager’da Account tools > Messaging limits altında kontrol edin.

131048, 368 ve 131031: kısıtlanan gönderim veya hesaplar

131048, önceki çok sayıda mesaj engellendiği veya spam olarak işaretlendiği için numaradan göndermenin kısıtlandığı anlamına gelir; WhatsApp Manager’da kalite durumunu kontrol edin. 368 ve 131031 kodları, hesabın bir politika ihlali nedeniyle kısıtlandığı veya devre dışı bırakıldığı anlamına gelir. Business Support Home’daki uyarıyı okuyun ve bir hata olduğunu düşünüyorsanız orada itiraz edin. 130497 kodu, işletme kategorinizin belirli ülkelerdeki müşterilere mesaj gönderemeyeceği anlamına gelir.

Kalite derecenizi sağlıklı tutun

• Yalnızca sizden sipariş vermiş veya opt-in yapmış müşterilere mesaj gönderin.
• Sipariş onayları gibi sipariş güncellemelerini utility şablonları olarak gönderin ve tanıtımları marketing şablonlarında tutun.
• Pazarlamayı ilgili ve seyrek tutun, vazgeçmeyi kolaylaştırın.

Coexistence, arama, Flows ve kullanıcı adları

Bu hatalar daha yeni WhatsApp özelliklerinden gelir. Çoğu mağaza bunlarla yalnızca bir WhatsApp Business uygulaması numarasını bağlarken veya Meta’nın hâlâ kullanıma sunduğu bir özelliği test ederken karşılaşır.

Coexistence: eşleştirme hataları ve yayın listeleri

Coexistence, WhatsApp Business uygulaması numaranızı API’ye bağlar; böylece Whapi otomasyonlar gönderirken siz telefonunuzdan sohbet etmeye devam edebilirsiniz. Bağlandığınızda Meta uygulamadaki yayın listelerini devre dışı bırakır ve mevcut listeler salt okunur olur. “Error while pairing Cloud API” ve diğer eşleştirme hataları, eksik sohbet geçmişi ve bağlantı kopmaları WhatsApp coexistence çalışmıyor sayfasında ele alınır.

“Calling APIs cannot be enabled for this phone number”

(Bu telefon numarası için Calling API’leri etkinleştirilemiyor.) Meta’nın 138015 hatası, WhatsApp Business aramalarının o numara için henüz açılamayacağı anlamına gelir. Meta’nın çözümü, numaranın mesajlaşma limitinin 2.000 veya daha yüksek olmasını sağlamaktır. Oraya ulaşmak için yukarıdaki mesajlaşma limiti adımlarını kullanın.

WhatsApp Flows: “Blocked By Integrity”

139000 hatası, Meta’nın hesapta bir Flow oluşturmayı veya yayımlamayı engelleyen bir bütünlük sorunu tespit ettiği anlamına gelir. Business Support Home’da işletmedeki kısıtlamaları kontrol edin, ardından Meta’nın bu kod için verdiği tek yol olan Meta desteğiyle iletişime geçin.

İşletme kapsamlı kullanıcı kimlikleri (BSUID)

WhatsApp isteğe bağlı kullanıcı adları ekliyor; bu nedenle Meta artık müşterileri her işletme portföyüne özgü bir işletme kapsamlı kullanıcı kimliğiyle (BSUID) de tanımlıyor. Bazı mesaj türleri bir BSUID’e gönderilemez ve Meta 131062 döndürür: “Business-scoped User ID (BSUID) recipients are not supported for this message.” (BSUID alıcıları bu mesaj için desteklenmiyor.) Müşterinin telefon numarasına göndermek bunu önler. Shopify siparişleri, sipariş otomasyonlarının kullandığı telefon numarasını taşır.

Meta kesintileri ve süresi dolan erişim

2, 131016 ve 133004 kodları, Meta’nın hizmetinin aşırı yüklendiği veya kısa süreliğine kullanılamadığı anlamına gelir; bu yüzden çözüm beklemek ve yeniden denemektir. 1 kodu bir sunucu hatası veya hatalı biçimlendirilmiş bir istek olabilir ve Meta’nın dördü için tavsiyesi önce metastatus.com adresini kontrol etmektir. 131000 bilinmeyen bir hatadır; bir kez yeniden deneyin, tekrar ederse bildirin.

0 ve 190 kodları, Whapi’nin hesabınız adına göndermesini sağlayan erişim token’ının süresinin dolduğu veya geçersiz kılındığı anlamına gelir. Meta ayrıca, tüm uygulamaların verilerine erişmesini engelleyen bir kullanıcı ayarını da neden olarak listeler. 10 ve 200 ile 299 arasındaki kodlar bir iznin kaldırıldığı anlamına gelir. Her durumda, Meta’nın yeni erişim vermesi için WhatsApp’ı Whapi kontrol panelinden yeniden bağlayın.

Bir WhatsApp API hatası için nasıl yardım alırsınız

Önce hata kodunu gönderin, çünkü destek ekibine nereye bakacağını söyler. Whapi desteği e-posta ile info@usewhapi.com adresinden ve WhatsApp’tan yanıt verir. Şunları ekleyin:

• hata kodu ve Meta’nın mesajı veya bunun bir ekran görüntüsü;
• olayın gerçekleştiği tarih ve saat, saat diliminizle birlikte;
• başarısız olan Shopify sipariş numarası veya otomasyon;
• her mesajın mı yoksa yalnızca bazı müşterilerin mi başarısız olduğu.

Yalnızca Meta’nın çözebileceği hesap, faturalandırma veya politika sorunları için Meta Direct Support’ta bir destek talebi açın. Kart sorunları için Meta, “Dev: Billing, Credit & Pricing” konusunu ve “Credit Card Billing” talep türünü seçmenizi ister. Bu konuyu görmüyorsanız Meta, sağlayıcınızdan talebi açmasını istemenizi söyler; bize e-posta gönderin, biz açalım. Bize iletişim sayfası üzerinden de ulaşabilirsiniz.