A2P 10DLC

Zarejestruj raz, wysyłaj do USA.

A2P 10DLC to sposób, w jaki SMS application-to-person dociera do odbiorców w USA na standardowych 10-cyfrowych numerach. Rejestrujesz markę, a następnie kampanię opisującą wysyłane wiadomości. Operatorzy weryfikują obie i przyznają kampanii przepustowość, gdy zostanie zatwierdzona.

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

Dlaczego istnieje 10DLC.

A2P 10DLC to część zgodności SMS w API SMS od Bird. Operatorzy w USA wymagają, by każda firma wysyłająca ruch aplikacyjny przez lokalne long codes zarejestrowała stojącą za nim markę oraz każdą prowadzoną kampanię. Zarejestrowany ruch zyskuje zweryfikowaną przepustowość i zaufanie operatorów; niezarejestrowany ruch jest filtrowany. Bird składa obie i raportuje stan zatwierdzenia, dzięki czemu wysyłasz do kampanii, która jest faktycznie aktywna.

Przebieg rejestracji.

Marka, potem kampania, potem numery, które ją przenoszą.

01
Zarejestruj markę.
Prześlij podmiot prawny stojący za Twoim ruchem. Operatorzy go weryfikują, a marka staje się tożsamością, do której podłącza się każda kampania.
02
Zarejestruj kampanię.
Opisz wysyłane wiadomości — przypadek użycia, przykładową treść i proces opt-in. To zatwierdzenie odblokowuje przepustowość kampanii.
03
Powiąż swoje numery.
Podłącz long codes, które będą przenosić kampanię. Od tego momentu ich ruch aplikacyjny w USA przebiega przez zarejestrowaną kampanię.
04
Odpytuj status, aż będzie aktywny.
Zatwierdzenie trwa od dni do tygodni. Odpytuj stan kampanii przez API, aby Twój kod na nie czekał, zamiast wysyłać do kampanii oczekującej.

Sprawdzaj status kampanii z API.

Markę i kampanię składasz z panelu; API udostępnia, na jakim etapie jest każda z nich. Odczytaj kampanię po jej id i rozgałęź na podstawie statusu, zanim zaczniesz wysyłać.

campaign-status.ts

200 · approved

const { data: campaign } = await bird.sms.compliance.campaigns
  .get("cmp_7Hq2...")
  .safe();

if (campaign.status === "approved") {
  // throughput is live — safe to send
}

console.log(campaign.brandId); // → "brand_3Lx9..."

10DLC to sposób, w jaki long codes zyskują przepustowość w USA.

Jeśli wysyłasz z long codes, to 10DLC zamienia je z ryzyka filtrowania w zweryfikowanego nadawcę. Numer jest Twój od chwili zakupu, ale jego ruch aplikacyjny w USA płynie z pełną szybkością dopiero wtedy, gdy powiązana z nim kampania zostanie zatwierdzona.

FAQ dotyczące A2P 10DLC

Czym jest A2P 10DLC?+

A2P 10DLC to ramy operatorów w USA dla SMS-ów application-to-person wysyłanych przez standardowe 10-cyfrowe long codes. Firma rejestruje markę stojącą za swoim ruchem oraz kampanię opisującą wiadomości, a operatorzy weryfikują obie, zanim przyznają przepustowość.

Jaka jest różnica między marką a kampanią?+

Marka to podmiot prawny wysyłający ruch. Kampania opisuje konkretny przypadek użycia wiadomości w ramach tej marki. Jedna marka może mieć kilka kampanii, a numery wiążesz z kampanią, a nie z marką.

Jak długo trwa zatwierdzenie?+

Weryfikacja marki i kampanii przebiega przez operatorów i rejestr i zwykle trwa od dni do tygodni. Odpytuj status kampanii przez API, aby Twój kod czekał na zatwierdzenie, zanim zacznie wysyłać.

Czy 10DLC obowiązuje poza USA?+

Nie. 10DLC to ramy obowiązujące w USA. Inne kraje mają własne reguły — wiele z nich wymaga zamiast tego wstępnej rejestracji identyfikatora nadawcy — a obsługa słów kluczowych opt-out obowiązuje wszędzie, gdzie wysyłasz.

Inne tematy zgodności

10DLC to jeden z trzech reżimów zgodności SMS. Zobacz pozostałe.

Opt-out (STOP/HELP)Słowa kluczowe STOP, HELP i START uwzględniane automatycznie, z listą blokad, którą można odpytywać.Rejestracja identyfikatora nadawcyWstępna rejestracja alfanumerycznych identyfikatorów nadawcy tam, gdzie kraje tego wymagają.Cała zgodność SMS10DLC, opt-out i rejestracja identyfikatora nadawcy w jednym miejscu.Przegląd API SMSPełne API SMS: wysyłka, numery, komunikacja dwukierunkowa, zgodność, routing i analityka.

Złóż markę i kampanię, a następnie wysyłaj.

10DLC to jeden z reżimów zgodności SMS w Bird. Rejestruj z panelu, śledź zatwierdzenie przez API i wysyłaj do odbiorców w USA ze zweryfikowaną przepustowością.

Poznaj zgodność SMS Rozpocznij