> ## 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. # ABD A2P mesajlaşma uyumu için 10DLC kaydı > Orbit üzerinden ABD 10 Haneli Uzun Kod (10DLC) mesajlaşma uyumu için markanızı ve kampanyalarınızı kaydederek A2P kapasitesi ve operatör teslim edilebilirliği elde edin. # 10DLC Kaydı 10DLC (10 Haneli Uzun Kod), standart 10 haneli telefon numaraları kullanarak Uygulamadan Kişiye (A2P) SMS mesajları göndermek için ABD operatörleri tarafından zorunlu tutulan sistemdir. ABD numaralarına SMS gönderen tüm işletmeler, teslim edilebilirlik ve uyum sağlamak için 10DLC üzerinden kayıt olmalıdır. ## Genel Bakış ABD operatörleri (T-Mobile, AT\&T, Verizon) A2P mesajlaşma için 10DLC kaydını zorunlu tutar. Kayıtlı olmayan trafik şunlarla karşılaşır: * **Agresif filtreleme** — mesajlar sessizce engellenir * **Daha yüksek ücretler** — kayıtlı olmayan gönderenler için mesaj başına ek ücretler * **Düşük kapasite** — kayıtlı iken 75+ mesaj/saniyeye karşılık \~1 mesaj/saniye ile sınırlıdır Orbit, kayıt sürecini The Campaign Registry (TCR) üzerinden yürütür. **Önerilen akış:** [10DLC kayıt sihirbazını](/guides/10dlc-wizard) kullanın — sürdürülebilir bir taslak kaydeder, marka ve kampanya bölümlerini istediğiniz sırayla doldurmanıza izin verir, tek sahibi (sole-proprietor) telefonunu OTP ile doğrular ve her ikisini de atomik olarak gönderir. Aşağıdaki doğrusal uç noktalar, betikleştirilmiş iş akışları için kullanılabilir durumda kalır. *** ## Kayıt Adımları ### Adım 1: Markanızı Kaydedin Organizasyonunuzu temsil eden bir marka kimliği oluşturun. ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/brand \ -H "X-API-Key: dv_live_sk_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "entity_type": "PRIVATE_PROFIT", "display_name": "Acme Corp", "company_name": "Acme Corporation Inc.", "ein": "12-3456789", "phone": "+14155551234", "street": "1 Market St", "city": "San Francisco", "state": "CA", "postal_code": "94105", "country": "US", "email": "compliance@acme.com", "website": "https://acme.com", "vertical": "TECHNOLOGY" }' ``` `entity_type`, `PRIVATE_PROFIT`, `PUBLIC_PROFIT`, `NON_PROFIT`, `GOVERNMENT` veya `SOLE_PROPRIETOR` değerlerinden biri olmalıdır. `display_name`, `company_name`, `phone`, `street`, `city`, `state`, `postal_code` ve `email` zorunludur; `ein` ve `website` isteğe bağlıdır. **Yanıt (`201 Created`):** ```json theme={null} { "data": { "brandId": "BXXXXXX", "status": "PENDING" }, "meta": { "request_id": "req_abc123", "timestamp": "2026-03-08T12:00:00Z" } } ``` Marka denetimi genellikle 24–48 saat içinde tamamlanır. ### Adım 2: Bir Kampanya Oluşturun Mesajlaşmanız için belirli kullanım durumunu kaydedin. Göndermeden önce — marka + kampanya yükünüzü [ön kontrol linter'ına](#gonderinizi-on-kontrolden-gecirin) karşı çalıştırın. Deterministik TCR reddetmelerini (eksik abonelikten çıkma ifadesi, kısaltıcı bağlantılar, kullanım durumu tekrarı) bunları düzeltmek hâlâ ücretsizken yakalar. Reddedilen her gönderim yeni bir denetim ücretine mal olur ve 1–5 iş günlüğü inceleme saatini yeniden başlatır. ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/campaign \ -H "X-API-Key: dv_live_sk_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "brand_id": "BXXXXXX", "usecase": "CUSTOMER_CARE", "description": "Sending order updates and support responses to customers who opted in on our website checkout form.", "sample_message": [ "Your order #12345 has shipped! Track at https://acme.com/track/12345", "Hi! Your support ticket #567 has been resolved. Reply STOP to unsubscribe." ], "message_flow": "Customers opt in via a web form at checkout and confirm consent. They can reply STOP at any time to opt out.", "help_message": "Reply HELP for assistance or contact support@acme.com.", "optout_message": "You have been unsubscribed and will receive no further messages." }' ``` `description` en az 40 karakter, `message_flow` en az 40 karakter ve hem `help_message` hem de `optout_message` en az 20 karakter olmalıdır. `sample_message`, 1–10 temsili mesajdan oluşan bir dizidir. Siyasi dikey kampanyalar (`POLITICAL_ADVOCACY` veya `POLLING_AND_VOTING` değerli `usecase` ya da `is_political: true`) ayrıca bir Campaign Verify `cv_token` gerektirir. **Yanıt (`201 Created`):** ```json theme={null} { "data": { "campaignId": "CXXXXXX", "status": "PENDING" }, "meta": { "request_id": "req_def456", "timestamp": "2026-03-08T12:05:00Z" } } ``` ### Adım 3: Onayı Bekleyin Kampanya incelemesi 1–5 iş günü sürer. Durumu kontrol edebilirsiniz: ```bash theme={null} curl https://api.orbit.devotel.io/api/v1/compliance/10dlc/campaigns/CXXXXXX/status \ -H "X-API-Key: dv_live_sk_your_key_here" ``` **Yanıt:** ```json theme={null} { "data": { "campaignId": "CXXXXXX", "status": "APPROVED", "brandId": "BXXXXXX", "mnoStatuses": { "10017": "APPROVED", "10035": "APPROVED", "10095": "REVIEW" }, "provider": "telnyx" }, "meta": { "request_id": "req_ghi789", "timestamp": "2026-03-09T09:00:00Z" } } ``` Üst düzey `status`, CSP düzeyindeki karardır. `mnoStatuses`, operatör başına onay haritasıdır (anahtarlar MNO operatör kimlikleridir — ör. `10017` T-Mobile, `10035` AT\&T, `10095` Verizon); bir kampanya, ayrı bir operatörde hâlâ `REVIEW` durumundayken CSP düzeyinde `APPROVED` olabilir. **Durumlar:** | Durum | Açıklama | | ---------- | ------------------------------------------------------ | | `PENDING` | Gönderildi, operatör incelemesi bekleniyor | | `APPROVED` | Onaylandı — gönderime başlayabilirsiniz | | `FAILED` | Reddedildi — ayrıntılar için `rejectionReason`'a bakın | ### Adım 4: Gönderime Başlayın Onaylandıktan sonra, kayıtlı numaralardan gönderilen mesajlar tam 10DLC kapasitesi ve teslim edilebilirlik alır. Bir dosyalama `FAILED` dönerse, bir denetim puanı katmanınızı sınırlarsa veya onaylı bir kampanyanın gerçekten sahip olduğu kapasiteye ihtiyacınız varsa — [10DLC reddetmeleri ve yeniden denetim kılavuzu](/guides/10dlc-rejections-and-revet) kod çözücüyü, yeniden denetimi ve kapasite uç noktalarını kapsar. *** ## Gönderinizi Ön Kontrolden Geçirin TCR reddetmelerinin çoğu deterministiktir — aynı içerik ve eksiklik kalıpları, ilk gönderimleri tekrar tekrar takar. Her reddetme, yeni bir denetim ücreti (yeniden gönderim başına $4–$15) yakar ve 1–5 iş günlü inceleme saatini yeniden başlatır. Orbit, **göndermeden önce** marka + kampanya yükünüzü bilinen reddetme kalıbı kataloğuna karşı puanlayan bir ön kontrol linter'ı ile gelir ve alan başına bulgular döndürür — her biri bir önem derecesi, tam sorunlu metin parçası ve somut bir yeniden yazma önerisi içerir. `POST /api/v1/compliance/10dlc/preflight` Linter saf bir kural motorudur: TCR'ye hiçbir şey gönderilmez, hiçbir şey saklanmaz ve hiçbir başvuru oluşturulmaz. Organizasyondaki herhangi bir rol çağrabilir — `numbers:write` kapsamı gerekmez. Marka ve kampanya nesnelerini tam olarak göndermeyi planladığınız şekilde gönderin, ayrıca zaten sahip olduğunuz bir `brand_vetting_score` (0–100) varsa isteğe bağlı olarak ekleyin: ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/compliance/10dlc/preflight \ -H "X-API-Key: dv_live_sk_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "brand": { "display_name": "Acme Corp", "entity_type": "PRIVATE_PROFIT", "ein": "12-3456789", "email": "compliance@acme.com", "website": "https://acme.com" }, "campaign": { "usecase": "MARKETING", "description": "Acme sends weekend promotional offers to customers who opt in on our checkout page.", "sample_message": [ "Acme: 20% off today. Shop at https://bit.ly/acme-sale" ], "message_flow": "Customers opt in at checkout. They can reply STOP at any time to opt out.", "help_message": "Reply HELP for assistance or email support@acme.com.", "optout_message": "You are unsubscribed. Reply STOP to opt out.", "expected_msg_per_day_per_number": 5000 }, "brand_vetting_score": 45 }' ``` **Yanıt (`200 OK`):** ```json theme={null} { "data": { "score": 61, "verdict": "block", "findings": [ { "ruleId": "R-CAMP-SAMPLE-SHORTENER", "severity": "error", "field": "campaign.sample_message[0]", "message": "Public URL shortener detected. Carriers auto-reject shortener domains in sample messages.", "match": "bit.ly", "suggestion": "Replace the shortener with a link on your own domain (e.g. acme.com/sale)." }, { "ruleId": "R-CAMP-SAMPLES-COUNT", "severity": "warn", "field": "campaign.sample_message", "message": "Only one sample message provided. TCR vets 2-10 distinct samples covering your real traffic.", "suggestion": "Add distinct samples (welcome, reminder, confirmation) so TCR sees the full campaign." }, { "ruleId": "R-CAMP-SAMPLE-CTA-STOP", "severity": "warn", "field": "campaign.sample_message[0]", "message": "Sample message does not reference STOP. Carriers expect opt-out wording in at least one sample.", "match": "Acme: 20% off today.", "suggestion": "Append \"Reply STOP to unsubscribe.\" to the sample." }, { "ruleId": "R-CAMP-THROUGHPUT-TIER", "severity": "warn", "field": "campaign.expected_msg_per_day_per_number", "message": "Declared throughput exceeds the daily cap your vetting tier qualifies for.", "suggestion": "Lower the declared volume or raise your vetting score to qualify for a higher tier." } ], "engine": "tcr-preflight/v1" }, "meta": { "request_id": "req_pf001", "timestamp": "2026-08-28T09:00:00Z" } } ``` **Yanıt şekli.** `score` `0`–`100` aralığındadır (`100` = bilinen hiçbir kalıp eşleşmedi; her bulgu önem derecesine göre puan düşürür). `verdict` toplam karardır — herhangi bir `error` bulgusu varken `block`, 75 puanının altında `warn`, aksi takdirde `pass`. Her `findings[]` girdisi kararlı bir `ruleId`, bir `severity` (`error` | `warn` | `info`), uygulandığı nokta-yolu `field`, bir insan özeti, tam sorunlu metni içeren isteğe bağlı bir `match` (UI'nızdaki vurgulama için) ve bir `suggestion` — bulguyu çözen bir yeniden yazma — taşır. `engine`, kural motoru sürümüdür (`tcr-preflight/v1`), böylece puanları zaman içinde ilişkilendirebilirsiniz. Bir `pass` kararı "bilinen reddetme kalıbı eşleşmedi" demektir — "TCR onaylayacak" değil. Linter, reddetmelerin deterministik çoğunluğunu yakalar; gönderiminiz yine normal operatör incelemesinden geçer. O bir danışmandır, asla bir kapı değil: ne zaman göndereceğinize siz karar verirsiniz. ### 10DLC linter'ı neyi kontrol eder Katalog, TCR ve operatörlerin reddettiği kalıpları kodlar. Anahtar kurallar: | Kural ID | Önem | Ne yakalar | | ----------------------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------- | | `R-BRAND-EIN` | error | EIN biçimi geçerli bir ABD vergi kimliği şekliyle eşleşmiyor | | `R-BRAND-EMAIL-DOMAIN` | warn | Operatörlerin değersiz gördüğü ücretsiz sağlayıcı etki alanında e-posta (gmail.com vb.) | | `R-BRAND-WEBSITE` | warn | Web sitesi eksik veya genel, markalı bir URL değil | | `R-CAMP-DESC-LEN` / `R-CAMP-DESC-GENERIC` | error | Açıklama çok kısa veya kullanım durumu adını aynen tekrarlıyor | | `R-CAMP-SAMPLES-COUNT` | warn | Çok az örnek mesaj — linter ayrıca `Hi {{firstName}}` gibi yer tutucu metinleri de işaretler (`R-CAMP-SAMPLE-PLACEHOLDER`) | | `R-CAMP-SAMPLE-SHAFT` | error | Örneklerde SHAFT-C içeriği (seks, nefret, alkol, ateşli silahlar, tütün, esrar) — otomatik reddetme kategorileri | | `R-CAMP-SAMPLE-BLOCKLIST` | error | Operatör içerik engel listesi ifadeleri (MEF / UCC §3.4) — kısa kod linter'ı ile paylaşılan katalog | | `R-CAMP-SAMPLE-SHORTENER` | error | Genel URL kısaltıcıları (bit.ly, t.co, tinyurl.com …) — operatörler otomatik reddeder | | `R-CAMP-SAMPLE-CLICK-HERE` | warn | Hedef adı olmayan belirsiz "buraya tıklayın" | | `R-CAMP-SAMPLE-CTA-STOP` | warn | Hiçbir örnek STOP abonelikten çıkma ifadesini belirtmiyor | | `R-CAMP-HELP` / `R-CAMP-OPTOUT` | error | `help_message` / `optout_message` kanonisk anahtar kelime setini içermiyor | | `R-CAMP-FLOW` | error | `message_flow` eksik veya genel (TCR'nin en sert denetlediği abone olma akışı) | | `R-CAMP-AI-USECASE` | warn | AI kullanım durumu açıklamasını atlayan AI tabanlı kampanya | | `R-CAMP-THROUGHPUT-TIER` | warn | Beyan edilen günlük hacim, `brand_vetting_score`'un hak kazandığı sınırı aşıyor | Her bulguyu önem sırasına göre düzeltin, yanıt temiz olana kadar linter'ı yeniden çalıştırın (`verdict: "pass"`), ardından aynı yükü [Adım 2](#adim-2-bir-kampanya-olusturun) üzerinden gönderin. *** ## Kullanım Durumu Türleri Kampanya oluştururken (Adım 2) `usecase` alanına bu değerlerden birini geçirin. TCR kodları **büyük harf**tir — bunları tam gösterildiği gibi gönderin; küçük harfli bir değer kayıtta reddedilir. | Kullanım Durumu | Açıklama | Kapasite | | ----------------------------- | ----------------------------------------------------------------------------------- | ------------------------------- | | `CUSTOMER_CARE` | Hesap desteği, hizmet yanıtları ve uyarılar | Denetim puanına göre belirlenir | | `MARKETING` | Promosyonlar, teklifler ve satış erişimi | Denetim puanına göre belirlenir | | `ACCOUNT_NOTIFICATION` | Hesap değişiklikleri, faturalandırma ve güvenlik bildirimleri | Denetim puanına göre belirlenir | | `DELIVERY_NOTIFICATION` | Sipariş, kargo ve teslimat güncellemeleri | Denetim puanına göre belirlenir | | `TWO_FACTOR_AUTH` | Tek kullanımlık parolalar ve 2FA doğrulamaları | Denetim puanına göre belirlenir | | `POLLING_AND_VOTING` | Anketler ve oylama (siyasi kampanyalar ayrıca bir Campaign Verify token gerektirir) | Denetim puanına göre belirlenir | | `PUBLIC_SERVICE_ANNOUNCEMENT` | Kamu yararı duyuruları | Denetim puanına göre belirlenir | | `CHARITY` | Kayıtlı 501(c)(3) kar amacı gütmeyen mesajlaşma | Azaltılmış (501(c)(3) şeridi) | | `EMERGENCY` | Güvenlik ve kamu uyarı mesajlaşması | Operatör önceliği | | `MIXED` | Tek kampanyada birden fazla kullanım durumu (varsayılan) | Azaltılmış günlük sınır | *** ## Kapasite Katmanları 10DLC kapasitesi, saniye başına oran değil, **günlük, numara başına** mesaj-segment sınırı olarak verilir. Katmanınız marka denetim puanınız (0–100) ve kayıtlı varlık türünüz tarafından belirlenir. Her katmanın günlük sınırı kampanyaya atanan her numaraya uygulanır, böylece toplam kampanya kapasitesi atanan numara sayısıyla ölçeklenir. | Katman | Uygunluk | Numara başına günlük sınır | | ------------------- | ----------------------------------------------- | -------------------------- | | Sole Proprietor | `SOLE_PROPRIETOR` varlık türü | \~1.000 msg/gün | | Low Volume Standard | Temel (puanı olmayan markalar dahil, her marka) | \~30.000 msg/gün | | Standard | 50 ve üzeri denetim puanı | \~200.000 msg/gün | | Top Tier | 75 ve üzeri denetim puanı | \~2.000.000 msg/gün | Sınırlar T-Mobile varsayılanlarını yansıtır; AT\&T ve Verizon kabaca %10 içindedir. Denetim puanınızın hak kazandığı en yüksek katman size verilir. Henüz puanı olmayan bir marka, varsayılan olarak Low Volume Standard temel çizgisine oturur. EIN, web sitesi ve hisse senedi sembolü (halka açıksa) dahil olmak üzere eksiksiz, doğru marka bilgileri sağlayarak denetim puanınızı yükseltin. 75 veya daha yüksek bir puan Top Tier günlük sınırını açar. *** ## Uyum Gereksinimleri 1. **Abone olma rızası.** Göndermeden önce her alıcıdan açık rıza almanız gerekir. 2. **Abonelikten çıkma işleme.** STOP isteklerini derhal uygulayın. Orbit STOP, CANCEL ve UNSUBSCRIBE'ı otomatik olarak işler. 3. **Mesaj içeriği.** Örnek mesajlar gerçek trafiği temsil etmelidir. 4. **Tutarlı kullanım.** Yalnızca kayıtlı kampanya kullanım durumunuzla eşleşen mesajlar gönderin. *** ## Panel Üzerinden Kayıt Tüm 10DLC kaydını Orbit paneli üzerinden de tamamlayabilirsiniz: 1. **Ayarlar > Uyum > 10DLC** yoluna gidin 2. **Marka Kaydet** seçeneğine tıklayın ve şirket ayrıntılarınızı doldurun 3. Marka onaylandıktan sonra **Kampanya Oluştur** seçeneğine tıklayın 4. Kullanım durumunuzu seçin, örnek mesajlar ekleyin ve numaralar atayın 5. Operatör incelemesi için gönderin *** ## Ülke Kuralı Beslemesi Yapılandırması Bu bölüm **platform operatörleri / kendi barındırmalı dağıtımlar** içindir. `api.orbit.devotel.io` üzerindeki SaaS müşterilerinin bunları ayarlaması gerekmez — Orbit 10DLC ülke kurallarını sizin için güncel tutar. Orbit, kanonik ABD-10DLC ülke kurallar kümesini (gönderen türleri, kapasite duruşu, kayıt gereksinimi) **iconectiv TCR iş ortağı beslemesinden** çekerek güncel tutar. Bağlayıcı `@devotel/compliance/country-rule-feeds` altında yaşar ve iki yerde çalışır: * **İstendiğinde** — yönetici "Upstream'ten yenile" eylemi (`POST /api/v1/compliance/country-rules/sync?provider=iconectiv`). * **Haftalık** — webhook-worker'ın uyum-sync zamanlayıcısındaki otomatik yenileme işareti. Bağlayıcı **isteğe bağlı ve fail-open**'dur: kimlik bilgileri ayarlanmadığında bir hata kaydeder ve atlar, mevcut ülke kurallarını yerinde bırakır. Yalnızca okunur bir meta veri beslemesidir — asla bir mesaj taşıma yolu değildir, dolayısıyla giden SMS yine Devotel softswitch'i üzerinden çıkar. | Değişken | Zorunlu | Açıklama | | ------------------------ | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `DEVOTEL_TCR_API_KEY` | besleme için | iconectiv TCR iş ortağı API anahtarı. Ayarlanmadığında bağlayıcı atlar. | | `DEVOTEL_TCR_PARTNER_ID` | besleme için | iconectiv TCR iş ortağı kimliği (iş ortağı API'sindeki yol segmenti). Ayarlanmadığında bağlayıcı atlar. | | `DEVOTEL_TCR_FEED_URL` | isteğe bağlı | İş ortağı API'si için temel URL geçersiz kılması. Varsayılan `https://csp-api.campaignregistry.com` şeklindedir. | | `DEVOTEL_TCR_OPTOUT_URL` | isteğe bağlı | DNC abonelikten çıkma çekmesini yürüten TCR Universal Opt-Out kayıt uç noktasının tam URL'sini geçersiz kılar. Varsayılan `/v1/partner//universalOptOuts` şeklindedir. Yalnızca okunur — asla bir gönderim yolu değildir. | Beslemenin çalışması için hem `DEVOTEL_TCR_API_KEY` hem de `DEVOTEL_TCR_PARTNER_ID` ayarlanmalıdır; ikisinden biri eksikse bağlayıcı hiçbir şey yapmaz. Bu kimlik bilgilerini almak için [iconectiv.com](https://iconectiv.com/) adresinde Devotel'i TCR iş ortağı olarak kaydedin. *** ## Sorun Giderme | Sorun | Çözüm | | --------------------------- | ---------------------------------------------------------------------------------------------------------- | | Marka reddedildi | EIN'nin IRS kayıtlarıyla tam olarak eşleştiğini doğrulayın | | Kampanya reddedildi | Örnek mesajların seçilen kullanım durumuyla eşleştiğinden ve abonelikten çıkma dili içerdiğinden emin olun | | Düşük denetim puanı | Eksiksiz marka bilgileri sağlayın (web sitesi, hisse senedi sembolü, tam yasal ad) | | Mesajlar hâlâ filtreleniyor | Kampanya durumunun `approved` olduğunu ve numaraların atandığını doğrulayın | 10DLC kaydı olmadan yüksek hacimli SMS göndermek, operatör filtrelemesi, mesaj engelleme ve olası numara askıya alınmasıyla sonuçlanabilir.