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.
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..."
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 uzyskiwania zgody. 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ć.
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.
Koszty rejestracji.
Opłaty są ustalane przez TCR, a Bird przekazuje je po kosztach, wycenianych na bieżąco z Bird billing API: jednorazowa opłata za markę, jednorazowa opłata za weryfikację przy każdym zgłoszeniu kampanii oraz cykliczna opłata miesięczna za kampanię, zależna od przypadku użycia.
Opłaty rejestracyjne
Inne tematy zgodności
10DLC to jeden z trzech reżimów zgodności SMS. Zobacz pozostałe.
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ą.