Long codes

Lokalne numery, dwukierunkowe domyślnie.

Long code to standardowy 10-cyfrowy numer telefonu, który wysyła i odbiera SMS-y. To domyślny nadawca dla rozmów dwukierunkowych, OTP i alertów przy umiarkowanym wolumenie. Dla ruchu aplikacyjnego w USA jest rejestrowany przez A2P 10DLC.

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

Today at 2:14 PM

Hey Ada — your Bird sign-in code is 482917. It'll expire in 10 minutes. Don't share it with anyone.
482917
Delivered

Kiedy long code to właściwy wybór.

Long codes to jeden z czterech typów nadawców w warstwie numerów SMS od Bird, części szerszego API SMS od Bird. Są lokalne, dwukierunkowe i szybkie do udostępnienia — właściwy punkt startowy dla większości ruchu konwersacyjnego i transakcyjnego, zanim wolumen uzasadni short code.

Co daje Ci long code.

Lokalna obecność, ruch dwukierunkowy, umiarkowany wolumen.

  1. 01

    Lokalny 10-cyfrowy numer.

    Odbiorcy widzą numer kierunkowy ze swojego kraju lub regionu, który czyta się jak prawdziwy nadawca, a nie jak masowa wysyłka marketingowa.

  2. 02

    Dwukierunkowe domyślnie.

    Skieruj ruch przychodzący numeru na webhook, a odpowiedzi przychodzą jako podpisane zdarzenia — fundament dla przepływów konwersacyjnych.

  3. 03

    Rejestrowane przez A2P 10DLC.

    Ruch aplikacyjny w USA przebiega przez zarejestrowane kampanie 10DLC, co zyskuje zweryfikowaną przepustowość i zaufanie operatorów zamiast ryzyka filtrowania.

  4. 04

    Aktywny, gdy tylko rejestracja zostanie zatwierdzona.

    Kup numer od razu; zaczyna przenosić zarejestrowany ruch, gdy tylko jego kampania 10DLC zostanie zatwierdzona.

Kup jeden i zacznij wysyłać.

Wyszukaj według kraju i możliwości, kup numer i skieruj jego ruch przychodzący na webhook — tym samym klientem, którym wysyłasz. Ten sam kształt kodu udostępnia dowolny typ nadawcy; zmienia się tylko pole typu.

long-code.ts
201 · purchased
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();

Rejestracja jest częścią umowy.

Aby wysyłać ruch application-to-person na numery w USA, long code przebiega przez zarejestrowaną kampanię A2P 10DLC. Bird składa markę i kampanię z panelu i raportuje status zatwierdzenia przez API, więc wiesz dokładnie, kiedy pełna przepustowość jest dostępna.

FAQ dotyczące long code

Czym jest long code w ramach 10DLC?+
10-cyfrowy long code (10DLC) to standardowy lokalny numer telefonu dopuszczony do SMS-ów application-to-person w USA, gdy jego marka i kampania zostaną zarejestrowane u operatorów.
Jaką przepustowość otrzymuje long code?+
Zarejestrowane long codes w ramach 10DLC otrzymują zweryfikowaną przepustowość, która zależy od oceny zaufania marki i typu kampanii — większą niż numer niezarejestrowany, mniejszą niż short code.
Czy long code może odbierać odpowiedzi?+
Tak. Long codes są dwukierunkowe: skieruj ruch przychodzący numeru na webhook, a odpowiedzi przychodzą jako zdarzenia podpisane HMAC.
Kiedy powinienem przejść zamiast tego na short code?+
Gdy wolumen jeden-do-wielu przerasta to, co obsługuje przepustowość long code, lub gdy program potrzebuje wyższej, bardziej przewidywalnej przepustowości, jaką zapewnia weryfikowany przez operatorów short code.

Zacznij na long code, skaluj, gdy zajdzie potrzeba.

Long codes to jeden z typów nadawców w warstwie numerów SMS od Bird. Udostępnij jeden, zarejestruj kampanię i routuj ruch przychodzący z tego samego API, którym wysyłasz.

Zacznij od jednego kanału.
Dodaj kolejne, gdy będziesz gotowy.

Testowy klucz API otrzymasz od razu. Dostęp produkcyjny odblokujesz po dodaniu metody płatności i weryfikacji nadawcy.

Używasz Claude Code, Cursor lub Codex? Skopiuj prompt konfiguracyjny, a Twój agent zainstaluje za Ciebie Bird CLI i umiejętności. Wybierz swój:

Cursor