Un sender ID alfanumerico mette il nome del tuo brand nel campo from al posto di un numero. Molti paesi richiedono di pre-registrare quel nome prima che possa consegnare. Bird presenta la registrazione e ne riporta lo stato tramite l'API così sai quando il mittente è attivo.
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"
Perché alcuni mittenti vanno registrati prima.
La registrazione del sender ID fa parte della conformità SMS sull'API SMS di Bird. Per arginare lo spoofing, diversi paesi consegnano solo i sender ID alfanumerici che sono stati pre-registrati presso i carrier locali o il regolatore. Dove ciò vale, un mittente brandizzato non registrato viene rifiutato o riscritto. Bird presenta la registrazione per te e ne espone lo stato, così non invii verso un mittente che non può ancora consegnare.
Come funziona la registrazione.
Dove è richiesta, chi la presenta e quando è attiva.
- 01
Sappi dove è richiesta.
Se un sender ID alfanumerico vada registrato dipende dal paese di destinazione. Alcuni richiedono la pre-registrazione, alcuni consentono mittenti dinamici e alcuni non permettono affatto l'alfanumerico.
- 02
Bird la presenta per te.
Sottoponi il sender ID e la destinazione dal dashboard. Bird porta la registrazione ai carrier locali o al regolatore per tuo conto.
- 03
Monitora lo stato tramite l'API.
L'approvazione passa attraverso registri esterni e richiede da giorni a settimane. Fai polling sullo stato della registrazione così il tuo codice la attende prima di inviare da quel sender ID.
- 04
Si applica ai mittenti alfanumerici.
La registrazione governa il sender ID alfanumerico stesso. L'invio da numeri — long code, short code, toll-free — segue invece le regole di quei tipi di numero.
Controlla lo stato di una registrazione dall'API.
Registri il sender ID dalla dashboard; la panoramica dei requisiti ti indica lo stato, una riga per ogni paese di destinazione. Verifica lo stato di quella riga e se la destinazione è attiva prima di inviare da quel sender.
// 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
}
La registrazione segue il mittente alfanumerico.
Questo è il passaggio di conformità dietro i sender ID alfanumerici. Il tipo di mittente ti permette di inviare da un nome di brand dove il paese lo consente; la registrazione è ciò che rende quel nome consegnabile dove il paese lo richiede prima.
Mettilo in pratica.
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Altri argomenti di conformità
La registrazione del sender ID è uno dei tre regimi di conformità SMS. Scopri gli altri.
Registra il tuo sender ID, poi invia brandizzato.
La registrazione del sender ID è uno dei regimi di conformità SMS su Bird. Presenta dal dashboard, monitora l'approvazione tramite l'API e invia dal nome del tuo brand dove è consentito.