Authenticatietemplates voor WhatsApp
Een authenticatietemplate levert een eenmalige verificatiecode af. Meta levert de tekst wanneer je de template opstelt. Bij het versturen geef je de code mee als bodyparameter.
Voordat je verstuurt
Kies of je een template gebruikt die door Bird wordt beheerd, of zelf een template opstelt op je eigen bedrijfsaccount.
Voor het versturen van de standaard catalogustemplates van Bird, bird_otp en bird_otp_authifly, heb je zelf geen verificatie nodig. Die templates staan op de eigen WhatsApp Business Accounts van Bird, en het beheerde verzendpad controleert nooit de verificatiestatus van je bedrijf.
Wanneer het gekoppelde bedrijfsaccount not_verified meldt, weigert Bird het aanmaken of dupliceren van authenticatietemplates met 412 E15043 WhatsAppTemplateBusinessNotVerified. Controleer het gekoppelde account en de laatst gesynchroniseerde status. Zie WhatsApp business verification voor het verificatieproces en de afhandeling van statussen.
Deze vereiste geldt niet voor het opstellen van utility- en marketingtemplates. Die kun je blijven aanmaken en bewerken, ongeacht je verificatiestatus.
Stel templates op in het dashboard, met de bird CLI of via de MCP-server. Zie Authenticatietemplates opstellen voor de volledige werkwijze.
Een verificatiecode versturen
POST /v1/whatsapp/messages met een template-object dat een catalogusslug noemt:
const msg = await bird.whatsapp.send({
to: "+14155550100",
template: {
slug: "bird_otp",
language: "en",
parameters: { code: "481920" },
},
});
console.log(msg.id, msg.status);msg = client.whatsapp.send(
to="+14155550100",
template="bird_otp",
language="en",
parameters={"code": "481920"},
)
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: "+14155550100",
Template: "bird_otp",
Language: "en",
Parameters: map[string]any{"code": "481920"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(msg.Id, *msg.Status)
}$message = $bird->whatsapp->send(
to: '+14155550100',
template: 'bird_otp',
language: 'en',
parameters: ['code' => '481920'],
);
echo $message->getId(), ' ', $message->getStatus();bird whatsapp send \
--language en \
--parameters '{"code":"481920"}' \
--template bird_otp \
--to +14155550100curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
-H "Authorization: Bearer $BIRD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+14155550100",
"template": {
"slug": "bird_otp",
"language": "en",
"parameters": {
"code": "481920"
}
}
}'Voor deze categorie gelden vier specifieke regels:
- Laat
fromweg. Een door Bird beheerde template kiest zelf de afzender op basis van categorie en regio, dus als jefrominstelt, krijg je422E15018WhatsAppSenderNotAllowedterug. Dat is het omgekeerde van een vrij bericht, datfromwel vereist. Let hierop als je vanaf de pagina's over interactieve berichten komt. tomoet een E.164-telefoonnummer zijn. Je kunt een authenticatietemplate niet naar een bedrijfsgebonden gebruikers-ID sturen; dat levert422E15014WhatsAppRecipientNotSupportedForTemplateop.- De code komt in
parameters.code. Die vult de placeholder in de body en de knop om de code te kopiëren. Een verzending metcomponentsverwacht in plaats daarvan precies één positionele bodyparameter: de code. Geef je geen parameter of geef je de parameter een naam, dan krijg je422E15003WhatsAppTemplateParameterMismatchterug. - Je hebt geen klantenservicevenster nodig. Templateverzendingen zijn niet aan het venster gebonden. Daarom bestaat een verificatiecodetemplate: die moet iemand bereiken die je nog nooit een bericht heeft gestuurd.
Lees de beschikbare talen voor bird_otp of bird_otp_authifly uit de templatecatalogus. Is de gevraagde taal niet beschikbaar, dan mislukt de verzending en wordt er geen andere taal gebruikt.
De knop om de code te kopiëren
Meta schrijft de body van een authenticatietemplate zelf, als vaste tekst met één placeholder voor de code. Je geeft dus vlaggen op in plaats van tekst. Bij een verzending met parameters wordt de knop gevuld vanuit code. Bij een verzending met components is de knopcomponent optioneel: neem je er geen op, dan voegt Bird die voor je toe, met dezelfde code als in de body. Je kunt de knop ook zelf opgeven:
{ "type": "button", "parameters": [{ "type": "text", "text": "481920" }] }In beide gevallen bereikt precies één knop WhatsApp, namelijk de knop om de code te kopiëren: als je erop tikt, wordt de code naar het klembord gekopieerd. Bird ondersteunt alleen copy_code. De twee andere knopvarianten die Meta voor authenticatietemplates beschrijft, automatisch invullen met één tik en zonder tik, zijn niet beschikbaar op Bird.
De knop van een template maak je op dezelfde manier: één otp-knop, en de template accepteert geen ander knoptype. In plaats van tekst te schrijven geef je add_security_recommendation op (een boolean die in de body wordt getoond) en code_expiration_minutes (1 tot 90, getoond in de footer).
Wat Meta toestaat in een authenticatietemplate
Meta legt de structuur van een authenticatietemplate vast en beoordeelt de inhoud: nergens in de template mogen URL's, media of emoji's staan, en de codeparameter mag maximaal 15 tekens bevatten. De categorie verandert ook hoe WhatsApp het bericht aflevert: alleen op het primaire apparaat van de ontvanger. Zie Template guidelines voor de volledige vaste structuur, tekenlimieten en beoordelingsprocedure.
Kosten
De categorie en de bestemming bepalen de prijs. Zie WhatsApp authentication-international rates voor hoe verzenden naar een ander land dan je primaire locatie de prijs kan veranderen, en Kosten en facturering voor wanneer een verzending in rekening wordt gebracht. De tarieven staan op WhatsApp prijzen.
Aandachtspunten
- De standaardtemplates van Bird worden niet afgeleverd in negen landen.
bird_otpenbird_otp_authiflyworden verzonden vanaf de eigen WhatsApp Business Accounts van Bird, en die accounts leveren geen authenticatieberichten af in Egypte, India, Indonesië, Maleisië, Nigeria, Pakistan, Saoedi-Arabië, Zuid-Afrika en de Verenigde Arabische Emiraten. Zo'n verzending wordt geweigerd met422E15063WhatsAppDestinationRestrictedvoordat er iets in rekening wordt gebracht. Een template die je op je eigen account hebt gemaakt en vanaf je eigen nummer verzendt, bereikt deze landen gewoon. Ook Verify bereikt ze, door de verificatiecode zelf via een ander kanaal te versturen. - Een verzending met een eigen template vereist
from, en die moet op hetzelfde WhatsApp Business Account staan als de template. Een afzender op een ander account wordt geweigerd met422E15023WhatsAppSenderWABAMismatchvoordat er iets in rekening wordt gebracht. - Je kunt alleen een taal verzenden waarvan de versie is goedgekeurd en actief is. Een taal in concept, in behandeling, afgewezen of gepauzeerd kun je niet verzenden.
- Meta kan een template op eigen initiatief in een andere categorie plaatsen. Je kunt je daar niet voor afmelden, en daarmee veranderen de prijs- en afleverregels die bij de categorie horen.
- De categorie van de template en de categorie van een taal kunnen verschillen. Zie WhatsApp templates voor hoe het verzendproces dit oplost.
- Een geïmporteerde authenticatietemplate kun je niet dupliceren. Bird kan de door WhatsApp gegenereerde tekst niet terugvertalen naar de instellingen waarmee een nieuwe template wordt gemaakt; dat geeft
422E15024WhatsAppTemplateContentNotDuplicable. Maak in plaats daarvan een nieuwe template met een eigen beveiligingsaanbeveling en vervaltijd voor de code.
Volgende stappen
- WhatsApp templates: de catalogus doorzoeken en het gedeelde contract voor verzenden met een template
- Utility-templates: orderupdates, afspraakherinneringen en accountmeldingen
- Bedrijfsverificatie voor WhatsApp: hoe verificatie werkt en wat je er nog meer mee vrijspeelt
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.