Enregistrement du sender ID
Envoyez depuis votre nom, là où c'est autorisé.
Un sender ID alphanumérique place le nom de votre marque dans le champ expéditeur au lieu d'un numéro. De nombreux pays exigent que vous pré-inscriviez ce nom avant qu'il ne puisse délivrer. Bird dépose l'enregistrement et en signale le statut via l'API pour que vous sachiez quand l'expéditeur est actif.
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"
Pourquoi certains expéditeurs doivent d'abord être enregistrés.
L'enregistrement du sender ID fait partie de la conformité SMS sur l'API SMS de Bird. Pour limiter l'usurpation, un certain nombre de pays ne délivrent que les sender IDs alphanumériques qui ont été pré-inscrits auprès des opérateurs locaux ou du régulateur. Là où cela s'applique, un expéditeur de marque non enregistré est rejeté ou réécrit. Bird dépose l'enregistrement à votre place et en expose l'état, pour que vous n'envoyiez pas vers un expéditeur qui ne peut pas encore délivrer.
Comment fonctionne l'enregistrement.
Où il est requis, qui le dépose et quand il est actif.
- 01
Sachez où il est requis.
Le fait qu'un sender ID alphanumérique doive être enregistré dépend du pays de destination. Certains exigent une pré-inscription, d'autres autorisent des expéditeurs dynamiques, et d'autres n'autorisent pas du tout l'alphanumérique.
- 02
Bird le dépose pour vous.
Soumettez le sender ID et la destination depuis le tableau de bord. Bird transmet l'enregistrement aux opérateurs locaux ou au régulateur en votre nom.
- 03
Suivez le statut via l'API.
L'approbation passe par des registres externes et prend de quelques jours à quelques semaines. Interrogez l'état de l'enregistrement afin que votre code l'attende avant d'envoyer depuis ce sender ID.
- 04
Il s'applique aux expéditeurs alphanumériques.
L'enregistrement régit le sender ID alphanumérique lui-même. L'envoi depuis des numéros — long codes, short codes, toll-free — suit plutôt les règles de ces types de numéros.
Vérifiez le statut d'un enregistrement depuis l'API.
Vous déposez l'identifiant d'expéditeur depuis le tableau de bord ; l'état des exigences vous indique où en est la demande, une ligne par pays de destination. Vérifiez le statut de cette ligne et si la destination est activée avant d'envoyer depuis cet expéditeur.
// 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
}
L'enregistrement suit l'expéditeur alphanumérique.
C'est l'étape de conformité derrière les sender IDs alphanumériques. Le type d'expéditeur vous permet d'envoyer depuis un nom de marque là où le pays l'autorise ; l'enregistrement est ce qui rend ce nom délivrable là où le pays l'exige au préalable.
Autres sujets de conformité
L'enregistrement du sender ID est l'un des trois régimes de conformité SMS. Découvrez les autres.
Enregistrez votre sender ID, puis envoyez avec votre marque.
L'enregistrement du sender ID est l'un des régimes de la conformité SMS sur Bird. Déposez depuis le tableau de bord, suivez l'approbation via l'API, et envoyez depuis le nom de votre marque là où c'est autorisé.