Bir mesajlaşma markası kaydetme

Mesajlarınızın arkasındaki işletmeyi kaydedin

Bir mesajlaşma markası, ABD 10DLC mesajlarını gönderen işletmeyi tanımlar. Bir kampanya kullanım senaryosu seçmeden önce markayı kaydedin. İşletmenin yasal bilgilerini ve gerekli her doğrulamayı tamamlayabilecek bir iletişim kişisini kullanın. Döndürülen bir marka kimliği, tek başına, mesaj gönderme onayı değildir.

Bu mevcut hesaba ait rotayı, etkin bir API hesabı ve izin verilen kaynak IP adresi ile HTTPS üzerinden kullanın. user_id, username veya başka bir müşterinin sahip tanımlayıcısını göndermeyin. MultiTEL, sahipliği kimliği doğrulanmış hesaptan kaydeder.

Açık bir sandbox isteğiyle başlayın

Portal, formundaki mode alanını varsayılan olarak sandbox değerine ayarlar; doğrudan bir API isteği, sahte (mock) bir marka amaçladığınızda JSON boolean mock: true değerini açıkça içermelidir. Bu bayrağın atlanması bir sandbox garantisi değildir ve ücretlendirilebilir bir üretim kaydı oluşturabilir. Portalın mode alanı, API'nin mock alanının yerine geçmez.

Aşağıdaki alanları kullanarak yerel bir brand.json dosyası hazırlayın. Yer tutucuları uygun test bilgileri ve güncel katalog kodlarıyla değiştirin. Bu örnek özel kâr amaçlı bir işletmedir; diğer tüzel kişilik türlerinin gereksinimleri farklıdır.

{
  "entityType": "PRIVATE_PROFIT",
  "displayName": "Example business",
  "companyName": "Example legal business name",
  "ein": "YOUR_TAX_ID",
  "einIssuingCountry": "US",
  "phone": "+12025550123",
  "street": "123 Example Street",
  "city": "Example City",
  "state": "NY",
  "postalCode": "10001",
  "country": "US",
  "email": "contact@example.invalid",
  "brandRelationship": "BASIC_ACCOUNT",
  "vertical": "CURRENT_VERTICAL_CODE",
  "referenceId": "your-business-reference",
  "mock": true
}

Yukarıdaki işletme, adres, telefon ve tanımlayıcı birer yer tutucudur, kayda hazır bir işletme kimliği değildir. entityType, vertical, country, state, brandRelationship ve diğer numaralandırmalar için güncel değerleri şuradan alın: mesajlaşma katalogları.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data-binary @brand.json \
  'https://api.multitel.net/tcr/v2/brand/nonBlocking'

İşletme ve iletişim alanları

Şahıs işletmesi sahipleri ABD veya Kanada kayıtları için desteklenir ve kampanya uygunluğundan önce OTP doğrulaması gerektirir. Halka açık şirketler bir işletme iletişim doğrulama adımı gerektirebilir. GOVERNMENT, ABD merkezli kamu kurumları içindir; diğer kuruluşlar için doğru tüzel kişilik kategorisini teyit edin. Tüzel kişiliğe özgü gereksinimlere ve döndürülen doğrulama hatalarına uyun.

Kararlı bir idempotency anahtarı koruyun

Bu amaçlanan kayıt için tek bir Idempotency-Key oluşturun. Boşluk içermeyen 1–128 yazdırılabilir ASCII karakterden oluşmalıdır. Aynı anahtarı yalnızca aynı HTTP yöntemi, yol, sorgu dizesi ve birebir aynı istek gövdesi baytlarıyla yeniden kullanın. JSON'u yeniden biçimlendirmek, anlamını değiştirmese bile istek parmak izini değiştirir.

Tamamlanmış anahtarlı bir istek, yeni bir kayıt gönderimi olmadan saklanan yanıtını yeniden oynatabilir. Hâlâ işlenmekte olan bir yineleme HTTP 409 döndürür ve Retry-After içerebilir. Aynı anahtarla değiştirilmiş bir istek çakışır. Sırf bir istek zaman aşımına uğradı veya hata döndürdü diye yeni bir anahtar oluşturmayın: işletme zaten kaydedilmiş olabilir.

Bu isteği çözümlerken brand.json dosyasını değiştirmeden tutun. Önbelleğe alınmış bir 500 veya 502, kaydı yeniden denemek yerine özgün hatayı yeniden oynatabilir. Döndürülen brandId, requestId ve korelasyon başlıklarını saklayın; farklı bir isteğe başlamadan önce mevcut markayı mutabakata bağlayın.

Markayı ve durumunu okuyun

Bu API, v3 status/response zarfı yerine HTTP durum kodlarını ve doğrudan bir JSON gövdesi kullanır. Başarılı kayıt, brandId içeren bir marka nesnesi döndürür. Bu tanımlayıcıyı saklayın ve döndürülen doğrulama veya kimlik durumunu inceleyin. Ek alanlar tüzel kişiliğe ve kayıt durumuna bağlıdır.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID"

Yalnızca hesabınıza ait bir markayı okuyun. Bir 404, markanın bu hesap için kullanılabilir olmadığı anlamına gelebilir. Gerekli her doğrulamayı tamamlayın, ardından kullanılabilir kampanya kullanım senaryolarını bulmak için marka yeterliliği işlevini kullanın. Sahte (mock) kaynakların üretim gönderimi için uygun olduğu varsayılamaz.

Üretim ücretleri

Bu perakende tutarları 24 Ekim 2026 tarihinde mevcut portal yapılandırmasına göre kontrol edildi. Üretim kaydından önce güncel ücreti portalda teyit edin. Kampanya ücretleri, ek inceleme ve mesajlaşma kullanımı ayrıdır. Bir üretim kaydı, gönderimden önce satın alma iznini ve kullanılabilir bakiyeyi denetler; markanın kayıt sisteminde başarıyla oluşturulması ve yerel faturalandırma ayrı işleme adımlarıdır, bu nedenle kaynak kimliğini saklayın ve bir hata veya faturalandırma sorunu oluşursa işlemleri mutabakata bağlayın.

Sahte (mock) bir markayı üretime değiştirmek ayrıca onaylanan bir iş akışıdır ve yeni bir üretim kimliği ile ücret oluşturabilir. Sonraki bir istekte mock değerini false olarak düzenlemenin mevcut markayı dönüştürdüğünü varsaymayın.

Hataları markayı çoğaltmadan ele alın