Utility-templates voor WhatsApp
Een utility-template volgt op iets wat de ontvanger al heeft gedaan: een bestelling, een betaling, een boeking of een aanmelding. De catalogus van Bird bevat er acht, waaronder bird_signin_alert en bird_delivery_update. Haal de categorie van een slug uit de templatelijst en niet uit de naam: bird_signin_alert klinkt als een authenticatietemplate, maar is een utility-template.
Voordat je verstuurt
Kies een beheerde catalogustemplate of maak een utility-template op je gekoppelde zakelijke account.
Voor het versturen van de catalogustemplates van Bird heb je geen eigen verificatie nodig, net als bij authenticatie. Ook voor het maken van een eigen utility-template is geen verificatie nodig: anders dan bij authenticatie geldt de bedrijfsverificatie van Meta nooit voor utility. Je kunt dus utility-templates maken en bewerken in een niet-geverifieerde werkruimte. Zie Bedrijfsverificatie voor WhatsApp voor wat verificatie elders mogelijk maakt.
to kan een E.164-telefoonnummer zijn of een gebruikers-ID die aan het bedrijf gekoppeld is. Een utility-template heeft geen OTP-knop, dus de ontvanger hoeft geen telefoonnummer te zijn, zoals bij authenticatie wel verplicht is.
Elke beheerde utility-template uit de catalogus is alleen geregistreerd in het en, met on_missing_language: fail. Als je een taal aanvraagt die de catalogus niet bevat, mislukt het versturen. Er wordt niet teruggevallen op Engels of een andere taal.
Een utility-template versturen
POST /v1/whatsapp/messages met een template-object dat een catalogusslug noemt:
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"
}
}
}'Laat from weg, net als bij elke beheerde template: Bird kiest het verzendnummer op basis van de categorie en de regio. Als je het toch instelt, krijg je 422 E15018 WhatsAppSenderNotAllowed terug. Een eigen utility-template maken en versturen werkt hetzelfde als elke andere verzending met een eigen template. Zie Versturen met een template voor de algemene afspraken.
De variabelen invullen
Utility-variabelen hebben een naam, dus elke variabele is een eigen sleutel in parameters, zoals ref en amount. Een URL-knop met een genummerd achtervoegsel {{1}} gebruikt in plaats daarvan de sleutel button_url. Een benoemd achtervoegsel gebruikt zijn eigen naam. De verzending bevat alleen de waarde, niet een volledig adres:
{ "parameters": { "ref": "A1B2C3D4", "button_url": "A-4192" } }Een components-verzending noemt in plaats daarvan elke bodyparameter, en de volgorde van een benoemde parameter in de array heeft geen betekenis. Zie Verzenden met een template en Componenten en parameters voor de gedeelde regels over componenten, sub_type en hoe de components van een verzending aansluiten op de gedeclareerde placeholders van een template.
Kosten
Voor een utility-template dat binnen een open klantenservicevenster wordt afgeleverd, geldt tot en met 30 september 2026 het gratis tarief van Meta. Vanaf 1 oktober 2026 rekent Meta hiervoor kosten zoals voor elk ander utility-template (prijswijzigingen oktober 2026). De uitgaande vergoeding van Bird wordt tijdens de verwerking van het bericht in rekening gebracht, vóór de indiening. Een latere callback voor afgeleverd of gelezen bepaalt of er een vergoeding van Meta geldt. Houd rekening met beide onderdelen als je het totaal inschat.
Zie Kosten en facturering voor wanneer een verzending in rekening wordt gebracht, en Prijzen van WhatsApp voor de tarieven.
Aandachtspunten
- Meta kan een utility-template op eigen initiatief herclassificeren als marketing, en het bericht wordt dan verzonden tegen de nieuwe, hogere prijs. Een bedrijf dat Meta al heeft gewaarschuwd voor een verkeerde categorie, krijgt sinds april 2025 helemaal geen voorafgaande melding meer; de wijziging gaat direct in. Houd promotionele taal, aanbiedingen en upsells uit de tekst van een utility-template, want die leiden tot de herclassificatie. Zie Templaterichtlijnen voor wat als promotioneel geldt.
- Een
gif-header of eencopy_code-knop wordt buiten marketing geweigerd. Beide zijn componenten die alleen voor marketing bestaan; als je een van beide op een utility-template declareert, mislukt dat. - Bij een eigen
components-verzending wordt het aantal parameters niet gecontroleerd voordat er kosten worden gerekend. Verstuur je het verkeerde aantal parameters incomponentsbij een eigen template, dan wordt het bericht geaccepteerd en in rekening gebracht, en daarna door Meta geweigerd. Eenparameters-verzending waarin een verplichte sleutel ontbreekt, wordt geweigerd voordat er kosten worden gerekend. Verzendingen met beheerde catalogustemplates hebben dit probleem niet. - Een afzender op het verkeerde WhatsApp Business Account wordt geweigerd voordat er kosten worden gerekend.
frommoet op hetzelfde account staan als het template; anders mislukt de verzending met422E15023WhatsAppSenderWABAMismatch.
Volgende stappen
- WhatsApp-templates: de catalogus doorzoeken en het gedeelde contract voor verzenden met een template
- Authenticatietemplates: eenmalige verificatiecodes en de verificatiedrempel voor het opstellen van zo'n template
- Marketingtemplates: promotionele berichten en het account dat je nodig hebt om er zelf een op te stellen
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.