Sebuah alphanumeric sender ID menempatkan nama brand Anda di kolom from alih-alih nomor. Banyak negara mewajibkan Anda mempra-registrasi nama itu sebelum dapat dikirim. Bird mengajukan registrasi dan melaporkan statusnya melalui API sehingga Anda tahu kapan pengirim aktif.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+31612345678",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"
Mengapa sebagian pengirim perlu didaftarkan dulu.
Registrasi sender ID adalah bagian dari kepatuhan SMS di Bird SMS API. Untuk menekan spoofing, sejumlah negara hanya mengirimkan alphanumeric sender ID yang telah dipra-registrasi dengan operator lokal atau regulator. Di tempat itu berlaku, pengirim bermerek yang tidak terdaftar akan ditolak atau ditulis ulang. Bird mengajukan registrasi untuk Anda dan memaparkan statusnya, sehingga Anda tidak mengirim ke pengirim yang belum dapat mengirimkan pesan.
Bagaimana registrasi bekerja.
Di mana diwajibkan, siapa yang mengajukan, dan kapan aktif.
- 01
Ketahui di mana diwajibkan.
Apakah sebuah alphanumeric sender ID perlu didaftarkan tergantung negara tujuan. Sebagian mewajibkan pra-registrasi, sebagian mengizinkan pengirim dinamis, dan sebagian sama sekali tidak mengizinkan alphanumeric.
- 02
Bird mengajukannya untuk Anda.
Kirimkan sender ID dan tujuan dari dashboard. Bird membawa registrasi ke operator lokal atau regulator atas nama Anda.
- 03
Lacak status melalui API.
Persetujuan berjalan melalui registri eksternal dan memakan waktu beberapa hari hingga minggu. Polling status registrasi agar kode Anda menunggunya sebelum mengirim dari sender ID itu.
- 04
Berlaku untuk pengirim alphanumeric.
Registrasi mengatur alphanumeric sender ID itu sendiri. Mengirim dari nomor — long codes, short codes, toll-free — mengikuti aturan jenis nomor tersebut.
Periksa status registrasi dari API.
Anda mengajukan sender ID dari dashboard; daftar persyaratan menunjukkan statusnya, satu baris per negara tujuan. Periksa status baris tersebut, dan apakah tujuan sudah diaktifkan, sebelum Anda mengirim dari sender tersebut.
// The sender surface is not on the SDK yet, so read it over HTTP with a key
// carrying the sms_management:read scope.
const res = await fetch(
`https://eu1.platform.bird.com/v1/sms/senders/${senderId}/requirements`,
{ headers: { Authorization: `Bearer ${process.env.BIRD_API_KEY!}` } },
);
const { data: countries } = await res.json();
// Registration is decided per destination, so there is one row per country
// this sender can reach — never a single status for the sender itself.
const india = countries.find((c) => c.country_code === "IN");
// approved and not_required are the two statuses that satisfy a country.
// destination_enabled is a separate axis: a fully registered country still
// refuses the send while the workspace has it switched off.
if (india.status === "approved" && india.destination_enabled) {
// safe to send from this sender ID to India
}
Registrasi mengikuti pengirim alphanumeric.
Ini adalah langkah kepatuhan di balik alphanumeric sender ID. Jenis pengirim ini memungkinkan Anda mengirim dari nama brand di tempat negara mengizinkannya; registrasilah yang membuat nama itu dapat dikirimkan di tempat negara mewajibkannya lebih dulu.
Terapkan dalam praktik.
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Topik kepatuhan lainnya
Registrasi sender ID adalah satu dari tiga rezim kepatuhan SMS. Lihat sisanya.
Daftarkan sender ID Anda, lalu kirim bermerek.
Registrasi sender ID adalah satu rezim kepatuhan SMS di Bird. Ajukan dari dashboard, lacak persetujuan melalui API, dan kirim dari nama brand Anda di tempat yang diizinkan.