Long codes, short codes, numéros toll-free et sender IDs alphanumériques — provisionnés, enregistrés et routés via un seul endpoint. L'expéditeur depuis lequel vous envoyez détermine le débit, le coût et le régime de conformité applicable.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const code = generateOtp();
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+15005550006",
text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."Today at 2:14 PM
Quatre types d'expéditeurs, une seule API.
Les numéros sont le socle de l'API SMS de Bird. Recherchez la disponibilité, achetez un numéro et routez l'entrant vers un webhook avec le même client que celui avec lequel vous envoyez déjà. Le type que vous choisissez dépend du volume, de la géographie et de la quantité d'enregistrement que vous pouvez prendre en charge.
Quel expéditeur dois-je utiliser ?
Le débit, la portée et l'effort d'enregistrement diffèrent selon le type d'expéditeur. La majeure partie du trafic applicatif américain commence sur un long code 10DLC ; les programmes one-to-many à fort volume passent à un short code.
| Type d'expéditeur | Idéal pour | Enregistrement |
|---|---|---|
| Long code (10DLC) | Conversations bidirectionnelles, OTP, alertes à volume modéré | Marque + campagne A2P 10DLC |
| Short code | Marketing et alertes one-to-many à fort volume | Vérifié par les opérateurs, délai de quelques semaines |
| Toll-free | Trafic États-Unis/Canada sans 10DLC, débit supérieur à un long code | Vérification toll-free |
| Sender ID alphanumérique | Alertes de marque unidirectionnelles là où le pays l'autorise | Pré-inscription dans de nombreux pays |
Choisissez un type de numéro
Chaque type d'expéditeur en détail — portée, débit et ce qu'il faut pour l'enregistrer.
Recherchez, achetez et routez en quelques appels.
Trouvez un numéro par pays et par capacité, achetez-le et pointez son trafic entrant vers un webhook — le tout depuis le même SDK que celui avec lequel vous envoyez. Le numéro est actif dès que tout enregistrement requis aboutit.
const { data: available } = await bird.numbers.search({
country: "US",
type: "long-code",
capabilities: ["sms"],
}).safe();
const { data: number } = await bird.numbers.buy({
number: available[0].number,
webhook: "https://example.com/webhooks/bird",
}).safe();
console.log(number.id); // → "num_8KQ2..."L'enregistrement, géré là où il est requis.
La majeure partie du trafic applicatif américain nécessite l'enregistrement de marque et de campagne A2P 10DLC ; le toll-free nécessite une vérification ; de nombreux pays exigent une pré-inscription du sender ID. Bird pilote chacun de ces aspects depuis le tableau de bord, et la surface de conformité suit le statut depuis l'API.
FAQ sur les numéros SMS
Par quel type de numéro devrais-je commencer ?+
Combien de temps faut-il pour rendre un numéro actif ?+
Un même numéro peut-il à la fois envoyer et recevoir ?+
Dois-je m'enregistrer avant de pouvoir envoyer ?+
Le reste de la plateforme SMS
Une seule API, un seul jeu de clés. Explorez les autres capacités.
Provisionnez le bon numéro, routez-le en quelques minutes.
Les numéros sont l'une des capacités de l'API SMS de Bird : l'envoi, la réception bidirectionnelle, la conformité, le routage et l'analyse sont livrés avec eux.