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.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

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

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

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

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.

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

Outras formas de enviar

Os short codes são um de quatro tipos de remetente. Compare os restantes.

Long codesNúmeros locais de 10 dígitos para tráfego bidirecional, registados através de A2P 10DLC.Toll-freeNúmeros toll-free verificados para tráfego dos EUA e Canadá sem 10DLC.Sender IDs alfanuméricosEnvie a partir do nome da sua marca onde o país de destino o permite.Todos os números de SMSCompare cada tipo de remetente — alcance, débito e registo.Visão geral da API de SMSA API de SMS completa: envio, números, bidirecional, conformidade, encaminhamento e analítica.

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.

Explorar os números de SMS Começar