> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SMS — dünya genelinde gönderin ve alın

> Orbit üzerinde SMS'i üretime hazır kurun: gönderici bağlayın, gereken yerde kaydedin, kodlama ve segment maliyetini önceden görün, teslim yaşam döngüsünü okuyun ve gönderi havuzlarıyla ölçeklenin.

# SMS

Orbit'in SMPP geçit altyapısı üzerinden SMS'leri dünya genelinde gönderin.
Orbit, 190'ı aşk ülke boyunca birinci sınıf taşıyıcılar ve toplayıcılarla
bağlanır ve bitim, kodlama ve teslim izini otomatik olarak yönetir.

## Bir SMS gönderin

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

`to` ve `from`, her ikisi de [E.164](https://tr.wikipedia.org/wiki/E.164)
olarak doğrulanır — ülke ködeli tam uluslararası biçim. Orbit'in numaraları
nasıl doğruladığı ve normalleştirdiği
[numara yaşam döngüsünde](/concepts/number-lifecycle) tarif edilir.

### Yanıt

Endnokta **HTTP 202 Accepted** yanıtlar — mesaj kalıcıdır ve teslim için kuye
aldı. `id`, `msg_` ardından 32 küçükaltı hes karakteri içeren bir platform
mesaj kimliğidir; yaşam döngüsünü [teslim webhook'ları](/webhooks/overview)
üzerinden izleyin.

```json theme={null}
{
  "data": {
    "id": "msg_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
    "status": "queued",
    "channel": "sms",
    "segments": 1,
    "encoding": "GSM-7"
  }
}
```

`segments` ve `encoding`'i her gönderide okuyun — fatura bunları kullanır.

## Teslim edilebilirlik temelleri

SMS teslim edilebilirliği üç şeye dayanır, bu sırayla: **kimden gönderdiğiniz**,
**nereden**, ve **ne kadar hızlı**. Kayıtı olmayan bir gönderici taşıyıcı
tarafından bir segmente mal olmadan önce süzünebilir.

### Gönderici türü seçin

| Gönderici türü                            | En iyisi                                                                    | Kısıtlama                                                                                                                                   |
| ----------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Alfabetik gönderici-ID'si** (`MyBrand`) | Marka tanılaması; rakımsal gönderici-ID'lerinin bastırılmış olduğu pazarlar | Birçok ülkede kayıt gerekli; yanıt desteklemez (tek yol)                                                                                    |
| **Rakımsal uzun kod** (`+14155550123`)    | İki yönlü SMS, yanıtlar, konuşan destek                                     | Ÿeteğideyetabilirlik ülkeye göre farklılaır (ABD: tam yeteğideyetabilirlik için [10DLC](#10dlc-kaydı--kampanya-türleri-abd)'de kayıt edin) |
| **Kısa kod** (`12345`)                    | Yyüksek yeteğideyetabilirlik kampanyaları, akıl telugu OTP gönderileri      | Uzun taşıyıcı lider süresi, daha yüksek maliyet                                                                                             |
| **Gönderici havuzu**                      | Yüksek hacim, yerel varlık, kötüleşen göndericilerın dönüşü                 | Bkz: [gönderici havuzları](/guides/sender-pools)                                                                                            |

Hedef ülkenizin hangi kayıt gerektirdiğini
[ülkeye uyum gereksinimleri](/compliance/country-requirements) listeler.

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

ABD hedeflerine rakımsal uzun kodlar üzerinden gönderiyorsanız, taşıyıcılar
kayıt gerektirir; kayıtsız trafik süzünebilirveya ücretlendirilir. Orbit
kayıtı The Campaign Registry üzerinden sizin adınıza sunar — tam yürütme
(marka → kampanya → onay → yetıkatellihaç sabitleri)
[10DLC Kaytı kılavuzunda](/guides/10dlc-registration).

ABD'ye özgü nokta: kayıttan sonraki yetıkatellihaç, **günte ve numara başına
segment sınırı** olarak marka vetting puanınıza göre verilir — saniye başına
oranı değil. Alfabetik gönderici-ID'lerine başlayan ABD değil hedefler için
(Avrupa'nın çoğu, Brezilya, Bangladeş, APAC'in parçaları) paralel akış
[Gönderici-ID kaydı](/compliance/sender-id-registration). Hindistan
istisnayı: gönderici-ID'leri ("Başlıklar") DLT/TRAI üzerinden kayıt edilir —
bkz [DLT Hindistan heyet](/compliance/dlt-india).

## Kodlama ve bitimşekil

Kodlama, doğru kayıtlı bir gönderici sağlıklı maliyet tek değişeni. SMS
segment başına ücretlendirilir ve segment sayısı tamamen gövde hangi alfabeye
uyduğuna bağlıdır.

### GSM-7 ve UCS-2

* **GSM-7** — 7-bit GSM alfabesi (ASCII artı birkaç ekstra: `@`, `£`, `€`,
  birkaç Yunanca). Uyduğu bir gövde **segment başına 160 karakter** alabilir veya
  çok parçalı gönderide **153 karakter** (segment başına 7 karakter UDH
  bitimşekil başlığına gider).
* **UCS-2** — GSM-7 dışında her karakter (emoji, CJK, akıllı alıntı işaretleri,
  çoğu Latince olmayan yazı) mesajı 16-bit kodlamaya italkleriye çevirir.
  Gövde **segment başına 70 karakter** alabilir, çok parçalıda **67**.

Tek bir GSM-7 olmayan karakter tüm mesajı yeniden sınıflandırır. Orbit
kazara işgalçilerı normalleştir — yapıştırılmış akıllı alıntı işaretleri, en
düzgün, katlı apostrofiler, görünmez sıfır-genişlik karakterleri — sayımadan önce
GSM-7-gövenilir eşDavranıklarınedõller ve yapıya hatası faturanızı iki katına
alar. Kodlama ve bölümleme modeli tam olarak
[SMS segmentleri ve kodlama kavramında](/concepts/sms-segments-and-encoding).

### Çalıştırılmış örnek

`Siparişiniz sevk edildi — yanıta EVET` — 30 karakter, tamamı GSM-7 → **1
segment, `GSM-7`**. Tek emojı alfabesiye çevirir; 160 karakterlik bir ASCII
bületeni hemen **2 UCS-2 segmentin** olur. Sert sınır: **10 segment** (1.530
GSM-7 karakter veya 670 UCS-2 karakter); ötesinde kesilir ve
`wasTruncated: true` işaretli.

## Durum yaşam döngüsü

Her çıkbinden SMS "status" taşıyandır ve ilerler:

`queued` → `sending` → `sent` → `delivered` (veya `failed` / `undelivered` /
`rejected` / `expired`)

Geçişlere [webhook'lar](/webhooks/overview) üzerinden abone olun (`message.sent`,
`message.delivered`, `message.failed` etkinlikleri). İşletenleri yakalayan
figmeler:

* `submitted_no_receipt` — sağlayıcı gönderiyi kabul etti; 30 dakikalık SMPP
  lutfu pencere içinde DLR gelmedi. *Sonuç bilinmeyen* olarak işletir.
* `expired` — gaiyatış kapıdıktan sonra DLR geldi; satır kapalı.
* `rejected` — gönderici kapısı: eksik kayıt veya içerik politikası.
  Kapı temizlenene kadar belirlensel.

Konsept durum makinası [Teslim yaşam döngüsü](concepts/delivery-lifecycle);
başarısızlık işletme [Sorun görtmek: mesaj teslim edilmedi veya başarısız](/troubleshooting/message-undelivered-failed).

## Fiyatlandırma

SMS fiyatı segment başına ve hedef ülkeye göre değişir. [Fiyat sayfası](https://orbit.devotel.io/pricing) veya
`GET /api/v1/pricing/messaging?country=<ISO>` endnoktasından gerçek zamanlı
oranı kontrol edin. Kodlama bir UCS-2'ye geçtiğinde aynı iki gönderi farklı
üçrettir — bkz [Kodlama ve bitimşekil](#kodlama-ve-bitimsekha).

## Hız sınırları

SMS gönderileri varsayılan olarak **kiracı başına 100 istek/dakika** ile
sınırlıdır; sınır kiracı (organizasyon) başına anahtarlanır, IP veya plan
değil. Aşmak `429 RATE_LIMITED` verir; bkz [Hız sınırları kılavuzu](/guides/rate-limits).
Her kanalın varsayılan sınırları (SMS 100, WhatsApp 80, E-posta 200, Faks 20 vb.)
organizasyon mesaj yapılandırmanızda `channel_rate_overrides` üzerinden
kanal başına yükselebilir.

## Özellikler

* **A2P ve P2P mesaj** — uygulama-kişi ve kişi-kişi
* **Dünya genelinde erişim** — Devotel'in toplayıcı ağı üzerinden 190'ı aşk
  ülke
* **Teslim raporları** — her mesaj için gerçek zamanlı durum webhook'ları
* **Bitimlenmiş mesajlar** — çok parçalı SMS tam hazillessel olarak işletir
  (10 segmene kadar)
* **E.164 doğrulama** — telefon numarası biçimi otomatik doğrulama
* **Unicode desteği** — GSM-7 ve UCS-2 kodlama otomatik tespit ve akıllı
  biçim işareti normalleştirmesiyle
