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 { data, error } = await bird.sms.send({
from: "Bird",
to: "+31612345678",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"
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.
- 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 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.
const { data: page, error: searchError } = await bird.numbers.available
.list({
country_code: "US",
number_type: "short_code",
capabilities: ["sms"],
})
.safe();
if (searchError) throw searchError;
const { data: order, error: orderError } = await bird.numbers.orders
.create({ number: page.data[0].number })
.safe();
if (orderError) throw orderError;
console.log(order.status, order.number_id); // → "completed" "nda_0ydh2yfw..."
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.
Coloque em prática.
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
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.