Bir müşteri sipariş verdiğinde onay mesajının, kargo yola çıktığında bildirimin ya da randevudan bir gün önce hatırlatmanın kendiliğinden gitmesini istiyorsanız ihtiyacınız olan şey bir SMS API entegrasyonudur. Bu rehberde SMS API’nin ne olduğunu, nasıl çalıştığını, entegrasyon yaparken hangi adımları izlemeniz gerektiğini ve sık yapılan hataları anlatıyoruz.
SMS API Nedir?
API (Application Programming Interface), iki yazılımın birbiriyle konuşmasını sağlayan arayüzdür. SMS API ise web sitenizin, e-ticaret altyapınızın, CRM’inizin ya da randevu sisteminizin, insan müdahalesi olmadan SMS göndermesini sağlar. Yazılımınız SMS sağlayıcısına “şu numaraya, şu başlıkla, şu mesajı gönder” isteğini iletir; sağlayıcı mesajı operatörlere aktarır ve sonucu yazılımınıza bildirir.
SMS API Hangi Durumlarda Kullanılır?
- E-ticaret: Sipariş alındı, ödeme onaylandı, kargo çıktı, iade tamamlandı bildirimleri.
- Randevu sistemleri: Randevu onayı, bir gün önce hatırlatma, değişiklik ve iptal bildirimleri.
- Doğrulama: Giriş, üyelik ve ödeme adımlarında tek kullanımlık şifre (OTP SMS).
- Finans ve abonelik: Fatura kesildi, son ödeme günü yaklaşıyor, ödeme alındı mesajları.
- Teknik izleme: Sunucu ya da cihaz arızasında nöbetçi ekibe alarm mesajı.
SMS API Nasıl Çalışır?
Sağlayıcıdan sağlayıcıya ayrıntılar değişse de SMS API’lerin büyük çoğunluğu aynı mantıkla çalışır:
- Kimlik doğrulama: Yazılımınız her istekte kendisini bir API anahtarı ya da kullanıcı bilgileriyle tanıtır.
- Gönderim isteği: HTTPS üzerinden gönderilen istekte genellikle şu bilgiler bulunur: onaylı SMS başlığı, alıcı numara ya da numaralar, mesaj metni ve isteğe bağlı olarak ileri tarihli gönderim zamanı.
- Yanıt: Sağlayıcı isteği kabul ederse bir gönderim kimliği döner. Hata varsa (ör. geçersiz numara, yetersiz bakiye, onaysız başlık) hata kodu döner.
- Teslim raporu: Mesajın alıcıya teslim edilip edilmediği, gönderim kimliğiyle sonradan sorgulanır ya da sağlayıcı sonucu sizin belirlediğiniz bir adrese (geri çağırma / webhook) bildirir.
Entegrasyon Adımları
- Senaryoları listeleyin: Hangi olayda, kime, hangi mesaj gidecek? Her senaryo için örnek metni önceden yazın.
- Mesaj türünü belirleyin: Sipariş ve randevu gibi bilgilendirme mesajları ile kampanya içeren ticari iletileri ayırın. Ticari iletiler için alıcı onayı ve İYS kontrolü API gönderimlerinde de geçerlidir.
- Numara biçimini standartlaştırın: Numaraları veritabanında tek biçimde (ör. ülke kodlu 905XXXXXXXXX) saklayın; boşluk, parantez ve tire gibi karakterleri temizleyin.
- Test ortamında deneyin: Önce yalnızca kendi numaralarınıza gönderim yapan bir test akışı kurun; hata kodlarının doğru işlendiğini görün.
- Kayıt tutun: Her gönderimde gönderim kimliğini, alıcıyı, zamanı ve sonucu kendi sisteminizde saklayın. Müşteri “mesaj gelmedi” dediğinde ilk bakacağınız yer burası olur.
- Canlıya alın ve izleyin: İlk günlerde teslim oranlarını ve hata dağılımını yakından takip edin.
Örnek Senaryo: E-ticaret Sipariş Bildirimi
Bir e-ticaret sitesinde tipik akış şöyle kurulur: Müşteri ödemeyi tamamladığında sipariş kaydı oluşur ve sistem “sipariş alındı” mesajını kuyruğa ekler. Arka planda çalışan bir görev kuyruktaki mesajı SMS API’ye gönderir, dönen gönderim kimliğini sipariş kaydına yazar. Kargo firmasından takip numarası geldiğinde aynı yolla “kargonuz yola çıktı” mesajı gider. Teslim raporu geldiğinde sonuç sipariş ekranında görünür; böylece müşteri hizmetleri ekibi “mesaj gelmedi” şikâyetinde gönderimin ne zaman yapıldığını ve teslim durumunu tek bakışta görür.
Mesajı doğrudan sayfa isteği sırasında değil de bir kuyruk üzerinden göndermek, SMS sağlayıcısına geçici olarak ulaşılamadığında sipariş sürecinin yavaşlamasını ya da hata vermesini önler.
Sık Yapılan Hatalar
- Mükerrer gönderim: Zaman aşımı sonrasında isteğin körlemesine yeniden denenmesi, aynı mesajın iki kez gitmesine yol açar. Her mesaja kendi tarafınızda benzersiz bir kimlik verin ve yeniden denemeden önce ilk isteğin sonucunu kontrol edin.
- Bilgilendirme mesajına kampanya eklemek: “Siparişiniz kargoda, şimdi %20 indirimi kaçırmayın” gibi bir cümle mesajı ticari iletiye dönüştürür.
- Uzun metin sürprizi: Türkçe karakter ve değişken alanlar (müşteri adı, ürün adı) mesajı beklenenden uzun yapıp birden fazla SMS’e bölebilir. Şablonları en uzun değerle test edin.
- Hataları sessizce yutmak: Gönderim başarısız olduğunda bunun kaydedilmemesi, sorunun ancak müşteri şikâyetiyle fark edilmesine neden olur.
Güvenlik Önerileri
- API anahtarını kaynak kodun içine ya da tarayıcıda çalışan koda yazmayın; sunucu tarafında, erişimi kısıtlı bir ayar dosyasında ya da ortam değişkeninde tutun.
- Sağlayıcınız destekliyorsa API erişimini yalnızca kendi sunucu IP adreslerinizle sınırlandırın.
- SMS gönderen formlarınızı (ör. “kodu tekrar gönder” düğmesi) kötüye kullanıma karşı numara ve IP başına sınırla koruyun; aksi hâlde bakiyeniz kısa sürede tükenebilir.
- OTP kodlarını kısa süre geçerli tutun ve deneme sayısını sınırlayın.
Panel ile API Birlikte Kullanılabilir mi?
Evet. Çoğu işletme kampanya ve duyuruları panelden, olaya bağlı bildirimleri API üzerinden gönderir. İkisi aynı hesap, aynı başlık ve aynı bakiyeyi kullanır. Toplu gönderim adımlarını ve İYS kurallarını toplu SMS nasıl gönderilir rehberimizde ayrıntılı anlattık.
GelecekINT toplu SMS hizmeti ile yazılımınızdan otomatik gönderim yapmak istiyorsanız entegrasyon ihtiyacınızı paylaşın; kurulum sırasında teknik ekibimizle birlikte planlayalım.
Bu rehber, 2009’dan bu yana İstanbul Kağıthane’den kurumsal iletişim ve BT altyapısı hizmeti veren GelecekINT (Gelecek İnternet ve Network Teknolojileri) ekibi tarafından hazırlanmıştır.
İşletmeniz için sanal santral kurulumu, paket fiyatları ve numara taşıma hakkında bilgi alın.