Potwierdzenie zamówienia może ponownie wykorzystać swój tekst, zmieniając jedynie numer zamówienia dla każdego odbiorcy. Dzięki temu przebieg pracy pozostaje spójny, a zmieniają się tylko dane.
Co zawiera szablon?
Szablon zawiera stały tekst, definicje zmiennych i kategorię wiadomości, która klasyfikuje powód wysyłki. Miejsce docelowe może zastosować tę klasyfikację treści do swoich zasad rejestracji.
Każda zmienna wskazuje wartość, która zmienia się między wysyłkami, na przykład numer zamówienia. Szablon definiuje akceptowany typ zmiennej, to, czy jest wymagana, oraz ograniczenia dotyczące jej wartości.
Treści i szablony kampanii łączą tekst do ponownego użycia z wartościami właściwymi odbiorcy. Katalog szablonów Bird zawiera szablony systemowe do wiadomości uwierzytelniających i transakcyjnych. Szablony obszaru roboczego pozwalają publikować własny tekst w wielu językach. Tworzy się je przez API do zarządzania szablonami.
Przeczytaj definicje zmiennych przed wybraniem szablonu. Znajomo wyglądający podgląd nie gwarantuje, że wymagane wartości odpowiadają danym dostępnym w twojej aplikacji.
Czy szablony SMS wymagają zatwierdzenia?
Wbudowane szablony są gotowe do wysyłania. Publikacja szablonu obszaru roboczego sprawdza jego tekst i zmienne. Opublikowana wersja jest dostępna natychmiast, bez zatwierdzenia przez Meta. Reguły miejsca docelowego nadal mogą wymagać rejestracji treści.
To osobne procesy. Wielokrotnie używana treść wiadomości dostawcy sama w sobie nie zapewnia zgodności z przepisami miejsca docelowego.
Na przykład wytyczne TRAI dla nadawców wymagają rejestracji szablonów treści dla komunikacji za pośrednictwem zarejestrowanych tożsamości nadawczych w Indiach. Wymóg ten dotyczy struktury wiadomości, w tym części stałych i zmiennych.
Sprawdź wymagania miejsca docelowego przed wybraniem sposobu wysyłki. Rejestracja nadawcy dotyczy tożsamości nadawczej i może współistnieć z wymogiem dotyczącym treści.
Jak Bird wybiera kategorię i nadawcę?
Szablon dostarcza kategorię, czyli klasyfikację treści według celu wysyłki. Wbudowane szablony wybierają nadawcę dla miejsca docelowego; szablony obszaru roboczego używają podanego przez Ciebie nadawcy.
Wysyłka z szablonu odrzuca text, category i media_urls wraz z template. Pomiń from dla wbudowanego szablonu i podaj je dla szablonu obszaru roboczego. Kontrakt wysyłki z szablonu opisuje te wymagania.
Użyj szablonu obszaru roboczego lub dowolnego tekstu, gdy aplikacja musi wybrać konkretnego nadawcę.
Sprawdź from i category w odpowiedzi. Te pola informują, którego nadawcę i jaką klasyfikację treści Bird wybrał dla danej wiadomości.
Jak wysłać szablon w Bird?
Wskaż opublikowany szablon i podaj wartości jego zmiennych w obiekcie template wysyłki.
Zidentyfikuj go za pomocą slug lub id. Pobierz GET /v1/sms/templates/{template_ref}, aby odczytać jego live_version_id, a następnie GET /v1/sms/templates/{template_ref}/versions/{version_id}, aby uzyskać treść i definicje zmiennych.
Umieść wartości w parameters, używając nazwy zmiennej jako klucza. Brakujące wymagane wartości, niezadeklarowane klucze lub nieprawidłowe formaty zwracają 422, więc zwaliduj wartości przed uruchomieniem wysyłki.
Zserializowany obiekt parametrów musi mieścić się w 16 KB. Bird odrzuca żądanie przekraczające ten limit, więc ogranicz się do zadeklarowanych wartości szablonu.
Wybierz language, gdy to konieczne. Ustawienia językowe szablonu określają wartość domyślną i ewentualny fallback, więc sprawdź te ustawienia zamiast zakładać, że każdy żądany język istnieje.
Czy szablony zmieniają sposób rozliczania SMS?
Wyrenderowany tekst jest liczony tak samo jak każda inna treść SMS.
Wstaw rzeczywiste wartości przed szacowaniem segmentów. Długi numer zamówienia lub nazwa spoza kompaktowego alfabetu mogą zwiększyć liczbę.
Odwołanie do szablonu nie oznacza stałej ceny dla każdego odbiorcy. Pole segments.count w odpowiedzi podaje rozliczane części dla danej wyrenderowanej wiadomości.
Kiedy wybrać szablon?
Wybierz szablon z katalogu, gdy jego treść, zmienne i sposób wyboru nadawcy pasują do twojego przepływu pracy.
- Użyj szablonu, gdy dostarczona treść odpowiada wiadomości i masz jego wymagane wartości.
- Opublikuj szablon obszaru roboczego do wielokrotnego używania tekstu z własnym nadawcą lub użyj dowolnego tekstu w pojedynczej wiadomości.
- Zastosuj wymagania rejestracyjne miejsca docelowego do obu wariantów.
W skrócie
Szablony zawierają tekst do ponownego użycia i definicje zmiennych.
Wybierz wbudowany szablon lub opublikowany szablon obszaru roboczego, a następnie podaj wymagane wartości.
Wybór nadawcy zależy od zakresu szablonu.
Wbudowane szablony używają nadawcy wybranego przez Bird. Szablony obszaru roboczego wymagają nadawcy należącego do Ciebie. Szablon dostarcza kategorię.
Publikacja w obszarze roboczym nie wymaga weryfikacji przez Meta.
Publikacja szablonu obszaru roboczego sprawdza poprawność jego wersji roboczej. Opublikowana wersja jest od razu dostępna do wysyłania. Reguły rejestracji treści w miejscu docelowym pozostają odrębne.
Podstawione wartości nadal wpływają na liczbę segmentów.
Sprawdź wyrenderowaną wiadomość, ponieważ dłuższe wartości mogą zwiększyć liczbę rozliczanych segmentów.