Tek API ile SMS, WhatsApp ve RCS: Sent'in Akıllı Yönlendirme Mantığı

Uygulamana mesajlaşma eklemek ilk bakışta tek satırlık bir iş gibi durur ama ikinci istekte tablo değişir. Kısa mesaj, WhatsApp ve RCS her biri ayrı kimlik, ayrı format ve ayrı hata senaryosu getirir; bir pazar SMS'te iyi, diğeri WhatsApp'ta zayıf, üçüncüsü RCS'i yeni açmıştır. Eric Tech'in bu demosu tam o noktada duruyor ve tek bir istekle üç kanalı konuşturmayı amaçlayan Sent'in birleşik API'sini canlı bir telefona kadar uçtan uca test ediyor. Başlıkta geçen en hızlı yol slogandan çok bir tasarım iddiası; uygulamanın kanalı bilmemesi, platformun ise kararı gizlememesi.

Neden Tek Kanal Yetmiyor

Eskiden çoğu ekip bildirim işini SMS üzerine kurar, tutmayınca yanına WhatsApp ekler ve en son RCS'i yama gibi iliştirirdi. Her dal ayrı bir sağlayıcı, ayrı bir kimlik doğrulama ve ayrı bir şablon dili demek; biri çöktüğünde devreye girecek yedek mantığını da sen yazarsın. Uluslararası ölçekte tablo daha da karışır çünkü bir ülkede SMS pahalı veya güvenilmezken başka bir ülkede WhatsApp penetrasyonu düşüktür. Sonuçta kod tabanı dallanır, test matrisi şişer ve her yeni kanal yeni bir bakım penceresi açar. Video bu dağınıklığı tek cümlede özetliyor; mesajı göndermek kolay, onu her yerde ulaştırmak zor.

Sent'in Akıllı Yönlendirme Mantığı

Sent bu yükü tersine çeviriyor. İstek gövdesinde SMS mi WhatsApp mı RCS mi yazmıyorsun; alıcı ve şablon referansını veriyorsun, gerisini platform seçiyor. Dokümantasyona göre yönlendirici müsaitlik, etkileşim verisi ve maliyete bakarak mevcut en iyi kanalı belirliyor ve içeriği o kanala göre biçimlendiriyor. Şablon kullanıldığı için kodda gömülü uzun metin kalmıyor; aynı çağrı dün SMS'e düşerken yarın RCS'e akabiliyor ve uygulama tarafında tek satır değişmiyor. Üstüne uyum, kimlik ve yedekleme de platformda; yani kod sadeliği ile teslimat dayanıklılığı aynı anda korunuyor.

TypeScript ile Bildirim Akışını Kurmak

Demo bilerek abartısız tutuluyor. Yeni bir TypeScript projesi, Sent SDK kurulumu ve ortam değişkenlerinde API anahtarı ile hedef numara; hesabın ortak gönderici seçeneği sayesinde en hızlı yoldan başlanıyor. Daha kalıcı bir kimlik istersen tam kayıt yolculuğu da var ama ABD'de 10DLC ve TCR onayı bir ila üç iş günü aldığı için hemen başlamak mantıklı. Videoda gösterilen veri akışı sent.message çağrısı üzerinde kurulu ve biçim öğretici; sabit bir metin yerine şablon ve değişkenlerle çalışmak hem çok kanallı uyumu hem de uzun vadeli bakımı kolaylaştırıyor. Bu iskelet küçük bir bildirim özelliği gibi dursa da aslında daha büyük bir uygulamanın içinde yaşayabilecek kadar yalın.

İlk gönderimde yanıt iki şey veriyor; bir mesaj kimliği ve ilk durum. Kısa bir gecikmeden sonra Sent'in seçtiği kanal görünür hale geliyor ve soyutlama değerini tam o anda gösteriyor. Aynı istek SMS, WhatsApp veya RCS üretebilir ama uygulama tarafında dallanma yok; detaylar platformun tarafında çözülüyor. Buradaki netlik önemli çünkü gizli bir karar değil izlenebilir bir karardır. Logda hangi yolun seçildiğini görmek, hem hata ayıklamayı hem de maliyet optimizasyonunu mümkün kılıyor ve uluslararası gönderimlerde kanal varsayımını ortadan kaldırıyor.

Teslimat Asenkron: Webhook ile Sent'ten Delivered'a

API'nin kabul etmesi teslimat demek değil; mesajlaşma doğası gereği asenkron. Bu yüzden ikinci perde webhook'la kuruluyor. Sent panosunda uygulamanı işaret eden bir webhook tanımlıyor, message.sent ve message.delivered olaylarına abone oluyorsun ve yerel geliştirme için tünel açıyorsun. Uygulamada küçük bir uç nokta gelen olayın kimliğini, tipini, seçilen kanalı ve güncel durumu kaydediyor; imza sırrı ortam değişkeninde tutulup her çağrı doğrulanıyor, böylece internetten gelen rastgele istekler olay sayılmıyor. Tekrar tetiklediğinde önce sent, sağlayıcı onaylayınca delivered olayı düşüyor ve terminalde akışın tamamı tek yerde görünüyor. Gerçek telefonun ekrana düşen mesajı da bu zincirin canlı kanıtı; simülasyon değil, operatör onayı.

Gerçek Telefonda Doğrulama ve Ölçekte Anlamı

Videonun sonunda Sent'in vaadi netleşiyor; kanal çoğaldıkça koda yeni dal eklemek zorunda kalmıyorsun. Aynı istek, aynı şablon referansı ve aynı webhook; yarın RCS kapsama genişlediğinde veya fiyatlar değiştiğinde yönlendirici kararını güncelliyor, senin bildirim katmanın etkilenmiyor. Uluslararası gönderim, doğrulama kodu, işlem bildirimi veya uyarı akışlarında bu soyutlama bakım maliyetini düşürüyor ve teslimat oranını artırıyor. Dokümantasyondaki yaşam döngüsü, kurulum ve olay katalogları da bu hikâyeyi tamamlıyor; istersen aynı iskeletle farklı şablonlar deneyip kendi çok kanallı sürecini kurabiliyorsun.