lıcı orada sizden mesaj almayı kabul etmişse ve çalışan bir WhatsApp hesabına sahipse WhatsApp üzerinden gönderim yapın; diğer tüm durumlarda ise SMS ile gönderin veya SMS kanalına geçiş yapın. WhatsApp Cloud API üzerinde, mesajı alamayacak bir numaraya gönderilen mesaj 131026 hatasıyla başarısız olur ve bunu gönderim yanıtından değil, yalnızca durum webhook'undan öğrenebilirsiniz. Güvenilir yöntem, her müşterinin kanal onayını onaylama (opt-in) anında kaydetmek, gönderim yapmadan önce yasal olarak neleri kontrol edebileceğinizi belirlemek ve başarısız bir WhatsApp durumunun bir SMS tetiklemesini sağlamaktır. BroadNet her iki kanalı da açıkça tanımlanmış yedekleme kurallarına sahip tek bir Omnichannel API üzerinden çalıştırır.
Önemli çıkarımlar
- 131026 hatası, Meta'nın mesajı iletemediği anlamına gelir. Meta üç olası neden listeler: numara bir WhatsApp numarası değildir, alıcı en son şartları kabul etmemiştir veya alıcı eski bir WhatsApp sürümü kullanmaktadır.
- Başarılı bir API yanıtı, yalnızca isteğin kabul edildiği anlamına gelir. İletim durumu daha sonra durum webhook'u tarafından bildirilir: gönderildi, iletildi, okundu veya başarısız; başarısızlık durumunda ise bir hata dizisi (errors array) iletilir.
- Bir WhatsApp hesabına sahip olmak, birine mesaj gönderme izni sağlamaz: Meta politikası, kişinin numarasını ve sizden mesaj almayı kabul ettiğini (opt-in) gerektirir.
- 24 saatlik müşteri hizmetleri penceresinin dışında, WhatsApp yalnızca şablon mesajları kabul eder (aksi takdirde 131047 hatası alınır).
- Hat türü ilk filtredir: Sabit hatlı veya ücretsiz bir numaraya yapılan SMS genellikle başarısız olur ve yine de mesaj ücretine tabi tutulur.
- Yedekleme (fallback) mekanizması, gönderim platformunda kural olarak en iyi şu şekilde çalışır: Müşterinin seçtiği durumda önce WhatsApp, başarısız durumunda veya WhatsApp onayı olmadığında ise SMS.
WhatsApp 131026 hatası ne anlama gelir?
Meta'nın Cloud API hata referansında 131026, "Mesaj iletilemiyor" anlamına gelir. Meta üç olası neden sunar: "Alıcı telefon numarası bir WhatsApp telefon numarası değildir", alıcı "yeni Hizmet Şartlarını ve Gizlilik Politikasını kabul etmemiştir" veya alıcı "eski bir WhatsApp sürümü kullanmaktadır". Meta tarafından önerilen çözüm, "WhatsApp dışı bir iletişim yöntemi kullanan" kişiden işletme numaranıza mesaj gönderebileceğini onaylamasını, en güncel şartları kabul etmesini veya uygulamayı güncellemesini istemektir.
Başka bir deyişle 131026 bir yönlendirme sinyalidir, kodunuzdaki bir hata değildir. Tek kullanımlık şifre, iletim bildirimi veya randevu hatırlatıcısı için Meta'nın bahsettiği WhatsApp dışı yöntem genellikle SMS'dir ve bir destek talebinden ziyade otomatik olarak gönderilmelidir.
Bir mesaj kimliği (message ID), mesajın iletildiği anlamına neden gelmez?
Gönderim işlemi asenkrondur. API isteği kabul eder ve bir mesaj kimliği döndürür; sonrasında gerçekleşenler webhook'unuza iletilir. Meta mesaj durumu webhook'u bu değerleri raporlar:
| Durum | Meta açıklaması | Ne yapılmalı |
|---|---|---|
| gönderildi | Mesaj, Meta sunucularından başarıyla gönderildi | İletildi veya başarısız oldu durumunu bekleyin |
| iletildi | Mesaj, WhatsApp kullanıcısının cihazına başarıyla iletildi | Yedekleme gerekmiyor |
| okundu | Mesaj, kullanıcının cihazındaki açık bir sohbet dizisinde görüntülendi | Yedekleme gerekmiyor |
| başarısız | Mesajın kullanıcının cihazına gönderilememesi veya iletilememesi | Okuma hataları[].code; zaman hassasiyeti olan mesajlar için SMS'e geri dönün |
Başarısız durumu; sayısal bir kod, bir başlık, bir detay alanı ve hata referansına yönlendiren bir bağlantı içeren bir hata dizisi taşır. Kodu şu mesajla günlüğe kaydedin: Bu kod size yeniden denemeniz, kanal değiştirmeniz veya bir şablonu düzeltmeniz gerekip gerekmediğini söyler. Aynı mantık, operatörden gelen iletim raporunun (DLR) durum webhook'u rolünü üstlendiği SMS için de geçerlidir.
Birine sadece hesabı olduğu için WhatsApp üzerinden mesaj gönderebilir misiniz?
Hayır. WhatsApp Business Mesajlaşma Politikası, "WhatsApp üzerinden insanlarla yalnızca şu durumlarda iletişime geçebileceğinizi" belirtir: "(a) size mobil telefon numaralarını veya kullanıcı adlarını vermişlerse; ve (b) alıcıdan, sizden sonraki mesajları veya aramaları almak istediklerini onaylayan bir onay (opt-in) izni almışsanız." Ayrıca, WhatsApp üzerinde veya dışında, iletişimi durdurmaya yönelik her türlü talebe saygı göstermelisiniz.
Dolayısıyla kanal seçimi gönderim anında değil, onay (opt-in) aşamasında başlar. Müşterilerinize hangi kanalları kabul ettiklerini sorun, bu seçimi bir zaman damgasıyla birlikte kaydedin ve yalnızca kabul ettikleri kanallar üzerinden gönderim yapın. Yerel yasalar buna ek kurallar getirir: Bir örnek için SMS ve WhatsApp pazarlaması için BAE PDPL kılavuzumuza göz atın.
Peki ya 24 saatlik pencere ve 131047 hatası?
Serbest biçimli bir WhatsApp mesajına, yalnızca müşterinin size gönderdiği son mesajdan itibaren 24 saat içinde izin verilir. Bu sürenin dışında, Cloud API, "Alıcının gönderici numarasına son yanıt vermesinin üzerinden 24 saatten fazla geçti" anlamına gelen 131047 hatasını döndürür ve Meta'ün çözümü "alıcıya bunun yerine bir şablon mesaj göndermektir". WhatsApp 24 saatlik pencerenin ne olduğunu inceleyin.
Yedekleme (fallback) tasarımı için bu, iki farklı hata türü anlamına gelir: 131047 hatası WhatsApp üzerinde onaylı bir şablona geçilerek çözülürken, 131026 hatası kanal değiştirilerek çözülür. Yeniden deneme mantığınızda (retry logic) bunları farklı şekilde ele alın.
İlk olarak hangi kanalı kullanmalısınız?
Her pazar için tek bir cevap yoktur; mesajın içeriğine ve her bir müşterinin neyi kabul ettiğine bağlıdır. Alıcı başına uygulanan bir kural seti çoğu durumu kapsar:
| Durum | Birinci kanal | Yedek kanal |
|---|---|---|
| Müşteri WhatsApp için onay verdi ve size daha önce mesaj gönderdi | WhatsApp (24 saat dışındaki şablonlar) | Hata durumunda SMS |
| Müşteri WhatsApp için onay verdi, henüz geçmiş mesaj bulunmuyor | WhatsApp şablonu | Hata durumunda veya belirlediğiniz süre içinde durum oluşmadığında SMS |
| WhatsApp için onay kaydedilmedi | SMS | Desteklenen yerlerde OTP için sesli iletişim |
| Önceki WhatsApp mesajı 131026 hatasıyla başarısız oldu | SMS | Bir sonraki temasta müşteriden WhatsApp bilgilerini onaylamasını isteyin |
| Numara sabit hat veya ücretsiz numaradır | SMS değil: genellikle başarısız olur | Sesli arama veya bir mobil numara isteyin |
| Müşteri RCS, Telegram veya Viber için onay verdi | Mesaj gönderebileceğiniz kanal | SMS |
Pazar bazlı görünüm için (WhatsApp, RCS veya SMS'in öncelikli olduğu durumlar), SMS vs WhatsApp vs RCS kanal kılavuzumuzu okuyun.
Gönderim yapmadan önce neleri kontrol edebilirsiniz?
İlk kontrol uygulamalarla ilgili değildir: hat tipidir. Sabit hatlı veya ücretsiz bir numaraya yapılan SMS gönderimi genellikle başarısız olur ve yine de mesaj ücretine mal olur. Özel ön izleme aşamasındaki BroadNet markalı MobileValidate](/products/mobilevalidate), hat tipini, mevcut operatörü ve taşınmış bir numara için orijinal operatörü döndürür; BroadNet HLR Sorgulama ise hattın şu anda ulaşılabilir olup olmadığını belirten canlı ağ durumunu ekler.
Diğer kanallara onay vermiş müşteriler için MobileValidate, numaralarının Telegram, Viber veya Zalo üzerinde gerçek zamanlı olarak; Signal, iMessage, RCS, LINE veya Botim üzerinde ise toplu işlerde kayıtlı olup olmadığını da kontrol edebilir; RCS kontrolü, mevcut olduğunda el terminali platformunu raporlar. Kabul edilebilir kullanım politikası, bu kontrolleri dolandırıcılığı önleme ve onay vermiş kişiler için kanal seçimi ile sınırlandırır. Kontrollerin tam listesi mobilevalidate.com adresindedir. MobileValidate, kontrol ettiği platformlarla bağlantılı olmayan, onlar tarafından desteklenmeyen veya sponsor olunmayan bağımsız bir hizmettir; platform isimleri yalnızca bir kontrolün neleri kapsadığını tanımlamak için kullanılır.
WhatsApp'nin kendisi için güvenilir sinyaller, Meta tarafından size sunulanlardır: müşterinin kendi onayı (opt-in), yanıtları ve son mesajınızın iletildi veya başarısız durumu. Her müşteri için son WhatsApp sonucunu saklayın ve bir sonraki gönderimi buna göre yönlendirin.
BroadNet yedekleme (fallback) sürecini nasıl yönetir?
BroadNet, resmi bir Meta Business Solution Provider olup WhatsApp Business API, SMS, RCS ve sesi tek bir platform üzerinden sunar. Omnichannel API, SMS, WhatsApp, RCS ve ses arasında açık geri dönüş (fallback) kurallarına sahip tek bir istek alır ve birleştirilmiş iletim raporları döndürür; böylece WhatsApp iletimi başarısız olduğunda, uygulamanızda ek bir kod yazmanıza gerek kalmadan mesaj SMS olarak iletilir.
- Tek kullanımlık şifreler için, OTP API; SMS, WhatsApp, ses ve Flash Call üzerinden otomatik yedekleme ile gönderim yapar; MyOTP.App ise tek bir hesaptan SMS, WhatsApp ve Telegram'ı kapsar.
- Zamana duyarlı mesajlar için bir zaman sınırı belirleyin: eğer ne iletildi ne de başarısız durumu zamanında gelirse, yedekleme kanalını kullanın.
- 24 saatlik pencerenin dışında ihtiyaç duyabileceğiniz her mesaj türü için onaylı şablonlar bulundurun.
- Tekrarlanan başarısızlıklar için ödeme yapmamak adına, 131026 hatasından sonra bir müşteri için ilgili kanalı, müşteri tekrar onaylayana kadar devre dışı bırakın.
Daha fazla senaryo için çok kanallı yedekleme stratejimizi okuyun.
Alıcı başına yönlendirme kontrol listesi neye benzer?
- Onay (opt-in) alındığında, müşterinin kabul ettiği kanalları, tarihi ve kabul ettiği metni kaydedin.
- Yeni numaraların hat tipini kontrol edin; hat sabit hat veya ücretsiz numara ise mobil numara talep edin.
- İlk kanalı sadece bir ülke varsayılanına göre değil, müşterinin izni ve geçmişine göre seçin.
- 24 saatlik pencerenin dışında, yalnızca WhatsApp şablonlarını gönderin.
- Durum webhook'larını ve iletim raporlarını takip edin; başarısız gönderimleri ve zaman aşımlarını yedek (fallback) tetikleyicileri olarak değerlendirin.
- Zamana duyarlı mesajlar için SMS kanalına geri dönün ve mesajla birlikte WhatsApp hata kodunu günlüğe kaydedin.
- Hataları haftalık olarak inceleyin: Bir segmentteki 131026 artışı, genellikle güncelliğini yitirmiş numaralar veya eksik onay anlamına gelir.
Sıkça sorulan sorular
WhatsApp 131026 hatası ne anlama gelir?
"Mesaj iletilemedi." Meta üç olası neden listeler: numara bir WhatsApp numarası değildir, alıcı en güncel Hizmet Şartları ve Gizlilik Politikasını kabul etmemiştir veya alıcı eski bir WhatsApp sürümü kullanmaktadır.
131026 hatası alan bir mesajı tekrar denemeli miyim?
Hemen WhatsApp üzerinden denemeyin. Bunun yerine zaman hassasiyeti olan içerikleri SMS ile gönderin ve müşteriden başka bir kanal aracılığıyla WhatsApp numarasını onaylamasını isteyin.
WhatsApp API üzerinden gelen 200 yanıtı mesajın iletildiği anlamına mı gelir?
Hayır. Bu, isteğin kabul edildiği anlamına gelir. İletim durumu, status webhook'u tarafından gönderildi, iletildi, okundu veya başarısız olarak raporlanır.
Bir müşterinin hesabı olduğunu biliyorsam WhatsApp üzerinden ona mesaj gönderebilir miyim?
Hayır. Meta politikası, kişinin numarasını size vermiş olmasını ve WhatsApp üzerinden işletmenizden mesaj almayı kabul etmiş olmasını gerektirir.
131047 hatası nedir?
Müşterinin son yanıt vermesinin üzerinden 24 saatten fazla zaman geçti. Serbest biçimli bir mesaj yerine onaylanmış bir şablon mesaj gönderin.
WhatsApp için yedek kanal hangisi olmalıdır?
Çoğu durumda SMS, çünkü her türlü mobil numaraya ulaşabilir. Tek kullanımlık şifreler için, platformun desteklediği durumlarda sesli arama ek bir yedek seçenektir.
Göndermeden önce bir numarayı kontrol edebilir miyim?
Evet, yasal dayanağınız dahilinde. Önce hat tipini kontrol edin; onay vermiş müşteriler için MobileValidate, Telegram, Viber ve RCS gibi uygulamalardaki kaydı kontrol edebilir, BroadNet HLR Lookup ise canlı ağ durumunu sağlar.
BroadNet SMS yedeğini nasıl gönderir?
Omnichannel API, yedekleme kurallarınızı tek bir istekte uygular ve OTP API; SMS, WhatsApp, ses ve Flash Call arasında otomatik olarak geçiş yapar.
Aşağıdaki tüm kaynakları 27 Eylül 2026 tarihinde okuduk. Editör standartlarımıza göz atın.
Kaynaklar
- Geliştiriciler için Meta — WhatsApp Cloud API hata kodları (131026, 131047), erişim tarihi 27 Eylül 2026: developers.facebook.com.
- Geliştiriciler için Meta — mesaj durumu webhook referansı, erişim tarihi 27 Eylül 2026: developers.facebook.com.
- WhatsApp Business Mesajlaşma Politikası — onay alma (opt-in) ve onay iptali (opt-out) gereklilikleri, erişim tarihi 27 Eylül 2026: whatsappbusiness.com/policy.
- MobileValidate — hizmet referansı ve operatör sorgulama, son güncelleme 25 Eylül 2026: mobilevalidate.com/docs/services, mobilevalidate.com/services/carrier-lookup.
- MobileValidate — kabul edilebilir kullanım politikası, erişim tarihi 27 Eylül 2026: mobilevalidate.com/legal/acceptable-use.