Sign inGet Started

Szablony użytkowe WhatsApp

Szablon użytkowy dotyczy czegoś, co odbiorca już zrobił: zamówienia, płatności, rezerwacji, logowania. Katalog Bird zawiera osiem takich szablonów, w tym bird_signin_alert i bird_delivery_update. Kategorię danego slugu sprawdzaj na liście szablonów, a nie po jego nazwie: bird_signin_alert brzmi jak szablon uwierzytelniający, ale nim nie jest, to szablon użytkowy.

Zanim wyślesz

Wybierz zarządzany szablon z katalogu albo utwórz szablon użytkowy na połączonym koncie firmowym.

Wysyłanie szablonów z katalogu Bird nie wymaga od ciebie żadnej weryfikacji, tak samo jak w przypadku uwierzytelniania. Tworzenie własnego szablonu użytkowego również jej nie wymaga: w przeciwieństwie do uwierzytelniania wymóg weryfikacji firmy przez Meta nigdy nie dotyczy szablonów użytkowych, więc możesz je tworzyć i edytować w niezweryfikowanym obszarze roboczym. Informacje o tym, co weryfikacja odblokowuje w innych miejscach, znajdziesz w weryfikacji firmy w WhatsApp.

to może być numerem telefonu w formacie E.164 albo identyfikatorem użytkownika w zakresie firmy. Szablon użytkowy nie ma przycisku OTP, więc nie wymaga odbiorcy podanego wyłącznie jako numer telefonu, czego wymaga uwierzytelnianie.

Każdy zarządzany szablon użytkowy z katalogu jest zarejestrowany wyłącznie w języku en, z kodem on_missing_language: fail. Jeśli zażądasz języka, którego katalog nie zawiera, wysyłka zakończy się błędem, a nie przejdzie na angielski ani żaden inny język.

Wysyłanie szablonu użytkowego

POST /v1/whatsapp/messages z obiektem template wskazującym slug z katalogu:

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  template: {
    slug: "bird_order_confirmation",
    language: "en",
    parameters: { ref: "A1B2C3D4", amount: "USD 49.99" },
  },
});
console.log(msg.id, msg.status);

Jak w przypadku każdego zarządzanego szablonu pomiń from: Bird wybiera numer nadawcy na podstawie kategorii i regionu, a ustawienie tego pola zwraca 422 E15018 WhatsAppSenderNotAllowed. Tworzenie i wysyłanie własnego szablonu użytkowego działa tak samo jak każda wysyłka własnego szablonu; ogólne zasady opisuje Wysyłanie z szablonem.

Wypełnianie zmiennych

Zmienne w szablonach użytkowych są nazwane, więc każda z nich jest osobnym kluczem w parameters, na przykład ref i amount. Przycisk URL z numerowanym sufiksem {{1}} przyjmuje zamiast tego klucz button_url. Nazwany sufiks przyjmuje własną nazwę. Wysyłka przekazuje samą wartość, a nie pełny adres:

Przykład kodu
{ "parameters": { "ref": "A1B2C3D4", "button_url": "A-4192" } }

Wysyłka components podaje natomiast każdy parametr treści, a kolejność nazwanego parametru w tablicy nie ma znaczenia. Wspólne zasady dotyczące komponentów, sub_type oraz tego, jak components wysyłki odpowiadają symbolom zastępczym zadeklarowanym w szablonie, opisują strony Wysyłanie z użyciem szablonu i Komponenty i parametry.

Koszt

Szablon użytkowy dostarczony w otwartym oknie obsługi klienta kwalifikuje się do bezpłatnej stawki Meta do 30 września 2026 r.; od 1 października 2026 r. Meta pobiera za niego opłatę jak za każdy inny szablon użytkowy (zmiany cen z października 2026 r.). Opłata Bird za wiadomość wychodzącą jest naliczana podczas przetwarzania wiadomości, przed jej przekazaniem. To, czy obowiązuje opłata Meta, rozstrzyga późniejsze wywołanie zwrotne o dostarczeniu lub odczytaniu. Szacując łączny koszt, uwzględnij oba składniki.

Informacje o tym, kiedy wysyłka jest naliczana, znajdziesz na stronie Koszty i rozliczenia, a stawki na stronie Cennik WhatsApp.

Na co uważać

  • Meta może z własnej inicjatywy przekwalifikować szablon użytkowy na marketingowy, a wiadomość jest dalej wysyłana po nowej, wyższej cenie. Od kwietnia 2025 r. firma, którą Meta już ostrzegła za błędną kategoryzację, nie dostaje żadnego wcześniejszego powiadomienia, a zmiana następuje natychmiast. Nie umieszczaj w treści szablonu użytkowego języka promocyjnego, ofert ani propozycji dodatkowych zakupów, bo to one wywołują przekwalifikowanie. Co jest uznawane za promocyjne, opisuje strona Wytyczne dotyczące szablonów.
  • Nagłówek gif lub przycisk copy_code jest odrzucany poza kategorią marketingową. Oba są komponentami wyłącznie marketingowymi; zadeklarowanie któregokolwiek z nich w szablonie użytkowym kończy się błędem.
  • Własna wysyłka components nie jest sprawdzana pod kątem liczby parametrów przed naliczeniem opłaty. Jeśli we własnym szablonie wyślesz niewłaściwą liczbę parametrów w components, wiadomość zostanie przyjęta i obciążona opłatą, a następnie odrzucona przez Meta. Wysyłka parameters bez wymaganego klucza jest odrzucana przed naliczeniem jakiejkolwiek opłaty, a wysyłki z zarządzanego katalogu nie mają tej luki.
  • Nadawca na niewłaściwym koncie WhatsApp Business Account jest odrzucany przed naliczeniem jakiejkolwiek opłaty. from musi znajdować się na tym samym koncie co szablon; w przeciwnym razie wysyłka kończy się błędem 422 E15023 WhatsAppSenderWABAMismatch.

Następne kroki