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 nos números de SMS da Bird, parte da API de SMS da Bird mais ampla. É a opção a que recorre quando um número tem de empurrar alto volume para muitos destinatários — e está disposto a trocar rapidez de aprovisionamento pelo débito e pela confiança dos operadores que vêm com ele.

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 forma de chamada que qualquer outro tipo de remetente — só muda o campo de tipo. Pesquise por país e capacidade, compre o número e aponte o seu tráfego de entrada 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 os operadores aprovam para SMS um-para-muitos de alto volume — campanhas de marketing, alertas e OTP de alta taxa. É o tipo de remetente de maior débito, e passa por avaliação dos operadores antes de poder enviar.
Quanto tempo demora a aprovisionar um short code?
Planeie em semanas, não em minutos. Os operadores avaliam cada programa de short code antes de ficar ativo, por isso um short code traz um prazo real — ao contrário de um long code, que pode comprar e começar a enviar assim que o registo for concluído.
Short code dedicado ou partilhado?
Um short code dedicado é só seu, por isso a sua reputação de envio é inteiramente sua. Um short code partilhado divide um número entre remetentes por trás de palavras-chave — mais barato, mais rápido de começar, mas herda a reputação de todos os outros que o usam.
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