Daftarkan brand pengiriman pesan

Daftarkan bisnis di balik pesan Anda

Brand pesan mengidentifikasi bisnis yang mengirim pesan US 10DLC. Daftarkan brand sebelum memilih kasus penggunaan kampanye. Gunakan rincian resmi bisnis dan kontak yang dapat menyelesaikan validasi yang diperlukan. ID brand yang dikembalikan bukanlah persetujuan untuk mengirim pesan.

Gunakan rute milik akun terkini ini melalui HTTPS dengan akun API yang diaktifkan dan alamat IP sumber yang diizinkan. Jangan kirimkan user_id, username atau pengenal pemilik pelanggan lain. MultiTEL mencatat kepemilikan dari akun yang diautentikasi.

Mulai dengan permintaan sandbox yang eksplisit

Formulir portal secara baku menggunakan mode sandbox; permintaan API langsung harus secara eksplisit menyertakan boolean JSON mock: true ketika Anda bermaksud membuat brand tiruan. Menghilangkan tanda tersebut bukan jaminan sandbox dan dapat membuat pendaftaran produksi yang dapat ditagih. Kolom mode portal bukan pengganti kolom mock API.

Siapkan berkas brand.json lokal menggunakan kolom di bawah ini. Ganti nilai contoh dengan rincian pengujian yang sesuai dan kode katalog terkini. Contoh ini adalah bisnis laba swasta; jenis entitas lain memiliki persyaratan berbeda.

{
  "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
}

Bisnis, alamat, telepon, dan pengenal di atas adalah nilai contoh, bukan identitas bisnis yang siap didaftarkan. Dapatkan nilai terkini untuk entityType, vertical, country, state, brandRelationship dan enumerasi lain dari katalog pengiriman pesan.

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'

Kolom bisnis dan kontak

Pemilik tunggal didukung untuk pendaftaran US atau Kanada dan memerlukan verifikasi OTP sebelum memenuhi syarat kampanye. Perusahaan publik dapat memerlukan langkah validasi kontak bisnis. GOVERNMENT hanya untuk entitas pemerintah berbasis US; konfirmasikan kategori entitas yang benar untuk organisasi lain. Ikuti persyaratan khusus entitas serta kesalahan validasi yang dikembalikan.

Pertahankan kunci idempotensi yang stabil

Buat satu Idempotency-Key untuk pendaftaran yang dimaksudkan ini. Kunci harus berisi 1–128 karakter ASCII yang dapat dicetak tanpa spasi. Gunakan kembali kunci yang sama hanya dengan metode HTTP, jalur, string kueri, dan byte isi permintaan yang sama persis. Memformat ulang JSON, meskipun tanpa mengubah maknanya, akan mengubah sidik jari permintaan.

Permintaan berkunci yang telah selesai dapat memutar ulang respons yang tersimpan tanpa pengajuan pendaftaran lain. Duplikat yang masih diproses mengembalikan HTTP 409 dan dapat menyertakan Retry-After. Permintaan yang diubah dengan kunci yang sama akan berkonflik. Jangan buat kunci baru hanya karena permintaan habis waktu atau mengembalikan kesalahan: bisnis tersebut mungkin sudah terdaftar.

Biarkan brand.json tidak berubah selama menyelesaikan permintaan tersebut. Kesalahan 500 atau 502 yang di-cache dapat memutar ulang kesalahan asli alih-alih mencoba ulang pendaftaran. Simpan brandId, requestId yang dikembalikan dan header korelasi; periksa status brand yang sebenarnya dan selesaikan ketidaksesuaian sebelum memulai permintaan yang berbeda.

Baca brand dan statusnya

API ini menggunakan kode status HTTP dan isi JSON langsung, bukan amplop v3 status/response. Pendaftaran yang berhasil mengembalikan objek brand yang mencakup brandId. Simpan pengenal tersebut dan periksa status validasi atau identitas yang dikembalikan. Kolom tambahan bergantung pada entitas dan status pendaftaran.

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

Baca hanya brand milik akun Anda. Kesalahan 404 dapat berarti brand tidak tersedia untuk akun ini. Selesaikan validasi yang diperlukan, lalu gunakan kualifikasi brand untuk menemukan kasus penggunaan kampanye yang tersedia. Sumber daya tiruan tidak dapat dianggap memenuhi syarat untuk pengiriman produksi.

Biaya produksi

Jumlah ritel ini telah diperiksa terhadap konfigurasi portal terkini pada 24 Oktober 2026. Konfirmasikan biaya terkini di portal sebelum pendaftaran produksi. Biaya kampanye, pemeriksaan tambahan, dan penggunaan pengiriman pesan bersifat terpisah. Pendaftaran produksi memeriksa izin pembelian dan dana yang tersedia sebelum pengajuan; keberhasilan pendaftaran brand di registri dan penagihan lokal adalah langkah pemrosesan yang terpisah, jadi simpan ID sumber daya dan rekonsiliasikan transaksi jika terjadi kesalahan atau masalah penagihan.

Mengubah brand tiruan menjadi produksi adalah alur yang dikonfirmasi secara terpisah dan dapat membuat identitas produksi dan tagihan baru. Jangan berasumsi bahwa mengubah mock menjadi false pada permintaan berikutnya akan mengonversi brand yang ada.

Tangani kesalahan tanpa menduplikasi brand