WhatsApp

Wat is een WhatsApp-berichttemplate?

Een WhatsApp-berichttemplate is herbruikbare content die Meta goedkeurt voordat je deze met de variabele waarden van de ontvanger verstuurt.

Een orderupdate vereist vaste bewoordingen en gegevens die specifiek zijn voor de aankoop. Een template houdt de goedgekeurde bewoordingen gescheiden van waarden zoals het ordernummer.

Wanneer heb ik een template nodig?

Gebruik een goedgekeurde template als je buiten het 24-uurs servicevenster van de klant verstuurt.

Binnen een open venster kun je antwoorden met vrije content. Het versturen van een template heropent dat venster niet; het antwoord van de klant doet dat wel.

Goedkeuring vervangt geen toestemming van de klant. Volg Meta's berichtenbeleid voor het bericht dat je wilt versturen.

Wat bevat een template in Bird?

Een template identificeert herbruikbare content, terwijl de versies de bewoordingen per taal bevatten.

Gebruik de slug bij het versturen. De weergavenaam labelt de template, maar is niet de handle die gebruikt wordt om een verzending op te lossen.

Kies authentication, marketing of utility bij het aanmaken van de template. Bird houdt de opgegeven categorie en de slug vast na aanmaak.

De content van een taal bevat een verplicht body-blok. Daarnaast kan het een header, footer, buttons of carousel bevatten, afhankelijk van de contentregels van de template.

Om de goedgekeurde content te bekijken, lees je live_version_id uit de template. Haal vervolgens de taal van die versie op via het taalopdracht.

Een template zonder live versie kan niet verzenden. Het concept kan nog content bevatten die niet door de beoordeling is gekomen.

Welke taal en categorie gebruikt een verzending?

Controleer available_languages voor verzendbare talen. Controleer de eigen category van de taal voor de prijsclassificatie van Meta.

De status van de template vat de talen samen. Een active-template heeft minstens één verzendbare taal. Een andere taal kan afgewezen, gepauzeerd of uitgeschakeld zijn.

Meta kan de goedkeuring of beschikbaarheid van een taal na lancering intrekken. Controleer de taalstatus bij het verzenden in plaats van een vaste lijst uit de deployment te gebruiken.

Meta kan een taal ook herclassificeren zonder de categorie die je hebt opgegeven te wijzigen. Gebruik de classificatie van die taal samen met de gepubliceerde WhatsApp-tarieven bij het inschatten van kosten.

Gebruik voorbeelden om de categorie te controleren voordat je een taal indient:

VoorbeeldcontentLes over de beoogde categorie
Your order {{reference}} has shipped.Een specifieke transactie-update is het utility-patroon
Your code is {{code}}.Een authenticatiebericht gebruikt de authentication-categorie en de bijbehorende schrijfregels
Get 20% off your next order.Een promotioneel aanbod hoort in het marketingpad

Houd de voorbeelden illustratief. Meta beoordeelt de ingediende taal en kan deze anders classificeren dan de categorie die je hebt gekozen.

Stel on_missing_language in om te bepalen wat er gebeurt als de gevraagde taal geen beschikbare kopie heeft. Bird stelt nieuwe WhatsApp-templates standaard in op fail. Elke taal wordt apart goedgekeurd en geprijsd, dus een stille vervanging kan onverwachte content tegen een onbedoeld tarief versturen.

Dat beleid staat nog steeds een bredere tag toe: pt kan een verzoek voor pt-BR bedienen. Het vervangt niet de verwante variant pt-PT.

Kies fallback alleen als het vervangen door de geconfigureerde standaardtaal acceptabel is voor je ontvangers. Door Bird beheerde templates behouden hun vaste beleid voor ontbrekende talen.

Hoe wijzig ik ingediende content?

Maak een nieuw concept aan. Schrijf de gecorrigeerde taal. Dien die versie in voor beoordeling.

Bird houdt ingediende versies onveranderlijk, dus het bewerken van het label van de template wijzigt geen goedgekeurde berichtcontent.

VeldWat het je vertelt
draft_version_idEr bestaat een niet-ingediend concept
pending_version_idEen ingediende versie heeft nog onopgeloste talen
live_version_idDeze versie levert de content die voor verzendingen wordt gebruikt

Goedkeuring van één taal kan de hele versie live maken. Andere talen op die versie kunnen nog in afwachting zijn of afgewezen.

Controleer de taal van de ingediende versie om een beoordeling te volgen. De template kan nog een eerdere live versie tonen terwijl een vervanging op goedkeuring wacht.

Hoe verstuur ik een template?

Geef de template op. Lever de variabelen aan die de taal vereist die je wilt versturen.

Vind de beschikbare templates met:

bird whatsapp templates list

Gebruik bird whatsapp templates get om de geselecteerde template te bekijken. Haal de taalcontent op voordat je de components van de verzending samenstelt, die de waarden voor de variabelen van die template bevatten.

In het dashboard levert het templatedetail een cURL-voorbeeld met de voorbeeldwaarden van die template. Vervang de ontvanger, credentials en variabelen door je beoogde waarden voordat je verstuurt.

Een opgestelde template vereist een afzender op hetzelfde WhatsApp Business Account. Volg de verzendprocedure. Volg de teruggegeven berichtidentifier via bezorgingsgebeurtenissen.

Een 202-antwoord accepteert het verzoek voor verwerking. Bevestig de bezorging aan de hand van het latere resultaat voordat je het bericht als ontvangen beschouwt.

Kort gezegd

  1. Controleer de taal voordat je verstuurt.

    Een actieve template kan niet-beschikbare talen bevatten. Gebruik available_languages om te controleren of de taal van de ontvanger verzonden kan worden.

  2. Lees de categorie van de taal.

    Meta kan een taal anders classificeren dan de categorie die je hebt opgegeven. De prijs volgt de classificatie van Meta.

  3. Bewerk via een nieuw concept.

    Bird bevriest ingediende versies. Maak een nieuw concept aan om content te wijzigen. Dien de gecorrigeerde taal in voor beoordeling.

  4. Verstuur de goedgekeurde content met de variabelen.

    Geef de template op en lever de waarden aan die de taal verwacht. Een geaccepteerd verzoek garandeert geen bezorging.

Bouw op hetzelfde netwerk.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra u een betaalmethode toevoegt en een afzender verifieert.

Jouw volgende idee.
Klaar om te verbinden.