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);msg = client.whatsapp.send(
to="+16505551234",
template="bird_order_confirmation",
language="en",
parameters={"ref": "A1B2C3D4", "amount": "USD 49.99"},
)
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",
Template: "bird_order_confirmation",
Language: "en",
Parameters: map[string]any{"ref": "A1B2C3D4", "amount": "USD 49.99"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+16505551234',
template: 'bird_order_confirmation',
language: 'en',
parameters: ['ref' => 'A1B2C3D4', 'amount' => 'USD 49.99'],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--language en \
--parameters '{"amount":"USD 49.99","ref":"A1B2C3D4"}' \
--template bird_order_confirmation \
--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",
"template": {
"slug": "bird_order_confirmation",
"language": "en",
"parameters": {
"ref": "A1B2C3D4",
"amount": "USD 49.99"
}
}
}'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:
{ "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
giflub przyciskcopy_codejest 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
componentsnie 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 wcomponents, wiadomość zostanie przyjęta i obciążona opłatą, a następnie odrzucona przez Meta. Wysyłkaparametersbez 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.
frommusi znajdować się na tym samym koncie co szablon; w przeciwnym razie wysyłka kończy się błędem422E15023WhatsAppSenderWABAMismatch.
Następne kroki
- Szablony WhatsApp: przeglądanie katalogu i wspólne zasady wysyłki z użyciem szablonu
- Szablony uwierzytelniające: jednorazowe kody weryfikacyjne i wymóg weryfikacji przy tworzeniu własnego szablonu
- Szablony marketingowe: wysyłki promocyjne i konto potrzebne do utworzenia własnego szablonu
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.