Conformidade

As regras, tratadas num único lugar.

Enviar SMS significa cumprir as regras dos operadores e reguladores: registo A2P 10DLC nos EUA, tratamento de palavras-chave de opt-out em todo o lado, e pré-registo de sender ID em muitos países. A Bird gere cada um a partir de um único lugar e reporta o estado através da API.

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

Três regimes, uma superfície.

A conformidade é a camada da API de SMS da Bird que mantém o seu tráfego entregável. Aplicam-se diferentes regimes consoante onde envia e que tipo de mensagem envia: o tráfego de aplicações nos EUA precisa de 10DLC, qualquer destinatário pode fazer opt-out, e muitos países condicionam os remetentes alfanuméricos a pré-registo. Submete cada um uma vez e verifica o seu estado a partir do mesmo cliente com que envia.

Que regime se aplica a mim?

O que tem de registar depende de onde estão os seus destinatários e do que envia. A maioria dos programas de aplicações dos EUA toca nos três ao mesmo tempo.

Regime	O que abrange	Onde se aplica
A2P 10DLC	Registo de marca e campanha para tráfego application-to-person	Estados Unidos
Opt-out (STOP/HELP)	Tratamento das palavras-chave STOP, HELP e START e uma lista de supressão	Em todo o lado para onde envia
Registo de sender ID	Pré-registo de sender IDs alfanuméricos antes de poderem entregar	Muitos países que o exigem

Conformidade, por regime

Cada regime em detalhe — o que exige e como a Bird o submete e acompanha.

A2P 10DLCRegisto de marca e campanha para tráfego de aplicações dos EUA.Opt-out (STOP/HELP)Palavras-chave STOP, HELP e START respeitadas automaticamente, com uma lista de supressão consultável.Registo de sender IDPré-registe sender IDs alfanuméricos onde os países o exigem.

Submeta uma vez, verifique o estado a partir da API.

Submete uma marca e campanha 10DLC, uma verificação toll-free ou um registo de sender ID a partir do dashboard. A Bird leva-o aos operadores e registos e expõe o estado atual através da API, para que o seu código de aprovisionamento possa aguardar a aprovação em vez de adivinhá-la. O tratamento de opt-out não precisa de configuração — é aplicado em cada envio.

Perguntas frequentes sobre conformidade de SMS

O que tenho de registar antes de poder enviar?+

Depende de onde envia e do que envia. O tráfego de aplicações nos EUA precisa de registo de marca e campanha A2P 10DLC. Muitos países exigem pré-registo de sender ID para remetentes alfanuméricos. O tratamento de opt-out aplica-se em todo o lado e não precisa de configuração.

Tenho de construir eu próprio o tratamento de opt-out?+

Não. As palavras-chave STOP, HELP e START são respeitadas automaticamente em cada envio. Um STOP suprime o destinatário, o HELP aciona uma resposta de ajuda, e o START volta a subscrevê-lo. A lista de supressão pode ser consultada através da API.

Como sei quando um registo é aprovado?+

A Bird submete cada registo junto dos operadores ou registos e reporta o seu estado através da API. O seu código pode fazer polling ao estado do registo e aguardar a aprovação em vez de enviar para uma campanha que ainda não está ativa.

A conformidade é separada do resto da API de SMS?+

Não. Usa o mesmo cliente e as mesmas chaves que o envio, os números e o bidirecional. O estado do registo e a lista de supressão são recursos da API ao lado da chamada de envio, por isso uma integração cobre tanto o envio como as regras à sua volta.

O resto da plataforma de SMS

Uma API, um único conjunto de chaves. Explore as outras capacidades.

EnvioA API de envio: segmentos, segurança Unicode, lotes e idempotência.NúmerosLong codes, short codes, toll-free e sender IDs alfanuméricos.BidirecionalSMS recebidos e respostas conversacionais como webhooks assinados com HMAC.EncaminhamentoMais de 150 países, 240 ligações direct-to-carrier e failover.AnalíticaMétricas de entrega e interação a partir dos recibos de entrega do operador.Visão geral da API de SMSA API de SMS completa: envio, números, bidirecional, conformidade, encaminhamento e analítica.

Registe uma vez, envie com confiança.

A conformidade é uma das capacidades da API de SMS da Bird: envio, números, receção bidirecional, encaminhamento e analítica vêm incluídos.

Explorar a plataforma de SMS Começar