Números

O remetente certo para cada mensagem.

Long codes, short codes, números toll-free e sender IDs alfanuméricos: provisionados, registados e encaminhados através de um único endpoint. O remetente a partir do qual envia determina o throughput, o custo e o regime de conformidade aplicável.

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:       "+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"

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:       "+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"

Quatro tipos de remetente, uma API.

Os números são a base da API de SMS da Bird. Pesquise disponibilidade, compre um número e encaminhe o tráfego de entrada para um webhook com o mesmo cliente com que já envia. O tipo que escolhe depende do volume, da geografia e de quanto registo pode assumir.

Que remetente devo usar?

O débito, o alcance e o esforço de registo diferem por tipo de remetente. A maioria do tráfego de aplicações dos EUA começa num long code 10DLC; programas de um-para-muitos de alto volume passam para um short code.

Tipo de remetente	Melhor para	Registo
Long code (10DLC)	Conversas bidirecionais, OTP, alertas a volume moderado	Marca + campanha A2P 10DLC
Short code	Marketing e alertas um-para-muitos de alto volume	Avaliado pelos operadores, prazo de semanas
Toll-free	Tráfego EUA/Canadá sem 10DLC, maior débito que um long code	Verificação toll-free
Sender ID alfanumérico	Alertas de marca unidirecionais onde o país o permite	Pré-registo em muitos países

Escolha um tipo de número

Cada tipo de remetente em detalhe: alcance, throughput e o que é necessário para registar.

Long codesNúmeros locais de 10 dígitos para tráfego bidirecional, registados através de A2P 10DLC.Short codesNúmeros de 5–6 dígitos feitos para envio um-para-muitos de alto débito.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.

Pesquise, compre e encaminhe em poucas chamadas.

Encontre um número por país e funcionalidade e compre-o, a partir do mesmo SDK com que envia. O tráfego de entrada é encaminhado por um webhook do workspace subscrito a sms.received em vez de por número, pelo que uma única subscrição abrange todos os números que possui. O número fica ativo assim que qualquer registo necessário for concluído.

provision.ts

201 · purchased

const { data: page, error: searchError } = await bird.numbers.available
  .list({
    country_code: "US",
    number_type:  "local",
    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..."

Registo, tratado onde é exigido.

A maioria do tráfego de aplicações dos EUA precisa de registo de marca e campanha A2P 10DLC; o toll-free precisa de verificação; muitos países exigem pré-registo de sender ID. A Bird gere cada um a partir do dashboard, e a superfície de conformidade acompanha o estado a partir da API.