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:
- Połącz konto WhatsApp Business Account i własny numer. Zobacz Konfiguracja numeru telefonu.
- Utwórz szablon marketingowy i prześlij go do weryfikacji. Informacje o tym, co zostanie zatwierdzone, znajdziesz w artykule Wytyczne dotyczące szablonów.
- Wysyłaj z numeru na tym samym koncie WhatsApp Business Account co szablon. Przy wysyłce marketingowej
fromjest wymagane, a nadawca z innego konta zostaje odrzucony422E15023WhatsAppSenderWABAMismatch, 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);msg = client.whatsapp.send(
to="+16505551234",
from_="+13125550101",
template="summer_sale",
language="en",
parameters={
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25",
},
)
print(msg.id, msg.status)package main
import (
"context"
"fmt"
"log"
"os"
bird "github.com/messagebird/bird-sdk-go"
"github.com/messagebird/bird-sdk-go/option"
)
func main() {
client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
if err != nil {
log.Fatal(err)
}
msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
To: "+16505551234",
From: "+13125550101",
Template: "summer_sale",
Language: "en",
Parameters: map[string]any{
"header_url": "https://cdn.example.com/banners/summer.png",
"first_name": "Pablo",
"code": "SUMMER25",
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+16505551234',
from: '+13125550101',
template: 'summer_sale',
language: 'en',
parameters: [
'header_url' => 'https://cdn.example.com/banners/summer.png',
'first_name' => 'Pablo',
'code' => 'SUMMER25',
],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--from +13125550101 \
--language en \
--parameters '{"code":"SUMMER25","first_name":"Pablo","header_url":"https://cdn.example.com/banners/summer.png"}' \
--template summer_sale \
--to +16505551234curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"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"
}
}
}'- Zmienne w treści mają nazwy, tak samo jak w szablonach użytkowych, więc
first_nameto 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 czygif. Pomiń go, aby wysłać zatwierdzoną próbkę szablonu. Szablon zaimportowany z Meta nie ma próbki, więc wymagaheader_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_1ibutton_url_1dla pierwszej karty,header_url_2dla 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 tylkocomponentsz wartościami wcards, 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.
131049oznacza wstrzymanie dostarczania, a nie skonfigurowany przez Ciebie limit, a ponowne próby pogarszają sytuację. Meta zgłasza131049zaró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 jakorate_limited.131050oznacza, ż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.132015i132016oznaczają wstrzymanie szablonu, a nie problem z odbiorcą.132015to wstrzymanie z powodu niskiej jakości;132016to 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.
frommusi należeć do tego samego konta co szablon, w przeciwnym razie wysyłka kończy się błędem422E15023WhatsAppSenderWABAMismatch.
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
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.