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.
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
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.
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?
Quanto tempo demora a aprovisionar um short code?
Short code dedicado ou partilhado?
Quando devo usar antes um long code?
Outras formas de enviar
Os short codes são um de quatro tipos de remetente. Compare os restantes.
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.