Przegląd SMS
Bird SMS wysyła wiadomości tekstowe przez tę samą platformę i klucze API co Bird Email. Wywołaj Bird z kluczem bk_{region}_… na swoim regionalnym hoście (https://us1.platform.bird.com lub https://eu1.platform.bird.com). Bird wybiera trasę do operatora odbiorcy, dzieli tekst na rozliczane segmenty i raportuje każdą wiadomość przez potwierdzenie dostarczenia. Endpointy SMS zaczynają się od /v1/sms/.
Możesz wysłać dowolny tekst z wybranym nadawcą i kategorią albo użyć jednego z wbudowanych szablonów Bird, który dostarcza treść, kategorię i nadawcę. Bird odbiera też odpowiedzi na Twoje numery. Przechowuje każdą wiadomość przychodzącą obok Twoich wysyłek i emituje sms.received. Gdy odpowiedź pasuje do obsługiwanego słowa kluczowego rezygnacji, takiego jak STOP, Bird zapisuje również blokadę nadawca–subskrybent. Szczegóły pokrycia i konfiguracji znajdziesz w sekcji Rezygnacje i słowa kluczowe.
Jak działa wysyłanie
Wyślij SMS za pomocą POST /v1/sms/messages: jeden odbiorca i jedna wiadomość, zawierająca albo własną treść text z nadawcą i kategorią, albo referencję template z wartościami zmiennych. Bird waliduje żądanie i cel, rozwiązuje nadawcę i zwraca 202 Accepted z identyfikatorem wiadomości. Dostarczenie odbywa się potem asynchronicznie. Śledź wynik przez zdarzenia i webhooki lub endpointy odczytu wiadomości. Aby wysłać wiele niezależnych wiadomości w jednym wywołaniu, użyj endpointu wsadowego.
Trzy idee kształtują całe API:
- Wysyłanie i dostarczenie to oddzielne etapy. 202 oznacza, że Bird przyjął wiadomość. Operator przetwarza ją po przyjęciu i może zwrócić potwierdzenie dostarczenia później. Potwierdzenie niepowodzenia to również wynik końcowy; sprawdź zgłoszony status, zanim uznasz wysyłkę za dostarczoną.
- Tekst jest rozliczany w segmentach. Wiadomość dłuższa niż jeden segment jest dzielona i rozliczana za segment, a pojemność segmentu zależy od użytych znaków. Sekcja Limity znaków zawiera zasady kodowania, pełny zestaw znaków i sposoby na zmieszczenie wiadomości w jednym segmencie.
- Cel wysyłki ma znaczenie. Każda wiadomość niesie kategorię: transactional, marketing, authentication lub service. Bird i operatorzy używają jej do rozpoznania przeznaczenia wiadomości. Przy wysyłce szablonowej kategoria pochodzi z szablonu.
Przed pierwszą wysyłką włącz kraje docelowe, które obsługujesz, w sekcji SMS > Destinations. Lista dozwolonych krajów domyślnie zawiera tylko kraj macierzysty Twojej organizacji. Bird odrzuca wysyłkę do każdego innego kraju. Sekcja Wysyłanie SMS opisuje ten warunek wstępny.
Do jednorazowych kodów weryfikacyjnych rozważ użycie Bird Verify zamiast samodzielnego tworzenia wiadomości. Verify generuje i dostarcza kod przez SMS lub e-mail, sprawdza odpowiedź i egzekwuje wygaśnięcie, limity prób oraz odstępy między ponownymi wysyłkami.
Aplikacja SMS w dashboardzie
W dashboardzie SMS jest jednym z produktów na pasku bocznym. Poniżej jego strony i lokalizacja przewodnika do każdej z nich:
| Strona | Do czego służy |
|---|---|
| Messages | Każda wysłana wiadomość z osią czasu zdarzeń i szczegółami dostarczenia. Przewodnik: Log SMS |
| Templates | Wbudowane szablony do wysyłki: nazwa, kategoria, języki i zmienne. Przewodnik: Szablony SMS |
| Metrics | Współczynnik dostarczenia, współczynnik błędów i przyjęty wolumen w czasie. Przewodnik: Metryki SMS |
| Senders | Identyfikatory nadawców i numery, z których możesz wysyłać, oraz gdzie każdy z nich jest zarejestrowany. Przewodnik: Identyfikatory nadawców SMS |
| Destinations | Kraje, do których Twój obszar roboczy może wysyłać; włącz kraj docelowy przed wysyłką. Przewodnik: Wysyłanie SMS |
Widoczność
Używaj rekordów wiadomości i dostępnej osi czasu zdarzeń do badania przyjęcia, przekazania do operatora i wyników dostarczenia. Szczegóły wiadomości obejmują segmenty i ewentualne wycenione składniki kosztów. Publiczne odczyty wiadomości obejmują okno retencji opisane w sekcji Log SMS.
- Log SMS: widok pojedynczej wiadomości w dashboardzie. Każda wysyłka, jej oś czasu zdarzeń, segmenty, koszt i szczegóły operatora.
- Metryki SMS: zagregowany współczynnik dostarczenia, współczynnik błędów, przyjęty wolumen i opóźnienie dostarczenia dla wszystkich Twoich wysyłek.
- Zdarzenia: słownik zdarzeń SMS, cykl życia wiadomości i dostarczanie webhooków do Twoich endpointów.
Następne kroki
Poznaj platformę SMS do kampanii, wiadomości aplikacyjnych i odpowiedzi lub skorzystaj z biblioteki zasobów SMS, aby wybrać przepływ pracy.
| Strona | Co opisuje |
|---|---|
| Wysyłanie SMS | Wysyłanie API: kraje docelowe, nadawcy, treść, segmenty, kategorie, tagi |
| Limity znaków | Kodowanie GSM-7 i UCS-2, limity na segment i limit 12 segmentów |
| Szablony SMS | Wbudowany katalog szablonów i wysyłanie przez referencję szablonu |
| Identyfikatory nadawców SMS | Wybór typu nadawcy i rejestracja w poszczególnych krajach docelowych |
| Rejestracja 10DLC | Rejestracja marki, kampanii i numeru na potrzeby wysyłki A2P w USA |
| Log SMS | Każda wiadomość, jej oś czasu zdarzeń, segmenty i koszt |
| Metryki SMS | Współczynnik dostarczenia, współczynnik błędów i opóźnienie |
| Zdarzenia | Typy zdarzeń SMS i dostarczanie webhooków |
| Webhooki i zdarzenia | Konfiguracja endpointu, weryfikacja podpisu, ponawianie i odtwarzanie |
| Przegląd Verify | Jednorazowe kody weryfikacyjne przez SMS i e-mail, wysyłane i sprawdzane przez Bird |
| Kontroluj, dokąd Twoje konto może wysyłać | Film: pokazuje, co zwraca wysyłka do wyłączonego kraju docelowego |
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Obejrzyj przewodnikSMS pumping explainedZrozum koncepcjęWhat is SMS pumping, and how do I stop it?Poznaj możliwościSMS destinationsPodążaj ścieżką naukiBuild your first integration
Uzyskaj brief wdrożeniowy