Yazılım ve yapay zekâ
SMS API Nedir? GSM Gateway ile SMS Gönderme
SMS API, bir yazılımın insan müdahalesi olmadan SMS göndermesini ve almasını sağlayan bağlantıdır. Yazılım bir HTTP isteği gönderir, SMS sağlayıcısı veya GSM Gateway mesajı alıcıya iletir.
SMS API ne işe yarar?
- Sipariş, kargo ve randevu bildirimleri
- Doğrulama kodları
- Sistem ve alarm uyarıları
- Destek kaydı bilgilendirmeleri
- Gelen SMS'lerin yazılımda toplanması
SMS API nasıl çalışır?
Yazılım numarayı ve metni API'ye gönderir. API isteği kabul ettiğini bildirir. Mesajın teslim durumu ise ayrı bir sorguyla veya bildirimle öğrenilir.
SMS sağlayıcısı mı, GSM Gateway mi?
SMS API için iki temel yol vardır. Hangisinin uygun olduğu kullanım amacına bağlıdır.
| SMS sağlayıcısı | GSM Gateway | |
|---|---|---|
| Altyapı | Sağlayıcının servisi | Kendi cihazınız ve SIM kartlarınız |
| Gönderen | Firma adı (başlık) | SIM kartın numarası |
| Maliyet | SMS başına kontör | Cihaz ve hat tarifesi |
| Yanıt alma | Pakete bağlıdır | SIM kartın numarasına gelir |
| Uygun kullanım | Yüksek hacimli kurumsal gönderim | Çift yönlü iletişim, iç sistemler, hat izleme |
Firma adıyla ticari toplu gönderim yapacaksanız SMS sağlayıcısı doğru seçimdir. Müşterinin yanıtlayabildiği numaradan iletişim, kendi hatlarınızı yönetme veya yazılımla SIM kart kontrolü gerekiyorsa GSM Gateway uygundur.
Dinstar GSM Gateway ile SMS gönderme
Dinstar GSM Gateway, HTTP API ile SMS gönderir. Örnek istek:
curl -k --anyauth -u KULLANICI:SIFRE \
-H "Content-Type: application/json" \
-d '{"text":"Siparişiniz hazır","param":[{"number":"05XXXXXXXXX"}],"port":[1],"encoding":"unicode"}' \
https://GATEWAY_IP/api/send_sms| Alan | Anlamı |
|---|---|
text | Mesaj metni |
param | Alıcı numaraları |
port | Mesajın çıkacağı port, numaralar 0'dan başlar |
encoding | Türkçe karakter için unicode |
Bu akışı 32 portlu gerçek bir gateway üzerinde test ettik. Kodsuz kurulum için n8n ile Dinstar SMS rehberine bakın.
İstek kabul edildi, mesaj teslim edildi mi?
Gateway başarılı istekte 202 kodunu döndürür. Bu kod yalnızca isteğin alındığını gösterir. Teslimatı /api/query_sms_result adresinden sorgulayın.
| Kod | Anlamı |
|---|---|
| 202 | İstek kabul edildi |
| 400 | İstek biçimi geçersiz |
| 413 | Numara sayısı veya metin çok fazla |
| 500 | Diğer hata |
| 550 | Gönderim için uygun port yok |
Mesaj uzunluğu ve Türkçe karakter
Türkçe karakterler kullanıldığında bir SMS'e sığan karakter sayısı düşer ve mesaj birden fazla parçaya bölünebilir. Göndermeden önce SMS karakter sayacı ile kontrol edin.
Dikkat edilecekler
- Kimlik bilgileri: Gateway şifresini kaynak koda yazmayın. Ortam değişkeni veya kasa kullanın.
- Erişim: API'yi internete açmayın. Yalnızca izinli IP adreslerinden erişilsin.
- Kontrol katmanı: Yazılım hatasının istenmeyen numaralara SMS atmaması için izinli numara ve port kontrolü ekleyin.
- Limit: Günlük gönderim sınırı koyun. Operatörlerin hat kullanım koşullarını kontrol edin.
- Ticari ileti: Tanıtım amaçlı mesajlarda alıcı onayı ve İYS yükümlülükleri geçerlidir. Hukuk danışmanınızla değerlendirin.
Sıkça sorulan sorular
SMS API kullanmak için yazılımcı gerekir mi?
Basit akışlar için gerekmez. n8n gibi araçlarla kod yazmadan kurulabilir.
Gateway ile firma adıyla SMS gönderilebilir mi?
Hayır. Mesaj SIM kartın numarasından gider. Firma başlığı için SMS sağlayıcısı gerekir.
Gelen SMS'leri yazılıma alabilir miyim?
Evet. Gateway API'si gelen mesajların sorgulanmasını destekler. Ortak SMS Kutusu projemiz bu yapıyı kullanır.
Aynı anda kaç SMS gönderilir?
Port sayısı, SIM kart ve operatör sınırları belirler. Cihazınızı küçük bir test grubuyla deneyin.
Sonuç
SMS API, mesajlaşmayı yazılımın parçası yapar. Hacim ve firma başlığı önemliyse SMS sağlayıcısı, kendi hatlarınızı ve çift yönlü iletişimi yönetmek istiyorsanız GSM Gateway uygundur.
Dinstar GSM Gateway modellerini inceleyin
Doğru cihazı birlikte seçelim
Kurulumunuza uygun Dinstar ürününü belirlemek için ekibimize ulaşın.