Türkiye’ye gönderim için SMS API
Türkiye’ye gönderen bir entegrasyonun zor kısmı istek biçimi değil. Zor kısım, kodun yazıldığı sırada görünmeyen iki kural: gönderici adının büyük harf duyarlı olması ve yurt dışından gelen linkli mesajların taşınmaması.
İkisi de hata döndürmez biçimde sonuç doğurur. Biri kayıtla eşleşmeyen bir ad yüzünden reddedilmeye, diğeri teslim edilmemeye yol açar, ve ikisi de mesaj gövdesi kusursuzken olur.
MCC 286 ve gönderici alanı
Türkiye’nin mobil ülke kodu 286, telefon kodu ise 90. Alfanümerik gönderici adı tüm operatörlerde önceden kayıt gerektiriyor ve marka adını içermek zorunda.
Kritik ayrıntı entegrasyonda: incelediğimiz belgeye göre ad büyük harf duyarlı. Bu yüzden gönderici adı istek gövdesinde serbest bir alan olamaz; gözden geçirilen yapılandırmada sabitlenmeli ve kayıttaki yazımla birebir aynı tutulmalıdır.
Link kuralı, şablonları etkiler
BTK Kurul Kararı 2025/DK-YED/399 uyarınca 1 Nisan 2026’dan itibaren yurt dışından gelen ve link içeren A2P mesajlar taşınmıyor. Bu, mesaj şablonlarını doğrudan ilgilendiriyor.
Şablon motoru kısaltılmış izleme bağlantıları üretiyorsa, Türkiye’ye giden yolda bu bağlantılar mesajın hiç ulaşmaması anlamına gelir. Bu yüzden ülkeye göre şablon ayrımı, sonradan eklenecek bir iyileştirme değil, ilk sürümde bulunması gereken bir ayrımdır.
Çift yönlü yok: gelen kutusu tasarımı
İncelediğimiz belgeye göre Türkiye’de çift yönlü SMS kullanılabilir değil. Gelen mesaj bekleyen bir entegrasyon için bu bir yapılandırma seçeneği değil, bir tasarım kısıtıdır.
Onay akışları, iptal ve listeden çıkma bu yüzden başka bir kanaldan yürümeli: aranabilir bir telefon numarası ya da uygulama içi bir adım. Cevap anahtar kelimesi bekleyen bir akış Türkiye’de sessizce boşa çalışır, çünkü cevap hiçbir yere ulaşmaz.
Konuya göre kaynaklar
| Mobil ülke kodu | www.twilio.com2026-09-22 |
| Alfanümerik gönderici | api.support.vonage.com2026-09-22 |
| Gönderici kaydı | www.twilio.com2026-09-22 |
| Çift yönlü SMS | www.twilio.com2026-09-22 |
| Kısıtlı içerik ve yurt dışı trafiği | www.lexpera.com.tr2026-09-22 |
Kullanım örnekleri
Tek kullanımlık kod
Kısa geçerlilik ve tanınan bir gönderici adı. Kod mesajlarında link zaten bulunmaz, bu yüzden yurt dışı kuralı bu akışı etkilemez.
Sipariş bildirimi
Linksiz ve kendi kendine yeterli metin. Takip bağlantısı yerine sipariş numarası ve aranabilir bir numara verilir.
- Alfanümerik gönderici adı kaydı zorunludur ve ad büyük harf duyarlıdır.
- Yurt dışından gelen ve link içeren A2P mesajlar 1 Nisan 2026’dan itibaren taşınmıyor.
- Çift yönlü SMS kullanılabilir değil; gelen akışlar başka bir kanaldan yürütülmelidir.
FAQ
Türkiye’nin mobil ülke kodu nedir?
İncelediğimiz belgeye göre MCC 286, telefon kodu ise 90. MCC teknik arayüzlerde şebekeyi tanımlar, telefon kodu ise numaranın kendisine aittir.
Gönderici adı neden reddedildi?
En sık nedeni büyük harf duyarlılığıdır: kayıtta “MARKA” olarak geçen bir ad, istekte “Marka” olarak gönderildiğinde aynı sayılmaz. Ad ayrıca marka adını içermeli ve tüm operatörlerde önceden kayıtlı olmalıdır.
Mesaj şablonlarımda link kullanabilir miyim?
Yurt dışından gönderiyorsanız hayır. BTK Kurul Kararı 2025/DK-YED/399 uyarınca 1 Nisan 2026’dan itibaren link içeren A2P mesajlar taşınmıyor. Şablonlar ülkeye göre ayrılmalı, aksi halde kısaltılmış izleme bağlantısı mesajın hiç ulaşmamasına yol açar.
Gelen mesajları API üzerinden alabilir miyim?
Hayır. İncelediğimiz belgeye göre Türkiye’de çift yönlü SMS kullanılabilir değil, bu yüzden cevap bekleyen akışlar sessizce boşa çalışır. Onay ve iptal başka bir kanaldan, örneğin aranabilir bir numara veya uygulama içi bir adım üzerinden yürütülmelidir.
Dokümantasyon ve hesap erişilebilirdir. Pazar bazında ticari etkinleştirme ödeme adımında kontrol edilir.
SMSPro · 3 kaynak · 2026-09-25