Sign inGet Started

Szablony marketingowe WhatsApp

Szablon marketingowy zawiera treść promocyjną, taką jak oferta, zapowiedź produktu lub kupon. Przed wysłaniem przygotuj zatwierdzoną treść, uzyskaj zgodę odbiorcy i ustal jasny sposób obsługi odpowiedzi oraz rezygnacji.

WhatsApp Studio wysyła wiadomości do jednego odbiorcy naraz. Broadcast wysyła szablon marketingowy do całej grupy odbiorców z poziomu panelu. Informacje o planowaniu kampanii znajdziesz w artykule WhatsApp Studio i kampanie marketingowe.

Zanim wyślesz

Zarządzany katalog Bird nie zawiera żadnych szablonów marketingowych, dlatego wysyłka marketingowa zawsze korzysta z szablonu utworzonego w Twoim obszarze roboczym, na Twoim własnym koncie WhatsApp Business Account:

  1. Połącz konto WhatsApp Business Account i własny numer. Zobacz Konfiguracja numeru telefonu.
  2. Utwórz szablon marketingowy i prześlij go do weryfikacji. Informacje o tym, co zostanie zatwierdzone, znajdziesz w artykule Wytyczne dotyczące szablonów.
  3. Wysyłaj z numeru na tym samym koncie WhatsApp Business Account co szablon. Przy wysyłce marketingowej from jest wymagane, a nadawca z innego konta zostaje odrzucony 422 E15023 WhatsAppSenderWABAMismatch, zanim zostanie naliczona jakakolwiek opłata.

Wysyłanie szablonu marketingowego

POST /v1/whatsapp/messages z ustawionym from i obiektem template wskazującym Twój własny slug:

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13125550101",
  template: {
    slug: "summer_sale",
    language: "en",
    parameters: {
      header_url: "https://cdn.example.com/banners/summer.png",
      first_name: "Pablo",
      code: "SUMMER25",
    },
  },
});
console.log(msg.id, msg.status);
  • Zmienne w treści mają nazwy, tak samo jak w szablonach użytkowych, więc first_name to osobny klucz.
  • Kod przycisku kuponu trafia do code, tak jak w przykładzie powyżej. Nie ma osobnego klucza na kupon.
  • Nagłówek multimedialny przyjmuje header_url, niezależnie od tego, czy to obraz, wideo czy gif. Pomiń go, aby wysłać zatwierdzoną próbkę szablonu. Szablon zaimportowany z Meta nie ma próbki, więc wymaga header_url. Marketing to jedyna kategoria, która akceptuje nagłówek z animowanym GIF-em.
  • Multimedia i numerowany sufiks URL karty karuzeli przyjmują numerowane klucze: header_url_1 i button_url_1 dla pierwszej karty, header_url_2 dla drugiej i tak dalej. Nadaj nazwy zmiennym wewnątrz kart. Nazwa użyta w dwóch kartach to jeden klucz, więc obie karty dostają tę samą wartość. Karuzela, w której każda karta numeruje {{1}}, przyjmuje tylko components z wartościami w cards, a taka wysyłka musi zawierać dokładnie tyle kart, z iloma szablon został zatwierdzony.

Bird automatycznie kieruje każdą wysyłkę marketingową do Marketing Messages API firmy Meta. Nie musisz tego włączać i nie ma przełącznika dla pojedynczej wysyłki. Status onboardingu konta firmowego w tym API decyduje o optymalizacjach Meta, a nie o samym dostarczaniu. Wyjątkiem są nagłówki gif, które wymagają konta po onboardingu. Stan konta, możliwości odblokowywane przez onboarding oraz kraje, w których marketing jest ograniczony, opisuje strona Szablony marketingowe.

Rezygnacje

Gdy Bird otrzyma od Meta prawidłowe zdarzenie wstrzymania marketingu, zapisuje preferencję odbiorcy dla tego konta firmowego. Ta preferencja jest niezależna od suppresji wszystkich wiadomości. Przed wysyłką sprawdź oba rekordy. Błąd dostarczenia może dotrzeć przed odpowiadającym mu zdarzeniem preferencji. Uszanuj wybór odbiorcy i zbadaj tę historię, zamiast próbować ponownie. Zapisywanie i odczytywanie tych rekordów opisuje strona Preferencje.

Koszt

Stosuj opublikowaną stawkę marketingową dla kraju docelowego i waluty albo ustaw cenę maksymalną, aby zmienna opłata Meta za dostarczenie nie przekroczyła Twojego limitu. Bird pobiera swoją opłatę za wiadomość wychodzącą przed jej przesłaniem. Płatne dostarczenie lub odczytanie może doliczyć opłatę Meta. Zobacz Koszty i rozliczenia oraz Cennik WhatsApp.

Na co uważać

  • Cenę określa kategoria nadana przez Meta. Meta może po zatwierdzeniu przeklasyfikować treści promocyjne jako marketingowe. Przed wysyłką sprawdź aktualną kategorię każdego języka. Wysyłka z ceną maksymalną wymaga kategorii marketingowej. Jeśli nie zgadzasz się z klasyfikacją, zobacz proces weryfikacji kategorii przez Meta.
  • 131049 oznacza wstrzymanie dostarczania, a nie skonfigurowany przez Ciebie limit, a ponowne próby pogarszają sytuację. Meta zgłasza 131049 zarówno przy ogólnym wstrzymaniu w USA, jak i przy limicie wiadomości marketingowych na użytkownika, i zaleca odczekanie około doby przed ponowną wysyłką. Wcześniejsza ponowna wysyłka może na dłużej uczynić konto niedostępnym dla tego odbiorcy i zaniża Twój wskaźnik dostarczeń. Bird zgłasza ten błąd jako rate_limited.
  • 131050 oznacza, że odbiorca wyłączył "Offers and announcements", i nigdy nie należy ponawiać takiej wysyłki. Meta przyjmuje wysyłkę, a następnie odmawia jej dostarczenia. Właściwą reakcją jest ścieżka preferencji wiadomości, a nie ponowna wysyłka: obejmij odbiorcę suppresją samodzielnie albo poczekaj, aż ponownie włączy dostarczanie. Bird dowiaduje się o tym przez ten sam mechanizm preferencji, który zgłosił rezygnację. Zobacz Preferencje.
  • 132015 i 132016 oznaczają wstrzymanie szablonu, a nie problem z odbiorcą. 132015 to wstrzymanie z powodu niskiej jakości; 132016 to trwałe wyłączenie po wielokrotnych wstrzymaniach, a jedynym rozwiązaniem jest nowy szablon z inną treścią. Sprawdzaj status konkretnej wersji językowej, a nie całego szablonu, ponieważ wstrzymana wersja językowa natychmiast przestaje wysyłać wiadomości.
  • Nadawca na niewłaściwym koncie WhatsApp Business Account zostaje odrzucony przed naliczeniem jakiejkolwiek opłaty. from musi należeć do tego samego konta co szablon, w przeciwnym razie wysyłka kończy się błędem 422 E15023 WhatsAppSenderWABAMismatch.

Kolejne kroki

  • Szablony WhatsApp: przeglądanie katalogu i wspólne zasady wysyłki na podstawie szablonu
  • Szablony marketingowe: Marketing Messages API, status onboardingu i kraje, w których marketing jest ograniczony
  • Preferencje: zapisywanie i odczytywanie deklaracji odbiorców
  • Szablony użytkowe: aktualizacje zamówień, przypomnienia o wizytach i powiadomienia dotyczące konta