Wytyczne dotyczące szablonów WhatsApp

Szablon, który tworzysz, musi przejść kontrolę Bird przy wysyłce i recenzję Meta, zanim będzie można go użyć. Ta strona wyjaśnia limity treści sprawdzane przez Bird, sposób podawania zmiennych oraz reagowanie na decyzję recenzji. Przejście lokalnej walidacji nie gwarantuje zatwierdzenia przez Meta ani późniejszego dostarczenia.

Bird udostępnia też gotowe szablony katalogowe. Przeczytaj Szablony WhatsApp, żeby sprawdzić dostępne języki i aktualną możliwość wysyłki, oraz Tworzenie szablonów, żeby utworzyć szablon na własnym koncie.

Limity znaków na komponent

Bird sprawdza te limity przy przesyłaniu tworzonej treści:

Komponent	Limit	Uwagi
Nagłówek tekstowy	60 znaków	Jeden nagłówek na szablon, obsługuje co najwyżej jedną zmienną
Treść	1024 znaki	Obsługuje wiele zmiennych
Stopka	60 znaków	Bez zmiennych
Etykieta przycisku	25 znaków	Dotyczy przycisków połączenia, URL i szybkiej odpowiedzi
Adres docelowy przycisku URL	2000 znaków	Obsługuje jedną zmienną dołączaną na końcu URL-a
Wartość przycisku kopiowania kodu	20 znaków	Ciąg znaków kopiowany do schowka urządzenia

Treść karty karuzeli ma osobny limit 160 znaków. Obowiązują też reguły kategorii i komponentów: szablon uwierzytelniający używa tekstu generowanego przez Meta, a nagłówki GIF, karuzele i przyciski kopiowania kodów kuponowych należą do szablonów marketingowych w procesie tworzenia Bird. Sprawdź odpowiedź walidacji dla danego języka i pola.

Zmienne

Zmienne to fragmenty szablonu uzupełniane w momencie wysyłki. Dopasuj format do komponentu, który tworzysz:

Bird tworzy szablony uwierzytelniające z parametrami pozycyjnymi, zapisywanymi jako {{1}} i {{2}}. Ich treść pochodzi z formatu uwierzytelniającego Meta. Tekst główny w szablonach utility i marketingowych używa parametrów nazwanych, np. {{order_number}}.
Pozycyjne symbole zastępcze to numery indeksów od {{1}} wzwyż, a wartości przykładowe i wysyłkowe są odczytywane w kolejności występowania symboli. Treść, która przeskakuje z {{2}} do {{5}}, zostaje odrzucona.
Nazwane symbole zastępcze używają małych liter, cyfr i podkreślników, np. {{order_number}}, a żadna nazwa nie powtarza się w obrębie jednego języka. Ich wartości są dopasowywane po nazwie, nie po pozycji, więc kolejność podania nie ma znaczenia.
Każdy symbol zastępczy otocz podwójnymi nawiasami klamrowymi. Tekst karty karuzeli używa parametrów pozycyjnych i pozycyjnych wartości przykładowych. Zmienny przycisk URL używa jednego końcowego symbolu pozycyjnego, np. https://example.com/orders/{{1}}, nawet gdy treść szablonu korzysta z parametrów nazwanych.
Nie umieszczaj wewnątrz symbolu zastępczego znaków specjalnych, takich jak #, $ i %.
Nie rozpoczynaj ani nie kończ szablonu zmienną. Meta odrzuca wiszące parametry, ponieważ wiadomość zaczynająca się lub kończąca podstawionym tekstem nie daje odbiorcy kontekstu.
Otocz każdy symbol zastępczy stałym tekstem opisującym podstawianą wartość. Meta odrzuca szablon, w którym jest zbyt wiele symboli zastępczych w stosunku do tekstu, ponieważ treść złożona głównie ze zmiennych wygląda jak pusty formularz, a nie wiadomość. Dodaj treść albo zmniejsz liczbę zmiennych.
Dołącz do szablonu wartości przykładowe. Recenzja opiera się na wyrenderowanym podglądzie, a zgłoszenie bez wartości przykładowych nie może zostać ocenione.

Formatowanie

WhatsApp obsługuje niewielki zestaw formatowania inline w treści: pogrubienie, kursywę, przekreślenie i czcionkę stałej szerokości. Emoji są dozwolone w treści i przyciskach, a nagłówek tekstowy nie obsługuje żadnego znacznika formatowania.

Meta nie akceptuje HTML, linków stylizowanych jako tekst kotwicy ani sterowania długością wiersza poza wstawianymi przez Ciebie łamaniami linii. URL w treści wiadomości jest wyświetlany jako zwykły link, i właśnie temu służą przyciski URL.

Recenzja i zatwierdzenie

Dodanie nowego języka lub edycja uruchamia odpowiedni proces recenzji. Sprawdzaj bieżący status w Bird i WhatsApp Manager, zamiast planować wysyłkę w oparciu o gwarantowany czas decyzji. Przed wysyłką potwierdź, że żądany język jest dostępny, numer wysyłkowy należy do właściwego konta, a odbiorca kwalifikuje się do otrzymania wiadomości.

Zatwierdzenie i jakość to osobne kwestie. Meta aktualizuje ocenę jakości szablonu na podstawie użycia i informacji zwrotnych od odbiorców. Średnia lub niska ocena wymaga analizy; wstrzymany lub wyłączony język jest niedostępny do wysyłki. Śledź bieżący status i działanie sugerowane przez Meta, zamiast zakładać, że zmiana oceny automatycznie przywraca dostępność.

Bird pokazuje zarówno status, jak i werdykt dla poszczególnych języków na samym szablonie. Szablony WhatsApp definiuje każdą wartość i jej znaczenie dla wysyłki.

Dlaczego szablony są odrzucane

Sprawdź powód zwrócony dla danego języka. Typowe problemy to:

Formatowanie zmiennych. Niedopasowane nawiasy klamrowe, niesekwencyjne symbole zastępcze, zmienna na samym początku lub końcu albo więcej zmiennych niż stałego tekstu.
Duplikacja. Szablon, którego treść i stopka pokrywają się z tekstem już zarejestrowanym na Twoim koncie, zostaje odrzucony jako duplikat. Meta wskazuje istniejący szablon w odrzuceniu, więc możesz wysłać tamten. Szablony uwierzytelniające są wyłączone z tego sprawdzenia.
Polityka. Treść naruszająca WhatsApp Business Messaging Policy lub, w przypadku wiadomości transakcyjnych, Commerce Policy. Towary zakazane to najbardziej oczywisty przypadek, ale dotyczy to też wiadomości, której celu odbiorca nie rozpozna jako pochodzącego od Ciebie.
Błędna kategoryzacja. Najczęściej wiadomość marketingowa zgłoszona jako utility. Kategoria wpływa zarówno na to, co Meta dopuszcza, jak i na koszt wiadomości, więc Meta ją koryguje, zamiast przepuszczać.

Sprawdź decyzję w WhatsApp Manager lub Business Support Home oraz w powiadomieniach od Meta. Napraw zgłoszony problem i prześlij szablon ponownie. Jeśli decyzja oferuje odwołanie i się z nią nie zgadzasz, podaj wymagany kontekst i wartości przykładowe. Śledź status recenzji; zatwierdzenie i czas zakończenia nie są gwarantowane.

Następne kroki

Szablony WhatsApp: katalog, statusy i zmienne w Bird
Wysyłanie wiadomości WhatsApp: uzupełnianie zmiennych szablonu przy wysyłce
Okno obsługi klienta WhatsApp: kiedy potrzebujesz szablonu, żeby skontaktować się z kimś

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikBuilding and submitting a WhatsApp template Zrozum koncepcjęWhat is a WhatsApp message template?Użyj narzędziaWhatsApp message builder Poznaj możliwościWhatsApp templates

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy