SMS VE API

SMS API Nedir? Sistemlere Nasıl Entegre Edilir?

SMS API, yazılım uygulamalarının CloudCell mesajlaşma altyapısına programatik olarak bağlanmasını sağlar.

Bir sipariş oluştuğunda, randevu yaklaştığında, ödeme alındığında veya sistem alarm ürettiğinde tanımlanan SMS otomatik olarak gönderilebilir. Uygulamanız onaylı gönderici başlığı, alıcı numarası ve mesaj metniyle tek bir HTTPS isteği gönderir; teslim durumu sorgulama veya callback ile uygulamanıza geri döner.

Son güncelleme: 1 Ekim 2026 · CloudCell Teknik Ekibi

İSTEK GİDER · RAPOR DÖNER

Paket numarası teslim değildir; teslim durumu ayrıca döner.

Kimlik bilgileri sunucuda kalır, istemciye gönderilmez.

ADIM ADIM

Nasıl çalışır?

Uygulamanızdan alıcının telefonuna ve geri.

İstek

Uygulamanız tek bir HTTPS isteği gönderir

Kimlik doğrulama

Basic Authentication ile

Gönderici başlığı

Onaylı başlık alıcıya görünür

Operatör şebekesi

Mesaj alıcının hattına iletilir

Teslim raporu

Durum uygulamanıza geri döner

TEKNİK BİLGİ

Bir istek nasıl görünür?

Tek uç nokta; tekil, çoklu veya kişiye özel gönderim.

POST https://smsapi.cloudcell.com.tr/sms/create
Authorization: Basic <kullanıcı:parola>
{
  "type": 1, "sendingType": 0,
  "sender": "<ONAYLI_BAŞLIK>",
  "number": "90XXXXXXXXXX",
  "content": "Siparişiniz kargoya verildi.",
  "encoding": 1, "customID": "siparis-0001",
  "pushSettings": {
    "url": "https://<sunucunuz>/sms-rapor"
  }
}

sender: Onaylı gönderici başlığı
pkgID: Rapor sorgusu için paket numarası
customID: Kendi sisteminizdeki kayıt
pushSettings.url: Raporun gönderileceği adres

{ "data": { "pkgID": 0 }, "err": null }

Teslim raporu nasıl geri döner?

İki yol: siz sorgularsınız ya da rapor size gelir.

Sorgulama

pkgID veya customID ile numara bazında durum

Callback

Rapor, belirttiğiniz adrese gönderilir

Ticari ileti ve İYS

Ticari gönderimlerde commercial alanı true girilir ve gönderim İYS kontrolünden geçer. Sipariş, randevu veya ödeme bilgilendirmesi gibi mesajlar bu kontrole takılmaz.

Mesaj uzunluğu

Uzun metin parçalara bölünür.

Kodlamaya göre SMS parça uzunlukları
Kodlama	1 parça	2 parça
Varsayılan	0-155	156-301
Türkçe	0-150	151-293
Unicode	0-65	66-129

Kimler kullanır?

Sipariş bildirimi
Randevu hatırlatma
Ödeme bilgilendirmesi
Sistem alarmı

MERAK EDİLENLER

Sık sorulan sorular

Karar sürecinde en çok merak edilenleri yanıtladık.

Hangi yazılım dilleri desteklenir?

API standart HTTPS ve JSON istekleriyle çalışır; HTTP isteği gönderebilen yazılım dilleriyle kullanılabilir.

Teslim raporlarını sistemimize alabilir miyiz?

Desteklenen callback veya sorgulama yöntemiyle durumlar müşteri uygulamasına aktarılabilir. Durum kodlarının anlamı entegrasyon dokümanında eşleştirilmelidir.

Kimlik bilgilerini nasıl korumalıyız?

Kimlik bilgileri sunucu tarafında ve gizli anahtar kasasında tutulmalı; istemciye gönderilmemeli, erişimi sınırlandırılmalı ve düzenli olarak yenilenmelidir.

SMS'ler firma adıyla gönderilebilir mi?

Evet. Başvuru ve doğrulama süreçleri tamamlandığında mesajlar onaylı kurumsal gönderici başlığınızla gönderilir.

Mesajları ileri bir tarihe planlayabilir miyiz?

Evet. İstekte gönderim tarihi ve saati belirtilerek mesajlar planlanır; büyük paketler dönemsel olarak bölünerek gönderilebilir.

Türkçe karakterler mesaj uzunluğunu etkiler mi?

Evet. Türkçe kodlamada tek parça mesaj 150 karaktere kadardır; daha uzun metinler parçalara bölünür.

İLGİLİ HİZMET

SMS API ve Entegrasyon

Tekil veya toplu mesaj istekleri, mesaj kimliği ve teslim durumu takibi.

Hizmeti incele API dokümantasyonu

BİRLİKTE PLANLAYALIM

Entegrasyon ihtiyacınızı iletin

API dokümantasyonunu inceleyin; kullanım senaryonuzu ve beklenen hacmi paylaşın, entegrasyonu birlikte planlayalım.

Hızlı geri dönüş
Uzman danışmanlık
Size özel teklif

Kullanım senaryosu

Aylık hacim

API dokümantasyonu