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.`,
  category: "authentication",
}).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.

Długie numery to jeden z czterech typów nadawców w interfejsie numerów Bird SMS, stanowiącym część szerszego Bird SMS API. Są lokalne, dwukierunkowe i szybkie w udostępnianiu — idealny punkt wyjścia dla większości ruchu konwersacyjnego i transakcyjnego, zanim wolumen uzasadni użycie krótkiego numeru.

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 dotrą jako podpisane zdarzenia — fundament 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 przekieruj ruch przychodzący na webhook — tym samym klientem, którym wysyłasz. Ta sama struktura kodu obsługuje każdy typ nadawcy; zmienia się tylko pole type.

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 długie numery 10DLC otrzymują zweryfikowaną przepustowość, która zależy od wyniku zaufania marki i typu kampanii: wyższą niż numer niezarejestrowany, niższą niż krótki numer.
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