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-notification.ts
202 · 0.4s
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..."
Hi Ada, reminder of your appointment tomorrow at 14:30 with Dr. Kowalski.
Your order #4821 has shipped. Track it: bird.ly/t/4821x
Your subscription renews on 3 Sep for €12/mo. Manage it here: bird.ly/account

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

POST /webhooks/bird
signed
{
  "type": "sms.delivered",
  "timestamp": "2026-05-19T15:42:01.221Z",
  "data": {
    "sms_id":       "sms_4kT01Lq2m",
    "workspace_id": "ws_8KQ2",
    "to":           "+15005550006",
    "from":         "Bird",
    "tags":         null,
    "metadata":     null,
    "carrier":      "Verizon",
    "mcc_mnc":      "311480"
  }
}

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.

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