Registo de sender ID

Envie a partir do seu nome, onde for permitido.

Um sender ID alfanumérico coloca o nome da sua marca no campo de remetente em vez de um número. Muitos países exigem que pré-registe esse nome antes de poder entregar. A Bird submete o registo e reporta o seu estado através da API para que saiba quando o remetente está ativo.

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

Porque alguns remetentes precisam de ser registados primeiro.

O registo de sender ID faz parte da conformidade de SMS na API de SMS da Bird. Para travar a falsificação, vários países só entregam sender IDs alfanuméricos que tenham sido pré-registados junto dos operadores locais ou do regulador. Onde isso se aplica, um remetente de marca não registado é rejeitado ou reescrito. A Bird submete o registo por si e expõe o seu estado, para que não envie para um remetente que ainda não consegue entregar.

Como funciona o registo.

Onde é exigido, quem o submete e quando fica ativo.

  1. 01

    Saiba onde é exigido.

    Se um sender ID alfanumérico precisa de registo depende do país de destino. Alguns exigem pré-registo, alguns permitem remetentes dinâmicos, e alguns não permitem de todo alfanuméricos.

  2. 02

    A Bird submete-o por si.

    Submeta o sender ID e o destino a partir do dashboard. A Bird leva o registo aos operadores locais ou ao regulador em seu nome.

  3. 03

    Acompanhe o estado através da API.

    A aprovação decorre através de registos externos e demora dias a semanas. Faça polling ao estado do registo para que o seu código aguarde por ele antes de enviar a partir desse sender ID.

  4. 04

    Aplica-se a remetentes alfanuméricos.

    O registo rege o próprio sender ID alfanumérico. Enviar a partir de números — long codes, short codes, toll-free — segue antes as regras desses tipos de número.

Verifique o estado de um registo a partir da API.

Submete o sender ID a partir do dashboard; a API diz-lhe onde se encontra por destino. Leia o registo e ramifique conforme o seu estado antes de enviar a partir desse remetente.

sender-id-status.ts
200 · registered
const { data: senderId } = await bird.sms.compliance.senderIds
  .get("Bird")
  .safe();

if (senderId.status === "registered") {
  // safe to send from this sender ID in that country
}

console.log(senderId.country); // → "IN"

O registo segue o remetente alfanumérico.

Este é o passo de conformidade por trás dos sender IDs alfanuméricos. O tipo de remetente permite-lhe enviar a partir de um nome de marca onde o país o permite; o registo é o que torna esse nome entregável onde o país o exige primeiro.

Perguntas frequentes sobre registo de sender ID

O que é um sender ID alfanumérico?+
É um remetente apresentado como um nome em vez de um número de telefone — a sua marca no campo de remetente. É apenas unidirecional e, onde o país de destino o permite, torna uma mensagem reconhecidamente sua.
Porque tenho de registar um?+
Para travar a falsificação, muitos países só entregam sender IDs alfanuméricos que tenham sido pré-registados junto dos operadores locais ou do regulador. Onde essa regra se aplica, um remetente de marca não registado é rejeitado ou reescrito.
Quem submete o registo?+
A Bird. Submete o sender ID e o destino a partir do dashboard, a Bird leva-o ao registo local, e a API reporta o seu estado para que saiba quando o remetente está ativo.
Quanto tempo demora?+
A aprovação decorre através de operadores e registos externos e varia consoante o país, tipicamente dias a semanas. Faça polling ao estado do registo através da API e aguarde por ele antes de enviar a partir desse sender ID.

Registe o seu sender ID e depois envie com a sua marca.

O registo de sender ID é um regime de conformidade de SMS na Bird. Submeta a partir do dashboard, acompanhe a aprovação através da API e envie a partir do nome da sua marca onde for permitido.

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