> ## 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.

# Devotel Orbit sözlüğü: mesajlaşma, ses ve akış terimleri

> Mesajlaşma, ses, WhatsApp, akışlar, doğrulama, numaralar ve gözlemlenebilirlik genelinde geliştiriciler ve operasyon ekipleri için temel Orbit terimleri ve tanımları.

# Sözlük

Devotel Orbit belgelerinde ve müşteri iletişimi ekosisteminde kullanılan temel terimlerin tanımları. Orbit, 9 aaS sütununu (CPaaS, CCaaS, UCaaS, AIaaS, NaaS, CSPaaS, RTC PaaS, CXaaS, CDPaaS) tek çatı altında birleştiren Agentic Customer Communications Cloud platformudur.

> **Dil ve İngilizce yedekleme politikası:** API adları, HTTP durum kodları, hata kodları (`INVALID_PHONE_NUMBER`, `422 HIPAA_BAA_REQUIRED`), webhook başlıkları (`X-Orbit-Signature`), payload özellikleri (`queued`, `pending_compliance`, `delivered`), CLI komutları ve API yolları (`/api/v1/...`) doğrudan aranabilmeleri, SDK uyumluluğu ve global API sözleşmesi gereği her zaman kanonik İngilizce biçiminde korunur. Burada henüz yer almayan veya daha derinlemesine teknik detay içeren maddeler için [İngilizce tam sözlük](/reference/glossary) referans alınmalıdır.

## Hızlı bağlantılar

* [İngilizce tam sözlük](/reference/glossary) — tüm kanonik tanımlar, derinlemesine mimari notlar ve global referanslar.
* [Hata kodları referansı](/reference/error-codes) — hata kodları, yeniden deneme (retry) sınıfları ve çözüm adımları.
* [Sorun giderme merkezi](/tr/reference/troubleshooting-hub) — kuyruklar, webhook teslimatı, uyumluluk ve ses inceleme rehberleri.
* [Sıkça Sorulan Sorular (SSS)](/tr/reference/faq) — Orbit platformu, kanallar ve mimari hakkında sık sorulan sorular.

***

## A

**A2P (Application-to-Person / Uygulamadan Kişiye)**\
Bir yazılım uygulamasından gerçek bir kişiye gönderilen mesaj trafiği. Bildirimler, güvenlik kodları (OTP), sistem uyarıları ve pazarlama kampanyalarını içerir. Bireyler arasındaki kişisel iletişim olan **P2P (Person-to-Person)** ve kullanıcının işletmeye mesaj attığı **P2A (Person-to-Application)** modellerinden farklı kurallara ve taşıyıcı düzenlemelerine tabidir.

**Agent (Yapay Zeka Temsilcisi)**\
Orbit platformunda müşteri konuşmalarını yöneten veya iş akışlarını otonom olarak yürüten yapay zeka destekli asistan. LLM modelleri, araçlar (tools) ve güvenlik sınırları (guardrails) kullanarak ses ve mesajlaşma kanallarında son kullanıcılarla doğrudan iletişim kurar.

**Agentic CCC (Agentic Customer Communications Cloud)**\
Devotel Orbit'in temel kategori tanımı: İnsan odaklı çağrı merkezi yazılımlarının ötesine geçen, 9 temel aaS sütununu (CPaaS, CCaaS, UCaaS, AIaaS, NaaS, CSPaaS, RTC PaaS, CXaaS, CDPaaS) otonom AI ajanları etrafında birleştiren bütünleşik bulut iletişim platformu.

**API Key (API Anahtarı)**\
Orbit REST API isteklerini doğrulamak için kullanılan kimlik doğrulama belirteci. `dv_live_sk_` (canlı gizli anahtar), `dv_test_sk_` (test gizli anahtar), `dv_live_pk_` (canlı genel anahtar) veya `dv_test_pk_` (test genel anahtar) önekleriyle tanımlanır.

***

## B

**BAA (Business Associate Agreement / İş Ortaklığı Sözleşmesi)**\
HIPAA kapsamındaki korunan sağlık verilerinin (PHI) işlenmesi öncesinde kiracı (tenant) ile Devotel Orbit arasında akdedilen sözleşme. BAA imzalanana kadar platformun HIPAA modu aktif edilemez ve PHI etiketli kitlelere mesaj gönderimi `422 HIPAA_BAA_REQUIRED` hatasıyla engellenir. Bu kontrol kiracı yönetimindedir.

**BYOC (Bring Your Own Carrier / Kendi Operatörünü Getir)**\
Mevcut telekom operatörü anlaşmalarınızı, numaralarınızı ve ara bağlantı tarifelerinizi korurken Orbit'in uygulama katmanını (IVR, çağrı kuyrukları, mesajlaşma akışları ve analitik) kullanmanızı sağlayan esnek bağlantı modeli. Orbit operatörünüze ses için SIP trunking, SMS için SMPP üzerinden bağlanır.

***

## C

**CPaaS (Communications Platform as a Service / Hizmet Olarak İletişim Platformu)**\
Geliştiricilerin doğrudan telekom altyapısı kurmasına veya işletmesine gerek kalmadan; API'ler ve SDK'lar aracılığıyla uygulamalarına gerçek zamanlı ses, SMS, mesajlaşma ve video özellikleri eklemesini sağlayan bulut altyapısı.

**CCaaS (Contact Center as a Service / Hizmet Olarak Çağrı Merkezi)**\
Müşteri destek ve satış operasyonlarını bulutta yürüten yazılım paketi. Akıllı çağrı dağıtımı (ACD), sesli yanıt sistemleri (IVR), temsilci durumu yönetimi ve koçluk araçları sunar.

**Consent Receipt (Rıza Makbuzu)**\
Kullanıcının verdiği iletişim veya veri işleme iznini kanıtlayan, değiştirilemez ve kriptografik olarak imzalanmış dijital kayıt. DPDP ve GDPR gibi veri koruma regülasyonlarına uyum için denetim izi sunar.

***

## D

**DLR (Delivery Receipt / Teslimat Raporu)**\
Bir SMS, MMS veya WhatsApp mesajı gönderildikten sonra mobil operatör veya mesajlaşma ağ geçidi tarafından dönülen durum geri bildirimi (callback). Mesajın aboneye ulaştığını (`delivered`), başarısız olduğunu (`undelivered`, `failed`) veya hatta beklediğini asenkron olarak doğrular.

**DID (Direct Inward Dialing / Doğrudan Dahili Arama Numarası)**\
Dahili veya santral operatörüne gerek kalmadan doğrudan aranabilen bağımsız telefon numarası. Orbit üzerinde hem sesli arama karşılama/başlatma hem de iki yönlü SMS/MMS trafiğinde kaynak veya hedef kimliği olarak kullanılır.

**DLQ (Dead-Letter Queue / İşlenemeyen Mesaj Kuyruğu)**\
Tüm yeniden deneme (retry) aşamalarını tüketen veya hedef sunucunun kalıcı hataları (`401`, `403`, `404`) nedeniyle teslim edilemeyen webhook bildirimlerinin toplandığı güvenli kurtarma havuzu. DLQ üzerindeki olaylar 7 gün boyunca saklanır ve API veya panel üzerinden yeniden tetiklenebilir (`replay`).

***

## E

**E.164**\
Uluslararası telefon numaralandırma standardı. E.164 formatındaki bir numara başında `+` işareti, ardından 1-3 haneli ülke kodu ve abone numarasını içerir (örneğin: `+905551234567` veya `+14155552671`). Boşluk, parantez veya tire içermez ve en fazla 15 basamaktan oluşur. Orbit API'lerine gönderilen tüm telefon numaraları bu formatta olmalıdır.

***

## F

**Flow (Akış)**\
Görsel akış düzenleyicide yapılandırılan yeniden kullanılabilir otomasyon dizisi. Bir tetikleyici (ör. gelen mesaj, web kancası), bir dizi işlem adımı (mesaj gönderme, AI ajanına devretme, bekleme) ve koşullu dallanmalardan oluşur.

**Frequency Cap (Gönderim Sıklığı Sınırı)**\
Belirli bir alıcıya belirli bir zaman aralığında (rolling window) gönderilebilecek maksimum mesaj sayısını sınırlayan kiracı denetimli kural. Kampanya veya API gönderimlerinde alıcıların mesaj bombardımanına tutulmasını engeller.

***

## H

**Handoff (Temsilciye Devir)**\
Bir canlı görüşmenin veya sohbetin otonom AI ajanından bir insan müşteri temsilcisine veya başka bir özelleşmiş ajana tüm geçmiş bağlamıyla birlikte aktarılması işlemi.

**HMAC-SHA256**\
Orbit tarafından gönderilen webhook bildirimlerinin bütünlüğünü ve kaynağını doğrulamak için kullanılan kriptografik imzalama algoritması. İmza, HTTP isteklerinde `X-Orbit-Signature` başlığı altında taşınır.

***

## I

**Idempotency (Eşgüçlülük / Idempotency-Key)**\
Ağ kesintisi veya istemci yeniden denemelerinde aynı API isteğinin (`POST`) mükerrer kaynak oluşturmasını veya ikinci kez ücretlendirilmesini önleyen mekanizma. İstemci `Idempotency-Key` başlığıyla benzersiz bir anahtar iletir; platform aynı anahtarla gelen yinelenen isteklerde işlemi tekrar yürütmek yerine önbelleğe alınmış yanıtı döndürür.

**IVR (Interactive Voice Response / Sesli Yanıt Sistemi)**\
Arayan kişiye sesli menüler sunan, DTMF tuşlamaları veya konuşma tanıma (NLU) ile yanıt toplayan ve çağrıyı uygun kuyruğa, temsilciye ya da sesli asistana yönlendiren otomatik telefon menü katmanı.

***

## M

**MO/MT (Mobile Originated / Mobile Terminated)**\
Mobil şebeke referans alınarak tanımlanan mesaj yönü:

* **MO (Mobile Originated):** Cihazdan şebekeye giden mesaj — müşterinin işletmeye gönderdiği gelen mesaj (P2A). Orbit tarafında gelen webhook'ları tetikler.
* **MT (Mobile Terminated):** Şebekeden cihaza giden mesaj — işletmenin müşteriye ilettiği giden bildirim veya yanıt (A2P).

**Message Status Lifecycle (Mesaj Durum Yaşam Döngüsü)**\
Bir giden mesajın kabul edilmesinden nihai sonuca kadar geçtiği durum dizisi:
`queued` (kuyrukta) → `sent` (operatöre/ağ geçidine iletildi) → `delivered` (cihaza teslim edildi) veya `undelivered` / `failed` (teslim edilemedi / başarısız). Gecikmeli veya belirsiz durumlar için `submitted_no_receipt` ve `expired` durumları kullanılır.

***

## O

**Opt-In / Opt-Out (İzin Verme / İptal Etme)**\
Son kullanıcının ticari elektronik ileti almayı kabul etmesi (`opt-in`) veya abonelikten çıkması (`opt-out`) süreci. SMS için global standart anahtar kelimeler `STOP`, `UNSUBSCRIBE` (çıkış) ve `START`, `UNSTOP` (yeniden abone olma) şeklindedir. Çıkış talepleri platformda otomatik olarak bastırma listesine (`Suppression list`) kaydedilir ve yeni gönderimler engellenir.

***

## Q

**Quiet Hours (Sessiz Saatler)**\
Alıcıların yerel saat dilimine göre gece geç saatlerde veya yasal olarak yasaklanmış zaman aralıklarında otomatik pazarlama mesajlarının iletilmesini engelleyen veya erteleyen kiracı denetimli zaman penceresi kuralı.

***

## R

**RAG (Retrieval-Augmented Generation / Geri Getirme Destekli Üretim)**\
Yapay zeka modellerinin yanıt üretirken yalnızca genel eğitim verilerine güvenmek yerine, kiracıya ait harici bilgi bankalarından (Knowledge Base) ilgili döküman parçalarını sorgulayarak doğru ve güncel bağlamla yanıt vermesini sağlayan mimari.

**RCS (Rich Communication Services)**\
SMS ve MMS'in yerini alan modern operatör mesajlaşma standardı. Doğrulanmış kurumsal gönderici profili, zengin medya kartları, döngüsel slaytlar (carousels), önerilen işlem butonları ve okundu bilgileri sunar.

***

## S

**Sender ID (Gönderici Kimliği)**\
Alıcının telefonunda mesajın veya aramanın kaynağı olarak görünen kimlik. Uzun numara (Long Code), kısa kod (Short Code) veya desteklenen ülkelerde alfanümerik metin (Alphanumeric Sender ID, ör. `DEVOTEL`) biçiminde olabilir. Alfanümerik başlıklar tek yönlü bildirimler içindir ve birçok ülkede ön kayıt gerektirir.

**Suppression List (Bastırma / Engelleme Listesi)**\
Abonelikten çıkan (`opt-out`), kalıcı hata veren (`hard bounce`) veya spam şikayetinde bulunan adres ve telefon numaralarının tutulduğu liste. Kiracı bazlı çalışır ve bu listedeki numaralara mesaj gönderimi engellenerek gönderici itibarı ve yasal uyumluluk korunur.

***

## T

**10DLC (10-Digit Long Code)**\
Amerika Birleşik Devletleri ve Kanada'da kurumsal A2P SMS/MMS trafiği için standartlaştırılmış 10 haneli yerel numara sistemi. The Campaign Registry (TCR) üzerinden marka ve kullanım senaryosu (kampanya) kaydı gerektirir; kayıtlı numaralar yüksek iletim hızından (throughput) ve operatör filtreleme muafiyetlerinden yararlanır.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.