Encaminhamento

O caminho do envio ao telemóvel.

Configure em:
Cursor

A Bird alcança mais de 150 países através de 240 ligações direct-to-carrier. Quando um caminho de operador se degrada, voltamos a selecionar a rota em tempo real, antes de a mensagem seguinte sair. E cada envio devolve um recibo de entrega do operador, por isso sabe sempre se o telemóvel a recebeu.

send-otp.ts
200 · 0.4s
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

Hey Ada — your Bird sign-in code is 482917. It'll expire in 10 minutes. Don't share it with anyone.
482917
Delivered

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.

  1. 01

    Ligações direct-to-carrier.

    240 ligações ligam-nos diretamente aos operadores móveis em mais de 150 países. Sem cadeia de revendedores entre o seu envio e o SMSC do operador.

  2. 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.

  3. 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.

  4. 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.

  5. 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 devolve 202; o resultado chega como webhook assinado transportando o DLR do operador. O payload diz-lhe a rede em que aterrou, o país de destino e a latência de ida e volta.

POST /webhooks/bird
signed
{
  "type": "sms.delivered",
  "id":   "evt_7jR42x...",
  "created_at": "2026-05-19T15:42:01.221Z",
  "data": {
    "sms_id":     "sms_4kT01Lq2m",
    "from":       "Bird",
    "to":         "+15005550006",
    "mcc_mnc":    "310-260",
    "country":    "US",
    "latency_ms": 1284
  }
}

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.failedO operador rejeitou ou não conseguiu entregar — com o motivo anexado.

O encaminhamento apoia-se na inteligência de números.

A consulta de MNP que escolhe o operador certo é a mesma inteligência de números que pode chamar por si só com o Lookup — tipo de linha, operador atual e portabilidade antes de enviar. Assim que uma mensagem está na rede, ligue os webhooks para o recibo de entrega e leia a referência de erros para tratar cada código de falha, ou consulte o guia de entregabilidade para perceber o que os recibos lhe dizem.

Perguntas frequentes sobre encaminhamento de SMS

O que significa encaminhamento direct-to-carrier?+
A sua mensagem passa diretamente para o operador móvel através de uma das nossas 240 ligações diretas, não por uma cadeia de revendedores. Menos saltos significa menos sítios onde uma mensagem pode encravar ou um recibo de entrega se pode perder.
O que acontece quando uma rota de operador se degrada?+
A Bird volta a selecionar a rota em tempo real. Se um caminho começar a perder recibos ou a abrandar, a mensagem seguinte toma uma ligação mais saudável para o mesmo operador, e o envio que escreveu nunca muda.
Como sei que uma mensagem chegou de facto ao telemóvel?+
Cada mensagem devolve um recibo de entrega do operador como webhook sms.delivered ou sms.failed, transportando o mcc_mnc, o país e o latency_ms. É essa a confirmação do próprio operador, não uma inferência do nosso lado.
Verificam o operador do destinatário antes de enviar?+
Sim. Fazemos uma consulta de MNP em cada envio para resolver o operador atual do destinatário, para que um número portado seja encaminhado para o operador que de facto o detém. Para inteligência de números autónoma, consulte o Lookup.
Posso escolher encaminhamento de menor custo em vez de maior qualidade?+
O encaminhamento equilibra custo e qualidade de entrega por destino. O tráfego transacional, como os códigos de uso único, favorece o caminho de maior qualidade; o tráfego em massa pode pender para o menor custo. A seleção acontece por mensagem, por trás da mesma chamada de API.

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.

Comece com um canal.
Adicione os outros quando estiver pronto.

Uma chave API de teste é sua imediatamente. A produção é desbloqueada quando você adiciona um método de pagamento e verifica um remetente.

Usa Claude Code, Cursor ou Codex? Copie um prompt de configuração e o seu agente instala o Bird CLI e as skills por si. Escolha o seu:

Cursor