Gönderici-ID Kaydı

Alfasayısal Gönderici ID, SMS’te telefon numarası yerine “kimden” olarak görünen kısa bir marka adıdır (örneğin MyBrand). Birçok ülke, onu kullanan trafik teslim edilmeden önce Gönderici ID’sini yerel düzenleyiciye veya operatörlere kaydetmenizi ister — ve bazıları kaydedilmemiş alfasayısal göndericileri doğrudan engeller. Orbit, Gönderici-ID kayıtlarınızı ülke bazında kaydetmenize, destekleyici KYC belgelerini eklemenize ve her ülkenin onay durumunu izlemenize olanak tanır. Gönderi zamanı kapıları, trafiğin yalnızca Gönderici ID’sinin onaylı olduğu yerlere akmasını sağlar. Aşağıdaki tüm uç noktalar https://api.orbit.devotel.io/api/v1/compliance kökündedir.

Orbit’te bir Gönderici ID’si kaydetmek, onu uyum iş akışımıza gönderir; nihai onay her ülkedeki düzenleyici/operatör tarafından verilir, platform tarafından anında değil. Önden süre planlayın — bazı piyasalar günler ila haftalar sürer.

Gönderici-ID biçim kuralları

Kural	Değer
Uzunluk	3–11 karakter
İzin verilen karakterler	harfler, rakamlar, boşluk, kısa çizgi (`-`), alt çizgi (`_`)

11 karakter tavanı, GSM 7-bit sabit sınırıdır; ANATEL (Brezilya), OFCOM (BK), AGCOM (İtalya) ve BTRC (Bangladeş) gibi düzenleyiciler 3 karakterden kısa Gönderici ID’lerini reddeder.

Gönderici ID kaydetme veya güncelleme

POST /compliance/sender-id-registrations (yönetici/sahip) bir Gönderici ID’sini bir veya daha fazla ülke için gönderir. Her ülke girişi, önceden yüklenmiş uyum belgelerine doc_… ID’leriyle başvurur — dosyaları burada yüklemezsiniz.

curl -X POST https://api.orbit.devotel.io/api/v1/compliance/sender-id-registrations \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": "MyBrand",
    "countries": [
      {
        "country": "BR",
        "document_refs": ["doc_abc123def456"],
        "notes": "Retail brand, transactional + OTP use case"
      }
    ]
  }'

Alan	Tür	Notlar
`sender_id`	string	3–11 karakter, yukarıdaki biçim kurallarına bakın.
`countries`	array	1–20 giriş.
`countries[].country`	string	ISO-3166-1 alpha-2 (büyük harf).
`countries[].document_refs`	string[]	Önceden yüklenmiş KYC belgelerine başvuran `doc_…` biçiminde 1–20 ID.
`countries[].registration_provider_id`	string	İsteğe bağlı aşağı akış/sağlayıcı referansı (≤ 200).
`countries[].notes`	string	İsteğe bağlı serbest metin, örneğin kullanım durumu (≤ 2000).

Her ülkenin status değerini içeren kayıt görünümünü döndürür:

{
  "data": {
    "id": "sidreg_xyz",
    "sender_id": "MyBrand",
    "countries": [
      {
        "country": "BR",
        "status": "pending",
        "document_refs": ["doc_abc123def456"],
        "registered_at": null,
        "expires_at": null,
        "registration_provider_id": null,
        "notes": "Retail brand, transactional + OTP use case"
      }
    ]
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}

Gönderim, (organization, sender_id) üzerinde anahtarlanmış bir idempotent upserttir. Yeniden gönderim:

yeni ülkeleri status: pending olarak ekler;
zaten approved olan bir ülke için, belgelerini, sağlayıcı referansını ve notlarını yenilerken onayı korur;
rejected veya expired olan bir ülkeyi yeniden incelenmesi için pending’e sıfırlar.

Bu, mevcut bir Gönderici ID’sine, elinizde tuttuğunuz onayları kaybetmeden güvenle ülke eklemenize olanak tanır.

Kayıtlarınızı listeleme

GET /compliance/sender-id-registrations her Gönderici ID’sini ve ülke bazındaki durumunu döndürür. Kimliği doğrulanmış her kullanıcıya açıktır.

{
  "data": {
    "entries": [
      {
        "id": "sidreg_xyz",
        "sender_id": "MyBrand",
        "countries": [
          {
            "country": "BR",
            "status": "approved",
            "document_refs": ["doc_abc123def456"],
            "registered_at": "2026-06-05T00:00:00.000Z",
            "expires_at": "2027-06-05T00:00:00.000Z"
          }
        ]
      }
    ],
    "total": 1
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}

Durum yaşam döngüsü

Durum	Anlam
`pending`	Gönderildi, inceleme/onay bekliyor.
`approved`	Onaylandı — bu Gönderici ID’siyle trafiğe ülke için izin verilir.
`rejected`	Reddedildi; sorunu düzeltin ve `pending`’e sıfırlamak için yeniden gönderin.
`expired`	Kaydın geçerlilik penceresi kapandı; yenilemek için yeniden gönderin.

Bir ülke girişi approved olduğunda registered_at ve expires_at taşır. Kesinti yaşamamak için expires_at öncesinde yenileyin.

Gönderi zamanı kapıları kaydı uygular: kayıtlı bir Gönderici ID’si gerektiren bir ülkeye A2P SMS, o ülkenin girişi approved olmadıkça engellenir. Yeni bir piyasaya trafik başlatmadan önce kaydedin ve onay alın.

Gönderici-ID geçişinden önce oluşturulan kiracılarda liste uç noktası boş bir küme döndürür ve POST 409 TENANT_NOT_MIGRATED döndürür — özelliği etkinleştirmek için destekle iletişime geçin.

Hindistan farklıdır

Hindistan bu genel Gönderici-ID akışını kullanmaz. Hindistan SMS Gönderici ID’leri (“Headers”) DLT/TRAI sistemi üzerinden kaydedilir — bkz. DLT-Hindistan Katılımı.

İlgili başvurular

KYC Belgeleri ve Uyum-Profili Yaşam Döngüsü — burada başvurduğunuz doc_… ID’lerini nasıl yükleyeceğiniz, profiller arasında nasıl yeniden kullanacağınız ve süreleri dolmadan önce nasıl yenileyeceğiniz.
Ülke Uyum Gereksinimleri — her ülkenin hangi gönderici türlerini kabul ettiği, kaydın gerekli olup olmadığı ve sağlanacak belgeler.
Katı gönderici-ID modu reddetmelerini giderme — katılıma bağlı gönderici-biçimi kapısı ve ihlal eden bir göndericide döndürdüğü kural kodları.
DLT-Hindistan Katılımı — Hindistan için Gönderici-ID (“Header”) kaydı.
Send Gates — gönderi zamanında kaydı uygulayan ülke kuralları ve kapılar.
İzin Yönetimi — Gönderici-ID uyumuyla eşleşen izin katmanı.
API Başvurusu → Uyum — tam istek/yanıt şemaları (canlı API’den yeniden oluşturulur).

Getting Started

Channels

Channels (Voice)

AI Agents

Flows

Numbers & Verify

Concepts

Features

Billing

Webhooks

Security & SSO

Compliance

Legal

Changelog

Gönderici-ID Kaydı

Gönderici-ID Kaydı

Gönderici-ID biçim kuralları

Gönderici ID kaydetme veya güncelleme

Kayıtlarınızı listeleme

Durum yaşam döngüsü

Hindistan farklıdır

İlgili başvurular

​Gönderici-ID Kaydı

​Gönderici-ID biçim kuralları

​Gönderici ID kaydetme veya güncelleme

​Kayıtlarınızı listeleme

​Durum yaşam döngüsü

​Hindistan farklıdır

​İlgili başvurular

Gönderici-ID Kaydı

Gönderici-ID biçim kuralları

Gönderici ID kaydetme veya güncelleme

Kayıtlarınızı listeleme

Durum yaşam döngüsü

Hindistan farklıdır

İlgili başvurular