Aktualizacja zamówienia wymaga ustalonego tekstu i szczegółów dotyczących konkretnego zakupu. Szablon oddziela zatwierdzony tekst od wartości takich jak numer zamówienia.
Kiedy potrzebuję szablonu?
Użyj zatwierdzonego szablonu, gdy wysyłasz poza 24-godzinnym oknem serwisowym klienta.
W otwartym oknie możesz odpowiadać treścią dowolnej formy. Wysłanie szablonu samo w sobie nie otwiera tego okna ponownie; robi to odpowiedź klienta.
Zatwierdzenie nie zastępuje zgody klienta. Stosuj zasady przesyłania wiadomości Meta dla wiadomości, którą zamierzasz wysłać.
Co zawiera szablon w Bird?
Szablon identyfikuje treść wielokrotnego użytku, a jego wersje przechowują tekst dla poszczególnych języków.
Podczas wysyłki używaj slug. Nazwa wyświetlana oznacza szablon, ale nie jest identyfikatorem używanym do rozwiązania wysyłki.
Podczas tworzenia szablonu wybierz authentication, marketing lub utility. Bird utrwala zadeklarowaną kategorię i slug po utworzeniu.
Treść języka zawiera wymagany blok body. Może też zawierać header, footer, buttons lub carousel, zgodnie z regułami treści szablonu.
Aby sprawdzić zatwierdzoną treść, odczytaj live_version_id z szablonu. Następnie pobierz język tej wersji za pomocą polecenia języka.
Szablon bez aktywnej wersji nie może wysyłać. Jego wersja robocza nadal może zawierać treść, która nie przeszła weryfikacji.
Którego języka i kategorii użyje wysyłka?
Sprawdź available_languages, aby znaleźć języki gotowe do wysyłki. Sprawdź category danego języka, aby poznać klasyfikację cenową Meta.
Pole status szablonu podsumowuje jego języki. Szablon active ma co najmniej jeden język gotowy do wysyłki. Inny język może być odrzucony, wstrzymany lub wyłączony.
Meta może cofnąć zatwierdzenie lub dostępność języka po uruchomieniu. Sprawdzaj stan języka przy wysyłce, zamiast polegać na stałej liście z momentu wdrożenia.
Meta może też przeklasyfikować język bez zmiany zadeklarowanej przez Ciebie kategorii. Używaj klasyfikacji tego języka razem z opublikowanymi stawkami WhatsApp przy szacowaniu kosztów.
Sprawdź kategorię na przykładach przed przesłaniem języka:
| Przykładowa treść | Lekcja dotycząca zamierzonej kategorii |
|---|---|
Your order {{reference}} has shipped. | Konkretna aktualizacja transakcji to wzorzec utility |
Your code is {{code}}. | Wiadomość uwierzytelniająca używa kategorii authentication i jej reguł tworzenia |
Get 20% off your next order. | Oferta promocyjna należy do ścieżki marketing |
Przykłady powinny być ilustracyjne. Meta weryfikuje przesłany język i może zaklasyfikować go inaczej niż wybrana przez Ciebie kategoria.
Ustaw on_missing_language, aby zdecydować, co się stanie, gdy żądany język nie ma dostępnej treści. Bird domyślnie ustawia nowe szablony WhatsApp na fail. Każdy język jest zatwierdzany i wyceniany osobno, więc cicha podmiana może wysłać nieoczekiwaną treść po niezamierzonej stawce.
Ta polityka nadal dopuszcza szerszy tag: pt może obsłużyć żądanie dla pt-BR. Nie podmienia wariantu siostrzanego pt-PT.
Wybierz fallback tylko wtedy, gdy podmiana skonfigurowanego domyślnego języka jest akceptowalna dla Twoich odbiorców. Szablony zarządzane przez Bird zachowują swoją stałą politykę brakującego języka.
Jak zmienić przesłaną treść?
Utwórz nową wersję roboczą. Napisz poprawiony język. Prześlij tę wersję do weryfikacji.
Bird zachowuje przesłane wersje jako niezmienne, więc edycja etykiety szablonu nie zmienia zatwierdzonej treści wiadomości.
| Pole | Co oznacza |
|---|---|
draft_version_id | Istnieje nieprzesłana wersja robocza |
pending_version_id | Przesłana wersja ma jeszcze nierozstrzygnięte języki |
live_version_id | Ta wersja dostarcza treść używaną do wysyłki |
Zatwierdzenie jednego języka może uczynić całą jego wersję aktywną. Inne języki w tej wersji mogą nadal oczekiwać na weryfikację lub być odrzucone.
Sprawdź język przesłanej wersji, aby śledzić weryfikację. Szablon może nadal pokazywać wcześniejszą aktywną wersję, gdy zamiennik oczekuje na zatwierdzenie.
Jak wysłać szablon?
Wskaż szablon. Podaj zmienne wymagane przez język, który zamierzasz wysłać.
Znajdź dostępne szablony za pomocą:
bird whatsapp templates listUżyj bird whatsapp templates get, aby sprawdzić wybrany szablon. Pobierz treść jego języka przed złożeniem components wysyłki, które przenoszą wartości zmiennych tego szablonu.
W panelu szczegóły szablonu zawierają przykład cURL z przykładowymi wartościami tego szablonu. Przed wysyłką zastąp odbiorcę, dane uwierzytelniające i zmienne swoimi wartościami.
Utworzony szablon wymaga nadawcy na tym samym koncie WhatsApp Business Account. Postępuj zgodnie z procedurą wysyłki. Śledź zwrócony identyfikator wiadomości przez zdarzenia dostarczenia.
Odpowiedź 202 przyjmuje żądanie do przetworzenia. Potwierdź dostarczenie na podstawie późniejszego wyniku, zanim uznasz wiadomość za odebraną.
W skrócie
Sprawdź język przed wysyłką.
Aktywny szablon może zawierać niedostępne języki. Użyj
available_languages, aby sprawdzić, czy język odbiorcy może wysyłać.Odczytaj kategorię języka.
Meta może zaklasyfikować język inaczej niż zadeklarowana przez Ciebie kategoria. Ceny zależą od klasyfikacji Meta.
Edytuj przez nową wersję roboczą.
Bird zamraża przesłane wersje. Utwórz nową wersję roboczą, aby zmienić treść. Prześlij poprawiony język do weryfikacji.
Wyślij zatwierdzoną treść z jej zmiennymi.
Wskaż szablon i podaj wartości, których oczekuje jego język. Zaakceptowane żądanie nie gwarantuje dostarczenia.