Skip to main content

​
Ülke Uyum Gereksinimleri

Mesajlaşma ve ses kuralları ülke bazında belirlenir. Yeni bir pazara göndermeden önce dört şeyi bilmeniz gerekir: o ülkenin hangi gönderici türlerini kabul ettiği (uzun kod mu? alfanümerik Gönderici ID mi? kısa kod mu?), kayıt gerekip gerekmediği, hangi belgeleri sağlamanız gerektiği ve hangi içeriğin kısıtlı olduğu. Bunu yanlış yapmak, yeni bir ülkeye ilk gönderilerin sessizce teslim edilememesinin en yaygın nedenidir. Orbit, bunu kendiniz derlemek zorunda kalmamanız için ülke başına derlenmiş bir düzenleyici başvuru tutar. Bu sayfa, onu nasıl okuyacağınızı açıklar.
Bu başvuru, planlamanıza yardımcı olacak bir kılavuzdur; teslimat garantisi veya hukuki tavsiye değildir. Bir Gönderici ID’sinin veya kaydın nihai onayı, her ülkedeki düzenleyici veya operatör tarafından verilir, Orbit tarafından değil. Kapsam kiracı başına etkinleştirilir — bir ülkenin burada görünmesi, hesabınızda etkin olduğu anlamına gelmez.

​
Bir ülkenin kurallarına bakın

GET /compliance/country-rules, Orbit’in gönderim zamanı kapılarının arkasındaki salt-okunur düzenleyici başvurudur. Kimliği doğrulanmış herhangi bir kullanıcı onu çağırabilir. channel (varsayılan sms) ile ve isteğe bağlı olarak region ile filtreleyin:
Her satır bir ülke × kanal tanımlar:
channel filtresi sms, whatsapp, rcs, voice, email ve viber değerlerini kabul eder. Aynı ülkenin kanal başına ayrı satırları vardır, çünkü farklı kanallar farklı düzenleyicilere bağlıdır — örneğin WhatsApp’ı Brezilya’da Meta’nın WABA kuralları yönetirken SMS’i Anatel’in kuralları yönetir.

​
Her alanı okuma

​
Gönderici türleri

​
registration seviyeleri

registration alanı, lansmandan önce okunacak en önemli değerdir. Orbit’in gönderim zamanı kapısını yönlendirir:
Gönderici ID kaydı gerekmez. Kanal ve ülke hesabınızda etkinleştirildiğinde göndermeye başlayabilirsiniz.
Ülkeye ait onaylı bir Gönderici-ID kaydınız olana kadar trafik engellenir. Onaylı giriş olmadan required bir ülkeye yapılan A2P SMS, gönderim zamanı kapısı tarafından tutulur. Lansmandan önce kaydolun ve onay alın — bkz. Gönderici-ID Kaydı.

​
Her ülkenin beklediği belgeler

Bir ülke kayıt gerektirdiğinde (veya önerdiğinde), destekleyici belgeleri bir kez gönderir ve bir Gönderici ID’si kaydederken bunlara doc_… ID’leriyle başvurursunuz. Tam küme pazara göre değişir, ancak çoğu düzenleyici şunların bir bileşimini ister:
  • İşletme kaydı kanıtı — kuruluş belgesi, işletme lisansı veya eşdeğeri.
  • Bir kullanım-durumu açıklaması — ne gönderdiğiniz (işlemsel, OTP, pazarlama) ve kime gönderdiğiniz.
  • Marka sahipliği / yetkilendirme — kaydettiğiniz Gönderici ID’si / marka adına hak sahibi olduğunuzun kanıtı.
  • Yerel vergi veya düzenleyici ID — kaydı ulusal bir tanımlayıcıya bağlayan pazarlar için.
Ayrıntılar için ülke-kuralları yanıtındaki hedef ülkenin sender_rules ve content_restrictions alanlarını okuyun, ardından kaydı gönderirken eşleşen belgeleri ekleyin. Bazı pazarlar, genel Gönderici-ID akışı yerine kendi özel kayıt düzenlerini işletir:
  • Hindistan — Gönderici ID’leri (“Headers”), içerik şablonları ve izin şablonları TRAI DLT portalı üzerinden kaydedilir. Bkz. DLT-Hindistan Katılımı.
  • Amerika Birleşik Devletleri — A2P SMS göndericileri 10DLC aracılığıyla bir marka ve kampanya kaydeder. Bkz. 10DLC Kayıt kılavuzu.

​
Yeni bir ülke için lansman kontrol listesi

1

Kurallara bakın

Hedef için GET /compliance/country-rules?channel=<channel> çağrısı yapın ve sender_types, registration ve content_restrictions alanlarını okuyun.
2

Kabul edilen bir gönderici türü seçin

O ülkenin sender_types listesinden bir gönderici kimliği seçin — bir alfanümerik Gönderici ID, bir uzun kod, bir kısa kod veya kanal-yerel bir gönderici (WABA / RCS aracısı).
3

Gerekirse kaydolun

registration required (veya recommended) ise, belgelerinizi yükleyin ve Gönderici ID’sini onaya gönderin. Öncü süreyi planlayın — bazı pazarlar günler ile haftalar arasında sürer.
4

İçerik kısıtlamalarını kontrol edin

Kullanım durumunuzun content_restrictions ve Kısıtlı ve Yasak Sektörler ile uyumlu olduğunu doğrulayın ve stop_requirement gerektiriyorsa gerekli vazgeçme anahtar sözcüğünü ekleyin.
5

Yayına alın

Ülke etkinleştirildiğinde, gönderici türü kabul edildiğinde ve gerekli kayıt onaylandığında göndermeye başlayın.

​
Kurallar kaynağını koruma (platform operatörleri)

Bu bölüm platform operatörleri ve kendi barındırılan dağıtımları içindir. api.orbit.devotel.io üzerindeki SaaS müşterileri burada durabilir — Devotel ülke kurallarını sizin için güncel tutar ve aşağıdaki uç noktalar platform yöneticilerine kısıtlıdır.
Ülke-kuralları başvurusu, zamanlanmış yukarı akış senkronizasyonları ve manuel operatör düzenlemeleriyle beslenir. Bu bölüm, onu güncel tutmayı ve tek bir ülkeyi güvenli şekilde düzenlemeyi kapsar. Kurallar tablosuna yazan uç noktalar yalnızca platform yöneticisidir — kiracı sahipleri ve yöneticileri 403 alır, çünkü kurallar tablosu kiracı başına veri değil, tüm kiracılar arasında globaldir.

​
Besleme kaynakları

Her satırın sync_source alanı, onu en son hangi beslemenin yenilediğini kaydeder. Senkronizasyon uç noktasına altı sağlayıcı bağlanır: İki komşu beslemenin kendi tabloları vardır:
  • Eski gönderici-ID matrisi için Telnyx kapsamı — gönderici-ID uyum matrisinin arkasındaki okuma uç noktaları ayrı bir eski tablodan beslenir. POST /api/v1/compliance/admin/sync ile yenileyin (yalnızca yönetici; aynı haftalık zamanlayıcı da onu otomatik olarak yeniler).
  • Yeniden Atanmış Numaralar Veritabanı (RND) — Devre dışı bırakma taraması altında belgelenen ABD bağlantısı kesilmiş numara kapısı. Kiracılar bunu kiracı başına PUT /api/v1/compliance/rnd/settings ile { "enabled": true } kullanarak etkinleştirir; bir operatör dağıtıma bir RND anlık görüntüsü yükleyene kadar düğme açılmayı reddeder, böylece kiracılar boş bir kapıya katılamaz.

​
Yukarı akış senkronizasyonu çalıştırın

POST /api/v1/compliance/country-rules/sync bir sağlayıcıdan yeniler. Beslemeyi ?provider= (varsayılan telnyx) ile seçin ve isteğe bağlı olarak tek bir ?channel= ile sınırlayın.
Yanıt upstreamCount, updated, createdNew ve bir errors dizisi raporlar. Senkronizasyon, operatör tarafından hazırlanan düzyazıyı asla geçersiz kılmaz — yalnızca yapısal alanlar (ülke adı, çağrı kodu, bölge, gönderici türleri, kayıt seviyesi) yenilenir; serbest-metin alanları (sender_rules, content_restrictions, notes) bir operatörün son yazdığı şeyi korur.

​
Besleme sıklığı

İki yol tabloyu güncel tutar:
  • Haftalık zamanlayıcı — webhook-worker’ın compliance-sync adımı Telnyx, MEF ve GSMA beslemelerini otomatik olarak çalıştırır. Ayrıca worker başlangıcında bir kez çalışır, böylece yeni bir dağıtım ilk açılışta kendini doldurur.
  • İsteğe bağlı — yönetici “Refresh from upstream” eylemi, anında çekme için yukarıdaki senkronizasyon uç noktasını çağırır (yeni bir besleme kimlik bilgisi sağladıktan hemen sonra yararlıdır).
Eskilik, okuma uç noktasının satırlarla birlikte döndürdüğü last_synced_at ile denetlenir. Manuel düzenlemeler bunun yerine last_reviewed_at damgası baser, böylece pano tek belirsiz bir zaman damgası yerine kaynak gösterebilir (“MEF’den 3 gün önce senkronize edildi; dün operasyon tarafından gözden geçirildi”).

​
Hata işleme

Her bağlayıcı isteğe bağlı ve fail-open: kimlik bilgisi ortam değişkeni ayarlanmamışsa senkronizasyon bir atlama mesajı kaydeder ve errors içinde bir giriş döndürür, mevcut satırlar ise yerinde kalır. Aynısı bir yukarı akış kesintisinde de geçerlidir — yanıt hata metnini taşırken önceden senkronize edilmiş veriler okunabilir kalır. Bunlar arama yolunda salt-okunur meta veri beslemeleridir; bir besleme kapalıyken giden mesajlaşma normal göndericiniz üzerinden yönlendirilmeye devam eder.
Senkronizasyon sağlayıcıları yalnızca kapsama meta verilerine dokunur. Asla bir taşıma yolu değildirler — giden mesajlaşmayı burada listelenen kapsama beslemelerinden herhangi biri üzerinden yönlendirmeyi denemeyin.

​
Tek bir ülkeyi düzenleme

PUT /api/v1/compliance/country-rules/:channel/:country_code, tek bir ülke × kanal satırını upsert eder (yoksa oluşturur, varsa günceller). Hiçbir beslemenin taşımadığı ayrıntıları sağlamak için kullanın — örneğin düzenleyici metninden alınan STOP anahtar sözcüğü ifadesi veya işlem hızı sınırları. Platform yöneticisi kimlik bilgileri gereklidir; kiracı yöneticileri 403 alır.
Düzenlenebilir alanlar: sender_types, registration (none / recommended / required), sender_rules, content_restrictions, stop_requirement, two_way, dlr_support, default_tps, notes ve sources (bir [{ label, url }] atıf bağlantıları listesi). Upsert, last_reviewed_at damgası basar ve satırı sync_source: manual olarak işaretler, böylece sonraki bir otomatik senkronizasyon yalnızca yapısal alanları yeniler ve düzyazınızı bırakır.

​
Bir ülkeyi canlıya almadan önce doğrulama kontrol listesi

Bir ülkeyi gönderim için açmadan önce şunları doğrulayın:
1

Taze senkronizasyon damgası

last_synced_at (veya eski matris için last_verified_at) yenidir — değilse etkinleştirmeden önce ilgili sağlayıcı için isteğe bağlı senkronizasyonu çalıştırın.
2

Doğru kayıt seviyesi

registration ayarlıdır (none / recommended / required). required bir ülke, kayıtlı olmayan trafiği gönderim zamanında engeller, bu nedenle kaçırılan bir kayıt incelemesi gecikmiş değil, başarısız gönderiler demektir.
3

Düzyazı alanları gözden geçirildi

stop_requirement ve content_restrictions, olması gerekeni söylüyor — beslemeler yalnızca yapıyı yenilediği için düzyazı bir operatör tarafından ayarlanmalıdır.
4

Gönderici türü kabul edildi

Ülkenin sender_types listesinden en az biri, göndermeyi planladığınız şeyle eşleşiyor.
5

İlgili kapılar yüklendi

Hedefin bir RND veya DLT kapısı varsa (ABD RND, Hindistan DLT), bu beslemenin de yüklü olduğunu doğrulayın — bkz. Devre dışı bırakma taraması ve DLT-Hindistan Katılımı.

​
İlgili başvurular