​

SMS

​

SMS gönderin

curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
  -H "X-API-Key: dv_test_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+18005551234",
    "body": "Orbit'ten merhaba!"
  }'

import { Devotel } from '@devotel-orbit/node';

const orbit = new Devotel({ apiKey: process.env.ORBIT_API_KEY });

// Yalnızca gövdeli kanallar genel tiplenmiş yardımcı üzerinden yönlendirilir.
const message = await orbit.messages.send({
  channel: 'sms',
  to: '+14155552671',
  from: '+18005551234',          // açık gönderici — kiracı varsayılanını kullanmak için atlayın
  body: 'Orbit'ten merhaba!',
});

console.log(message.data.id);      // msg_a1b2…
console.log(message.data.status);  // 'queued'

// SDK yok mu? Düz fetch de sorun değil — istek şekli aynen taşınır.
const res = await fetch('https://api.orbit.devotel.io/api/v1/messages/sms', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.ORBIT_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    to: '+14155552671',
    from: '+18005551234',
    body: 'Orbit'ten merhaba!',
  }),
});
const { data } = await res.json();
console.log(data.id, data.status); // aşağıdaki curl yanıtıyla aynı zarf

from orbit_sdk import OrbitClient

client = OrbitClient.from_env()  # ORBIT_API_KEY okur

message = client.messages.send_sms(
    to="+14155552671",
    body="Orbit'ten merhaba!",
    from_="+18005551234",  # açık gönderici — kiracı varsayılanını kullanmak için atlayın
)

print(message["data"]["id"])       # msg_a1b2…
print(message["data"]["status"])   # 'queued'

msg, err := client.Messages().SendSMS(context.Background(), orbit.SendSMSInput{
    To:   "+14155552671",
    Body: "Orbit'ten merhaba!",
    From: "+18005551234",  // açık gönderici — kiracı varsayılanını kullanmak için atlayın
})
if err != nil {
    panic(err)
}

fmt.Println(msg.Data.ID)      // msg_a1b2…
fmt.Println(msg.Data.Status)  // "queued"

# Tiplenmiş SDK'sı olmayan diller için ham HTTP kaçış kapağı — başlık ve
# JSON gövdesi ayarlayabildiği sürece her istemci veya kütüphane iş görür.
send = client.request(
    "POST",
    "/messages/sms",
    json_body: {
        to: "+14155552671",
        from: "+18005551234",
        body: "Orbit'ten merhaba!",
    },
)

puts send.dig("data", "id")       # msg_a1b2…
puts send.dig("data", "status")   # 'queued'

​

Yanıt

{
  "data": {
    "id": "msg_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
    "status": "queued",
    "channel": "sms",
    "segments": 1,
    "encoding": "GSM-7"
  },
  "meta": {
    "request_id": "req_sms_send",
    "timestamp": "2026-03-08T00:00:00Z"
  }
}

• Node.js / fetch (TypeScript) — SDK veya res.json() dönüş değeri zarfı taşır: message.data.id, message.data.status.
• Python — send_sms ham JSON gövdesini dict olarak döndürür: message["data"]["id"], message["data"]["status"].
• Go — SendSMS zarfı tiplenmiş bir struct’a çözer: msg.Data.ID, msg.Data.Status.
• Ruby / PHP (kaçış kapağı) — client.request ham JSON gövdesini döndürür: send.dig("data", "id") / $send['data']['id'].

​

Yaygın kalıplar

​

Idempotency-Key ile idempotent gönderim

const message = await orbit.messages.send(
  { channel: 'sms', to: '+14155552671', body: 'Orbit'ten merhaba!' },
  { idempotencyKey: 'job-7a3b9d-checkout-reminder' },  // yeniden denemeler arasında sabit anahtar
);

message = client.messages.send_sms(
    to="+14155552671",
    body="Orbit'ten merhaba!",
    idempotency_key="job-7a3b9d-checkout-reminder",  # yeniden denemeler arasında sabit anahtar
)

​

SDK liste çağrılarıyla GET /messages sayfalama

// İmleç döngüsü — açık denetim.
let cursor: string | undefined;
do {
  const page = await orbit.messages.list({ channel: 'sms', limit: 100, cursor });
  for (const message of page.data) {
    // her yinelemede bir mesaj tüketin
  }
  cursor = page.meta.pagination.has_more
    ? page.meta.pagination.cursor
    : undefined;
} while (cursor);

// …ya da sayfalamayı yineleyiciye bırakın:
for await (const message of orbit.messages.iter({ channel: 'sms' })) {
  console.log(message.id, message.status);
}

# Python SDK yalnızca çekirdek kaynakları sarar — `json_body` yanında bir
# `query` dict'i kabul eden kaçış kapağıyla sayfalayın.
cursor = None
while True:
    query = {"channel": "sms", "limit": 100}
    if cursor:
        query["cursor"] = cursor
    page = client.request("GET", "/messages", query=query)
    for message in page["data"]:
        # her yinelemede bir mesaj tüketin
        pass
    pagination = page["meta"]["pagination"]
    if not pagination.get("has_more"):
        break
    cursor = pagination["cursor"]

​

Çalışılmış örnek: gönderin, sorgulayın, hataları yönetin

​

1. Mesajı gönderin

curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+18005551234",
    "body": "Orbit'ten merhaba 🚀 — normalleştirilmiş metin: burada 160 karakter iki UCS-2 segmenti olurdu"
  }'

​

2. Gönderim yanıtını okuyun

{
  "data": {
    "id": "msg_e4d5c6b7a8b9c0d1e2f3a4b5c6d7e8f9",
    "status": "queued",
    "channel": "sms",
    "segments": 2,
    "encoding": "UCS-2"
  },
  "meta": {
    "request_id": "req_xK9f3m2h",
    "timestamp": "2026-09-06T12:00:00Z"
  }
}

​

3. Satırı sorgulayın

curl https://api.orbit.devotel.io/api/v1/messages/msg_e4d5c6b7a8b9c0d1e2f3a4b5c6d7e8f9 \
  -H "X-API-Key: dv_live_sk_your_key_here"

{
  "data": {
    "id": "msg_e4d5c6b7a8b9c0d1e2f3a4b5c6d7e8f9",
    "channel": "sms",
    "direction": "outbound",
    "to": "+14155552671",
    "from": "+18005551234",
    "status": "delivered",
    "segments": 2,
    "encoding": "UCS-2",
    "external_id": "dev-smpp-e9a8b7c6",
    "sent_at": "2026-09-06T12:00:01Z",
    "error_code": null,
    "error_message": null,
    "metadata": {}
  },
  "meta": {
    "request_id": "req_poll_002",
    "timestamp": "2026-09-06T12:00:02Z"
  }
}

​

4. Hatalara göre dallanın

​

SMS teslim edilebilirliği temelleri

​

Gönderici türü seçin

​

Gösterge tablosu üzerinden başlangıç

1. Gösterge tablosunda Channels → SMS açın.
2. Attach Sender tıklayın ve yukarıdan bir gönderici türü seçin. Orbit biçimi doğrular (E.164 numarası, 3–11 alfanümerik ID veya havuz referansı) ve varsayılan seçtiğiniz hedefin kayıt gerektirip gerektirmediğini kontrol eder.
3. Sahip olduğunuz bir numaraya bir test mesajı gönderin. Düzenleyici segments ve encoding’i satır içi gösterir, bu yüzden göndermeden önce tahmini segment başına maliyeti görürsünüz.
4. Hedef kapınız bağlamayı reddederse (10DLC kampanyasız ABD, gönderici-ID onayı olmayan kapılı ülke), sihirbaz sizi kayıt akışına yönlendirir — sonraki iki bölüme bakın.

​

10DLC kaydı & kampanya türleri (ABD)

​

Kodlama ve birleştirme

​

GSM-7 karşı UCS-2

• GSM-7 — 7 bit GSM alfabesi (ASCII artı birkaç ekstra: @, £, €, biraz Yunanca). Ona uyan bir gövde segment başına 160 karaktere kadar alır veya çok parçalı gönderimde 153 karakter (7’si segment başına UDH birleştirme başlığına gider).
• UCS-2 — GSM-7 dışındaki herhangi bir karakter (emoji, CJK, kıvrık tırnaklar, çoğu Latin dışı yazı) tüm mesajı 16 bit kodlamaya çevirir. Bir gövde segment başına 70 karaktere kadar alır, çok parçalıda 67.

segments = ceil(chars / per_segment_limit)
per_segment_limit = single_limit         tek segmente sığıyorsa
                  = single_limit - header  aksi halde      (GSM-7: 153, UCS-2: 67)

​

Çalışılmış örnek

{
  "segments": 2,
  "encoding": "UCS-2"
}

​

Hız sınırları, kapasite ve gönderici havuzları

1. API tarafı istek sınırı. POST /messages/sms’te kiracı başına varsayılan 100 istek/dakika, kuruluş başına anahtarlanır. Üzerinde 429 RATE_LIMITED alırsınız; başlıklar ve yeniden deneme işlemi için Hız Sınırları kılavuzu sayfasına bakın. Kanal başına tam tablo aşağıdadır.
2. Gönderici tarafı kapasite. ABD 10DLC: vetting katmanınızın belirlediği günlük, numara başına segment sınırı. Başka yerlerde: hedefin rotasının gönderici başına desteklediği şey.

​

Mesaj durum yaşam döngüsü

• submitted_no_receipt — sağlayıcı gönderimi kabul etti, 30 dakikalık SMPP ölü süresi penceresi içinde DLR geri gelmedi. Ara (is_terminal: false) olarak etiketlenir, çünkü geç bir delivered veya hata DLR’si hâlâ gelebilir ve üzerine yazabilir. Onu sonuç bilinmiyor olarak değerlendirin; teslim değil, hata değil.
• expired — geç gelme penceresi kapandıktan sonra bir DLR geldi. Kapalı satır, sonuç bilinemez; message.failed üzerinden fan-out olur.
• cancelled — yalnızca sizin tarafınızdan ulaşılabilir; onun için hiçbir webhook ateşlenmez.

​

Sorun giderme

​

Fiyatlandırma

​

Özellikler

• A2P ve P2P mesajlaşma — uygulamadan kişiye ve kişiden kişiye destek
• Küresel erişim — Devotel’in toplayıcı ağı üzerinden 190’dan fazla ülke
• Teslim raporları — her mesaj için gerçek zamanlı durum webhook’ları
• Birleştirilmiş mesajlar — çok parçalı SMS şeffaf olarak işlenir (10 segmente kadar)
• E.164 doğrulama — otomatik telefon numarası biçim doğrulaması
• Unicode desteği — otomatik algılama ve akıllı noktalama normalleştirmesiyle tam GSM-7 ve UCS-2 kodlama
• Gönderici ID — yerel düzenlemelerin desteklediği yerlerde alfanümerik gönderici ID’leri, gerektiğinde kayıt kapılı

​

Hız Sınırları