Short codes

Feitos para enviar em escala.

Um short code é um número de 5–6 dígitos feito para SMS um-para-muitos de alto volume: marketing, alertas e OTP de alta taxa. Os operadores avaliam cada programa antes de poder enviar, por isso o prazo de aprovisionamento mede-se em semanas em vez de minutos.

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.`,
  category: "authentication",
}).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

Onde encaixa um short code.

Um short code é um dos quatro tipos de remetente em números Bird SMS, parte da API Bird SMS mais abrangente. É a opção a que recorre quando um número tem de enviar alto volume para muitos destinatários e está disposto a trocar velocidade de aprovisionamento pelo throughput e confiança das operadoras que o acompanham.

O que um short code lhe dá.

Alto débito, avaliado pelos operadores, feito para um-para-muitos.

  1. 01

    O maior débito de qualquer tipo de remetente.

    Um short code é projetado para um número transportar uma carga de saída pesada, o que é o que faz uma campanha ou um disparo de alertas do mesmo dia chegar a tempo.

  2. 02

    Dedicado ou partilhado.

    Pegue num short code dedicado e a sua reputação de envio é só sua; partilhe um por trás de palavras-chave para começar mais depressa e mais barato, ao custo de herdar a reputação dos seus vizinhos.

  3. 03

    Avaliado pelos operadores antes de enviar.

    Cada programa de short code é revisto pelos operadores, por isso o número chega já com a confiança deles estabelecida em vez de a conquistar sob tráfego ao vivo.

  4. 04

    Melhor para um-para-muitos.

    Envios de marketing, alertas transacionais e OTP de alta taxa encaixam todos num short code. Para tráfego conversacional bidirecional, um long code costuma ser o melhor ponto de partida.

Pesquise, compre e encaminhe-o.

Aprovisionar um short code usa o mesmo cliente e a mesma estrutura de chamada que qualquer outro tipo de remetente: apenas o campo type muda. Pesquise por país e capacidade, compre o número e aponte as mensagens recebidas para um webhook.

short-code.ts
201 · purchased
const { data: available } = await bird.numbers.search({
  country: "US",
  type:    "short-code",
  capabilities: ["sms"],
}).safe();

const { data: number } = await bird.numbers.buy({
  number:  available[0].number,
  webhook: "https://example.com/webhooks/bird",
}).safe();

A avaliação compra-lhe débito.

O compromisso é direto: um short code ganha o seu débito elevado e confiado pelos operadores ao passar primeiro pela avaliação, por isso planeie um prazo de semanas. Recorra a um quando o volume de um programa ultrapassa o que um long code suporta, ou quando precisa de uma taxa de envio elevada e previsível desde o primeiro dia. Se o seu tráfego é bidirecional e conversacional, ou o volume é moderado, um long code fica ativo mais cedo e custa menos a começar.

Perguntas frequentes sobre short codes

O que é um short code de SMS?
Um short code é um número de 5–6 dígitos que as operadoras aprovam para SMS de alto volume de um para muitos: campanhas de marketing, alertas e OTP de alta taxa. É o tipo de remetente com maior throughput e passa por uma verificação da operadora antes de poder enviar.
Quanto tempo demora a aprovisionar um short code?
Planeie em semanas, não em minutos. As operadoras verificam cada programa de short code antes de entrar em funcionamento, por isso um short code tem um tempo de espera real — ao contrário de um número longo, que pode comprar e começar a enviar assim que o registo for aprovado.
Short code dedicado ou partilhado?
Um short code dedicado é exclusivamente seu, por isso a sua reputação de envio é inteiramente sua. Um short code partilhado divide um número entre vários remetentes através de palavras-chave: mais barato, mais rápido para começar, mas herda a reputação de todos os outros que o utilizam.
Quando devo usar antes um long code?
Quando o tráfego é bidirecional e conversacional, ou o volume não justifica a avaliação e o prazo. Um long code é local, bidirecional por omissão e ativo assim que a sua campanha 10DLC for concluída.

Escolha o tipo de remetente que o seu volume exige.

Um short code é um tipo de remetente na superfície de números de SMS da Bird. Aprovisione um quando o volume e o débito justificarem a avaliação, e encaminhe o tráfego de entrada a partir da mesma API com que envia.

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