Long codes, short codes, números toll-free e sender IDs alfanuméricos: provisionados, registados e encaminhados através de um único endpoint. O remetente a partir do qual envia determina o throughput, o custo e o regime de conformidade aplicável.
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: "+15005550006",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."
Quatro tipos de remetente, uma API.
Os números são a base da API de SMS da Bird. Pesquise disponibilidade, compre um número e encaminhe o tráfego de entrada para um webhook com o mesmo cliente com que já envia. O tipo que escolhe depende do volume, da geografia e de quanto registo pode assumir.
Que remetente devo usar?
O débito, o alcance e o esforço de registo diferem por tipo de remetente. A maioria do tráfego de aplicações dos EUA começa num long code 10DLC; programas de um-para-muitos de alto volume passam para um short code.
| Tipo de remetente | Melhor para | Registo |
|---|---|---|
| Long code (10DLC) | Conversas bidirecionais, OTP, alertas a volume moderado | Marca + campanha A2P 10DLC |
| Short code | Marketing e alertas um-para-muitos de alto volume | Avaliado pelos operadores, prazo de semanas |
| Toll-free | Tráfego EUA/Canadá sem 10DLC, maior débito que um long code | Verificação toll-free |
| Sender ID alfanumérico | Alertas de marca unidirecionais onde o país o permite | Pré-registo em muitos países |
Escolha um tipo de número
Cada tipo de remetente em detalhe: alcance, throughput e o que é necessário para registar.
Pesquise, compre e encaminhe em poucas chamadas.
Encontre um número por país e funcionalidade, compre-o e direcione o tráfego de entrada para um webhook — tudo a partir do mesmo SDK com que envia. O número fica ativo assim que qualquer registo necessário for aprovado.
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..."Registo, tratado onde é exigido.
A maioria do tráfego de aplicações dos EUA precisa de registo de marca e campanha A2P 10DLC; o toll-free precisa de verificação; muitos países exigem pré-registo de sender ID. A Bird gere cada um a partir do dashboard, e a superfície de conformidade acompanha o estado a partir da API.
O resto da plataforma de SMS
Uma API, um único conjunto de chaves. Explore as outras capacidades.
Aprovisione o número certo, encaminhe-o em minutos.
Os números são uma das capacidades da API de SMS da Bird: envio, receção bidirecional, conformidade, encaminhamento e analítica vêm incluídos.