Sign inGet started

Szablony marketingowe WhatsApp

Szablon marketingowy zawiera treści promocyjne: budowanie świadomości, sprzedaż, retargeting lub kupon. To najszersza kategoria szablonów, jedyna, do której Meta przeniesie szablon z własnej inicjatywy, i jedyna, w której źle obsłużony błąd obniża dostarczalność, a nie tylko powoduje niepowodzenie jednej wysyłki.

Zanim wyślesz

Zarządzany katalog Bird nie zawiera żadnego szablonu marketingowego, więc wysyłka marketingowa zawsze korzysta z szablonu utworzonego w Twoim obszarze roboczym, na własnym koncie WhatsApp Business Account:
  1. Podłącz własne konto WhatsApp Business Account i własny numer. Zobacz Konfiguracja numeru telefonu.
  2. Utwórz szablon z kategorią marketing i prześlij go do recenzji. Zobacz Wytyczne dotyczące szablonów, aby dowiedzieć się, co przechodzi weryfikację.
  3. Wysyłaj z numeru na tym samym koncie WhatsApp Business Account co szablon. from jest wymagany przy wysyłce marketingowej, a nadawca z innego konta zostanie odrzucony 422 E15023 WhatsAppSenderWABAMismatch zanim cokolwiek zostanie naliczone.

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",
    components: [
      {
        type: "header",
        parameters: [{ type: "image", url: "https://cdn.example.com/banners/summer.png" }],
      },
      { type: "body", parameters: [{ type: "text", name: "first_name", text: "Pablo" }] },
      { type: "button", parameters: [{ type: "text", text: "SUMMER25" }] },
    ],
  },
});
console.log(msg.id, msg.status);
  • Parametry body są nazwane, tak samo jak w szablonach utility. Każdy parametr zawiera name, a kolejność w tablicy nie ma znaczenia.
  • Kod przycisku kuponowego to zwykły parametr text, taki jak ten na przycisku powyżej. Nie istnieje osobny typ parametru dla kodu kuponu.
  • Nagłówek gif przyjmuje parametr gif, a nie video ani image. Marketing to jedyna kategoria akceptująca nagłówek z animowanym GIF-em.
  • Wartości karuzeli trafiają do cards, a nie parameters, a 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 od Meta; nie musisz tego włączać i nie ma przełącznika per wysyłka. Status onboardingu konta biznesowego w tym API warunkuje optymalizacje Meta, a nie samą dostarczalność, z jednym wyjątkiem: nagłówek gif wymaga konta po onboardingu, w przeciwnym razie wysyłka kończy się błędem na etapie WhatsApp. Zobacz Szablony marketingowe, aby poznać stan konta, co odblokowuje onboarding i gdzie marketing jest ograniczony według kraju.

Rezygnacje

Marketing to kategoria, w której obsługa rezygnacji ma największe znaczenie: to jedyna kategoria, którą odbiorca może wyłączyć samodzielnie, niezależnie od wszystkich innych wiadomości, które mu wysyłasz. WhatsApp daje każdemu odbiorcy kontrolę "Offers and announcements" w profilu Twojej firmy, a Meta egzekwuje ją po swojej stronie, przyjmując wysyłkę, a następnie odmawiając dostarczenia. Sprawdź własną listę blokad przed wysyłką i traktuj rosnącą liczbę błędów 131050 poniżej dla jednego odbiorcy jako powód do samodzielnego zablokowania go, ponieważ zatrzymanie wykonane wewnątrz WhatsApp nigdy nie pojawia się na tej liście. Zobacz Rezygnacje, aby dowiedzieć się, jak rejestrować i odczytywać oba magazyny.

Koszt

Marketing to najdroższa kategoria, a stawka obowiązuje niezależnie od tego, który API obsłużył wysyłkę: Cloud API czy Marketing Messages. Zobacz Koszty i rozliczenia, aby dowiedzieć się, kiedy wysyłka jest naliczana, oraz Cennik WhatsApp po stawki.

Na co uważać

  • Meta przekategoryzowuje do marketingu, nigdy z niego, a to zmiana ceny. Szablon, który Meta uzna za promocyjny w treści, staje się marketing niezależnie od przesłanej kategorii, a wysyłka nadal wychodzi po nowej, wyższej cenie. Nie ma możliwości rezygnacji ani edycji kategorii z powrotem; jedynym rozwiązaniem jest nowy szablon.
  • 131049 to wstrzymanie dostarczania, a nie skonfigurowany przez Ciebie limit, i ponowne próby pogarszają sytuację. Meta zgłasza 131049 zarówno dla ogólnego wstrzymania w USA, jak i dla limitu marketingowego na użytkownika, a zalecenie Meta to odczekanie mniej więcej doby przed ponowną wysyłką. Wcześniejsza ponowna wysyłka może sprawić, że konto będzie niedostępne dla tego odbiorcy na dłużej i zaburza Twoją dostarczalność. Bird zgłasza ten błąd jako rate_limited.
  • 131050 oznacza, że odbiorca wyłączył "Offers and announcements", i nigdy nie wolno ponawiać wysyłki. Meta przyjmuje wysyłkę, a następnie odmawia dostarczenia. Prawidłowa reakcja to ścieżka preferencji wiadomości, a nie ponowna wysyłka: zablokuj odbiorcę samodzielnie lub poczekaj, aż ponownie włączy dostarczanie, o czym Bird dowiaduje się przez ten sam mechanizm preferencji, który zgłosił zatrzymanie. Zobacz Rezygnacje.
  • 132015 i 132016 to 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 samego języka, a nie szablonu, ponieważ wstrzymany język natychmiast blokuje wysyłkę.
  • Nadawca na niewłaściwym koncie WhatsApp Business Account zostaje odrzucony przed naliczeniem 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

  • Szablony WhatsApp: przeglądanie katalogu i wspólny kontrakt wysyłki przez szablon
  • Szablony marketingowe: Marketing Messages API, status onboardingu i gdzie marketing jest ograniczony
  • Rezygnacje: rejestrowanie i odczytywanie blokad oraz preferencji
  • Szablony utility: aktualizacje zamówień, przypomnienia o wizytach i powiadomienia o koncie