Um long code é um número de telefone padrão de 10 dígitos que envia e recebe SMS. É o remetente por omissão para conversas bidirecionais, OTP e alertas a volume moderado. Para tráfego de aplicações dos EUA é registado através de A2P 10DLC.
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..."
Quando um long code é a escolha certa.
Os códigos longos são um dos quatro tipos de remetente na superfície de números SMS do Bird, parte da API de SMS do Bird mais ampla. São locais, bidirecionais e rápidos de provisionar: o ponto de partida ideal para a maioria do tráfego conversacional e transacional antes de o volume justificar um código curto.
O que um long code lhe dá.
Presença local, tráfego bidirecional, volume moderado.
- 01
Um número local de 10 dígitos.
Os destinatários veem um indicativo do seu próprio país ou região, o que se lê como um remetente real em vez de um disparo de marketing.
- 02
Bidirecional por omissão.
Direcione o tráfego de entrada do número para um webhook e as respostas chegam como eventos assinados — a base para fluxos conversacionais.
- 03
Registado através de A2P 10DLC.
O tráfego de aplicações dos EUA passa por campanhas 10DLC registadas, o que ganha débito avaliado e a confiança dos operadores em vez de um risco de filtragem.
- 04
Ativo assim que o registo for concluído.
Compre o número de imediato; começa a transportar tráfego registado assim que a sua campanha 10DLC for aprovada.
Compre um e comece a enviar.
Pesquise por país e capacidade, compre o número e encaminhe as mensagens recebidas para um webhook — o mesmo cliente com que você envia. A mesma estrutura de código provisiona qualquer tipo de remetente; apenas o campo type muda.
const { data: available } = await bird.numbers.search({
country: "US",
type: "long-code",
capabilities: ["sms"],
}).safe();
const { data: number } = await bird.numbers.buy({
number: available[0].number,
webhook: "https://example.com/webhooks/bird",
}).safe();O registo faz parte do acordo.
Para enviar tráfego application-to-person para números dos EUA, um long code passa por uma campanha A2P 10DLC registada. A Bird submete a marca e a campanha a partir do dashboard e reporta o estado de aprovação através da API, para que saiba exatamente quando o débito máximo está disponível.
Outras formas de enviar
Os long codes são um de quatro tipos de remetente. Compare os restantes.
Comece num long code, escale quando precisar.
Os long codes são um tipo de remetente na superfície de números de SMS da Bird. Aprovisione um, registe a campanha e encaminhe o tráfego de entrada a partir da mesma API com que envia.