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ż suppresję 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 blokuje wszystkie: Bird odrzuca wysyłkę do każdego kraju, którego Twój obszar roboczy nie włączył. Sekcja Wysyłanie SMS opisuje ten warunek wstępny, a Wyślij pierwszy SMS przeprowadza przez pierwszą wysyłkę.

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:

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.

• Wyślij pierwszą wiadomość SMS: klucz API, miejsce docelowe, wysyłka z wbudowanym szablonem i jej status dostarczenia
• Wysyłanie SMS: API wysyłki: miejsca docelowe, nadawcy, treść, segmenty, kategorie, tagi
• Limity znaków: kodowanie GSM-7 i UCS-2, limity na segment i ograniczenie do 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 do 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, ponowne próby i powtórki
• 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 pokazujący, co zwraca wysyłka do wyłączonego miejsca docelowego