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.
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: "+31612345678",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"
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.
- 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.
- 02
Dwukierunkowe domyślnie.
Skieruj ruch przychodzący numeru na webhook, a odpowiedzi dotrą jako podpisane zdarzenia — fundament przepływów konwersacyjnych.
- 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.
- 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ć.
Wyszukuj według kraju i możliwości, a następnie kup numer — za pomocą tego samego klienta, którym wysyłasz wiadomości. Ruch przychodzący jest kierowany przez webhook workspace'a subskrybujący sms.received, a nie per numer. Ta sama struktura kodu obsługuje każdy typ nadawcy; zmienia się tylko number_type.
// A US long code is a `local` number: the type names the numbering plan's
// own category, and "long code" is not one of them.
const { data: page, error: searchError } = await bird.numbers.available
.list({
country_code: "US",
number_type: "local",
capabilities: ["sms"],
})
.safe();
if (searchError) throw searchError;
const { data: order, error: orderError } = await bird.numbers.orders
.create({ number: page.data[0].number })
.safe();
if (orderError) throw orderError;
console.log(order.status, order.number_id); // → "completed" "nda_0ydh2yfw..."
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.
Zastosuj w praktyce.
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Inne sposoby wysyłki
Long codes to jeden z czterech typów nadawców. Porównaj pozostałe.
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.