Numéros longs, numéros courts, numéros gratuits et identifiants alphanumériques d'expéditeur : provisionnés, enregistrés et acheminés via un seul endpoint. L'expéditeur utilisé pour l'envoi 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.`,
category: "authentication",
}).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 conditions d'enregistrement.
Recherchez, achetez et routez en quelques appels.
Trouvez un numéro par pays et fonctionnalité, achetez-le et dirigez le trafic entrant vers un webhook, le tout depuis le même SDK que celui utilisé pour l'envoi. Le numéro est actif dès que l'enregistrement requis est validé.
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.
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.