Bird alcança mais de 190 países através de mais de 240 conexões diretas com operadoras. Quando uma rota de operadora se degrada, reselecionamos o caminho em tempo real, antes que a próxima mensagem seja enviada. E cada envio retorna um recibo de entrega da operadora, para que você sempre saiba se o dispositivo recebeu.
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"
A camada sobre a qual o seu envio viaja.
O encaminhamento é a camada por baixo da API de SMS da Bird. Chama um endpoint com um from, um to e um text; por baixo, resolvemos o operador do destinatário, escolhemos uma ligação e entregamos a mensagem. Quando um caminho fica mau, a rota muda e o seu código não.
O que a camada de encaminhamento decide por si.
Resolvido por mensagem, por trás de uma chamada de API.
- 01
Ligações direct-to-carrier.
240 conexões nos ligam diretamente às operadoras móveis em mais de 190 países. Sem cadeia de revendedores entre o seu envio e o SMSC da operadora.
- 02
Reseleção de rota em tempo real.
Vigiamos a entrega e a latência em cada caminho. Quando uma rota de operador começa a degradar-se, a mensagem seguinte toma uma ligação mais saudável para o mesmo operador. O failover acontece antes de você reparar.
- 03
Consulta de MNP antes do envio.
Resolvemos o operador atual do destinatário em cada envio, para que um número portado seja encaminhado para o operador que de facto o detém, em vez daquele com que foi emitido.
- 04
Um recibo de entrega para cada mensagem.
O próprio DLR do operador volta como webhook sms.delivered ou sms.failed, transportando a rede em que aterrou e quanto tempo demorou. Sem adivinhações do seu lado.
- 05
Menor custo ou maior qualidade, por rota.
O encaminhamento pesa o custo contra a qualidade de entrega para cada destino. O tráfego transacional favorece o caminho mais rápido e fiável; o tráfego em massa pode pender para o menor custo.
Porque o direct-to-carrier vence uma cadeia de agregadores.
Muito tráfego de SMS passa por dois ou três revendedores antes de chegar a um operador. Cada salto acrescenta um sítio onde a mensagem pode encravar, onde o preço pode subir e onde o recibo de entrega se pode perder ou falsificar. Uma ligação direta remove esses intermediários: a mensagem vai da Bird para o operador, e o recibo volta da mesma forma. É assim que cerca de 40% do SMS comercial do mundo já corre por esta rede, com 95% das mensagens entregues em menos de 2,5 segundos.
O recibo de entrega, diretamente do operador.
Um envio retorna 202; o resultado chega como um webhook assinado com o DLR da operadora. O payload identifica a operadora que encaminhou a mensagem e a rede móvel exata (MCC-MNC) em que foi entregue.
{
"type": "sms.delivered",
"timestamp": "2026-05-19T15:42:01.221Z",
"data": {
"sms_id": "sms_4kT01Lq2m",
"workspace_id": "ws_8KQ2",
"to": "+15005550006",
"from": "+12025550188",
"tags": null,
"metadata": null,
"carrier": "Verizon",
"mcc_mnc": "311480",
"cost": {
"amount": "0.0079",
"currency_code": "USD",
"transaction_amount": "0.0079",
"passthrough_amount": null
}
}
}
O mcc_mnc identifica a rede móvel exata que recebeu a mensagem; um valor diferente do operador de origem do número é o seu sinal de que o destinatário portou.
sms.deliveredO operador confirmou que o telemóvel recebeu a mensagem (DLR).sms.failedA operadora rejeitou ou não conseguiu entregar, com o motivo anexado.
O encaminhamento apoia-se na inteligência de números.
A consulta MNP que seleciona a operadora correta é a mesma inteligência numérica que pode ser chamada de forma independente com o Lookup: tipo de linha, operadora atual e portabilidade antes do envio. Quando a mensagem estiver em trânsito, configure webhooks para o recibo de entrega e consulte a referência de erros para tratar cada código de falha, ou verifique o guia de entregabilidade para entender o que os recibos indicam.
Coloque em prática.
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
O resto da plataforma de SMS
Uma API, um único conjunto de chaves. Explore as outras capacidades.
Encaminhamento em que nunca tem de pensar.
Cobertura, conectividade de operadores, failover e recibos de entrega são uma das capacidades da API de SMS da Bird, sobre infraestrutura que operamos há uma década.