Marketingtemplates voor WhatsApp
Een marketingtemplate bevat promotionele inhoud, zoals een aanbieding, een productaankondiging of een kortingsbon. Zorg vóór het versturen voor goedgekeurde inhoud, toestemming van de ontvanger en een duidelijke manier om antwoorden en afmeldingen af te handelen.
WhatsApp Studio verstuurt naar één ontvanger tegelijk. Met een broadcast verstuur je een marketingtemplate vanuit het dashboard naar een volledige doelgroep. Zie WhatsApp Studio en marketingcampagnes voor het plannen van een campagne.
Voordat je verstuurt
De beheerde catalogus van Bird bevat helemaal geen marketingtemplates. Voor een marketingbericht gebruik je dus altijd een template die je werkruimte zelf heeft opgesteld, op een eigen WhatsApp Business Account:
- Koppel een WhatsApp Business Account en een eigen nummer. Zie Telefoonnummer instellen.
- Stel een marketingtemplate op en dien die in ter beoordeling. Zie Richtlijnen voor templates voor wat wordt goedgekeurd.
- Verstuur vanaf een nummer op hetzelfde WhatsApp Business Account als de template.
fromis verplicht bij een marketingbericht, en een afzender op een ander account wordt geweigerd422E15023WhatsAppSenderWABAMismatchvoordat er iets in rekening wordt gebracht.
Een marketingtemplate versturen
POST /v1/whatsapp/messages met from ingesteld en een template-object dat je eigen slug noemt:
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"
}
}
}'- Body-variabelen hebben een naam, net als bij utility, dus
first_nameis een eigen sleutel. - De code van een couponknop zet je in
code, zoals in het voorbeeld hierboven. Er is geen aparte couponsleutel. - Een mediaheader gebruikt
header_url, of het nu een afbeelding, een video of eengifis. Laat je die weg, dan wordt het goedgekeurde voorbeeld van de template verzonden. Een template die uit Meta is geïmporteerd heeft geen voorbeeld, dus die heeftheader_urlnodig. Marketing is de enige categorie die een header met een geanimeerde GIF accepteert. - De media en het genummerde url-achtervoegsel van een carrouselkaart gebruiken genummerde sleutels:
header_url_1enbutton_url_1voor de eerste kaart,header_url_2voor de tweede, enzovoort. Geef de variabelen in de kaarten een naam. Een naam die in twee kaarten voorkomt is één sleutel, dus beide kaarten krijgen dezelfde waarde. Een carrousel waarvan elke kaart een{{1}}nummert, gebruikt alleencomponents, met de waarden incards. Zo'n verzending moet precies het aantal kaarten leveren waarmee de template is goedgekeurd.
Bird stuurt elke marketingverzending automatisch via Meta's Marketing Messages API. Je hoeft je niet aan te melden en er is geen schakelaar per verzending. De onboardingstatus van het business account bij die API bepaalt of Meta's optimalisaties beschikbaar zijn, niet of er bezorgd wordt. Een uitzondering zijn gif-headers: daarvoor is een onboarded account nodig. Zie Marketingtemplates voor de accountstatus, wat onboarding mogelijk maakt en in welke landen marketing beperkt is.
Afmeldingen
Als Bird een geldige marketingstopgebeurtenis van Meta ontvangt, legt het een voorkeur van de ontvanger vast voor dat business account. Deze voorkeur staat los van een suppressie voor alle berichten. Controleer beide records voordat je verzendt. Een bezorgfout kan binnenkomen vóór de bijbehorende voorkeursgebeurtenis. Respecteer dan de keuze van de ontvanger en onderzoek die geschiedenis in plaats van opnieuw te proberen. Zie Voorkeuren voor het vastleggen en uitlezen van deze records.
Kosten
Gebruik het gepubliceerde marketingtarief voor de bestemming en valuta, of stel een maximumprijs in voor variabele bezorgkosten van Meta tot je limiet. Bird rekent zijn uitgaande vergoeding vóór het indienen. Een factureerbare bezorging of leesbevestiging kan Meta's vergoeding daaraan toevoegen. Zie Kosten en facturering en Prijzen van WhatsApp.
Aandachtspunten
- Meta's categorie bepaalt de prijs. Meta kan promotionele inhoud na goedkeuring alsnog als marketing classificeren. Controleer vóór het verzenden de huidige categorie van elke taal. Een verzending met maximumprijs vereist de categorie marketing. Ben je het niet eens met de classificatie, zie dan Meta's beoordelingsproces voor categorieën.
131049is een bezorgpauze, geen limiet die je zelf hebt ingesteld, en opnieuw proberen maakt het erger. Meta meldt131049zowel bij de algemene pauze in de VS als bij een marketinglimiet per gebruiker. Meta's eigen advies is ongeveer een dag te wachten voordat je opnieuw verzendt. Verzend je eerder, dan kan het account langer onbereikbaar blijven voor die ontvanger en raakt je eigen bezorgpercentage vertekend. Bird meldt de fout alsrate_limited.131050betekent dat de ontvanger "Offers and announcements" heeft uitgezet, en je mag het nooit opnieuw proberen. Meta accepteert de verzending en weigert daarna de bezorging. De juiste reactie loopt via de berichtvoorkeuren, niet via een nieuwe verzending: onderdruk de ontvanger zelf, of wacht tot de ontvanger de bezorging weer inschakelt. Bird hoort dat via hetzelfde voorkeursmechanisme dat de stop meldde. Zie Preferences.132015en132016betekenen dat de template is gepauzeerd, niet dat er een probleem met de ontvanger is.132015is een pauze vanwege lage kwaliteit.132016is een permanente uitschakeling na herhaalde pauzes, en de enige oplossing is een nieuwe template met andere inhoud. Controleer de status van de taal zelf in plaats van die van de template, want een gepauzeerde taal stopt direct met verzenden.- Een afzender op het verkeerde WhatsApp Business Account wordt geweigerd voordat er kosten worden gerekend.
frommoet op hetzelfde account staan als de template, anders mislukt de verzending422E15023WhatsAppSenderWABAMismatch.
Volgende stappen
- WhatsApp-templates: de catalogus doorzoeken en het gedeelde contract voor verzenden met een template
- Marketingtemplates: de Marketing Messages API, de onboardingstatus en waar marketing beperkt is
- Voorkeuren: verklaringen van ontvangers vastleggen en uitlezen
- Utilitytemplates: orderupdates, afspraakherinneringen en accountmeldingen
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.