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

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.

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