# WhatsApp-marketingtemplates Een marketingtemplate bevat promotionele inhoud, zoals een aanbieding, productaankondiging of coupon. Zorg vóór verzending voor goedgekeurde inhoud, toestemming van de ontvanger en een duidelijke manier om antwoorden en afmeldingen te verwerken. ## Voordat je verstuurt De beheerde catalogus van Bird bevat helemaal geen marketingtemplate, dus een marketingverzending gebruikt altijd een template die je werkruimte zelf heeft gemaakt, op een eigen WhatsApp Business Account: 1. Koppel een eigen WhatsApp Business Account en een eigen nummer. Zie [Telefoonnummer instellen](/docs/guides/whatsapp/phone-number-setup). 2. Maak een template met categorie `marketing` en dien deze in ter beoordeling. Zie [Templaterichtlijnen](/docs/knowledge-base/whatsapp/template-guidelines) voor wat wordt goedgekeurd. 3. Verstuur vanaf een nummer op hetzelfde WhatsApp Business Account als de template. `from` is verplicht bij een marketingverzending, en een afzender op een ander account wordt geweigerd `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch` voordat er iets in rekening wordt gebracht. ## Een marketingtemplate versturen `POST /v1/whatsapp/messages` met `from` ingesteld en een `template`-object met je eigen slug: **TypeScript** ```typescript const msg = await bird.whatsapp.send({ to: "+16505551234", from: "+13125550101", template: { slug: "summer_sale", language: "en", components: [ { type: "header", parameters: [{ type: "image", url: "https://cdn.example.com/banners/summer.png" }], }, { type: "body", parameters: [{ type: "text", name: "first_name", text: "Pablo" }] }, { type: "button", parameters: [{ type: "text", text: "SUMMER25" }] }, ], }, }); console.log(msg.id, msg.status); ``` Examples: [TypeScript](/nl-nl/documentatie/guides/whatsapp/templates/marketing.ts.md) · [Python](/nl-nl/documentatie/guides/whatsapp/templates/marketing.py.md) · [Go](/nl-nl/documentatie/guides/whatsapp/templates/marketing.go.md) · [PHP](/nl-nl/documentatie/guides/whatsapp/templates/marketing.php.md) · [CLI](/nl-nl/documentatie/guides/whatsapp/templates/marketing.cli.md) · [MCP](/nl-nl/documentatie/guides/whatsapp/templates/marketing.mcp.md) · [cURL](/nl-nl/documentatie/guides/whatsapp/templates/marketing.curl.md) - **Bodyparameters hebben een naam**, net als bij utility. Elke parameter heeft een `name`, en de volgorde in de array heeft geen betekenis. - **De code van een couponknop is een gewone `text`-parameter**, zoals die op de knop hierboven. Er is geen apart parametertype voor couponcodes. - **Een `gif`-header neemt een `gif`-parameter**, niet `video` of `image`. Marketing is de enige categorie die een geanimeerde-GIF-header accepteert. - **De waarden van een carrousel staan op `cards`, niet `parameters`**, en een verzending moet precies het aantal kaarten bevatten waarmee de template is goedgekeurd. Bird stuurt elke marketingverzending automatisch naar Meta's Marketing Messages API; je hoeft je niet aan te melden en er is geen schakelaar per verzending. De onboardingstatus van het zakelijke account bij die API bepaalt Meta's optimalisaties, niet de bezorging zelf, met één uitzondering: een `gif`-header vereist een onboarded account, anders mislukt de verzending bij WhatsApp. Zie [Marketingtemplates](/docs/knowledge-base/whatsapp/marketing-templates) voor de accountstatus, wat onboarding ontsluit en waar marketing per land beperkt is. ## Opt-outs Wanneer Bird een geldig marketing-stopevenement van Meta ontvangt, slaat het een ontvangersvoorkeur op voor dat zakelijke account. Deze voorkeur staat los van een onderdrukking van alle berichten. Controleer beide records voordat je verzendt. Een bezorgfout kan binnenkomen vóór het bijbehorende voorkeurevenement; bewaar de keuze van de ontvanger en onderzoek die geschiedenis in plaats van opnieuw te proberen. Zie [Afmeldingen](/docs/guides/whatsapp/opt-outs) voor het vastleggen en uitlezen van deze records. ## Kosten Gebruik het gepubliceerde marketingtarief voor de bestemming en valuta. Bird brengt de uitgaande kosten in rekening vóór verzending; een factureerbare bezorging of leesuitkomst kan Meta's kosten toevoegen. Zie [Kosten en facturering](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing) en [WhatsApp-tarieven](/products/whatsapp/pricing). ## Waar je op moet letten - **Meta hercategoriseert naar marketing, nooit eruit, en dat is een prijswijziging.** Een template die Meta inhoudelijk promotioneel vindt, wordt `marketing` ongeacht de categorie die je hebt ingediend, en de verzending gaat gewoon door tegen de nieuwe, hogere prijs. Je kunt dit niet weigeren en de categorie niet terugzetten; de oplossing is een nieuwe template. - **`131049` is een bezorgpauze, geen door jou ingestelde limiet, en opnieuw proberen maakt het erger.** Meta meldt `131049` zowel voor de algemene pauze in de VS als voor een marketinglimiet per gebruiker, en het eigen advies is om ongeveer een dag te wachten voordat je opnieuw verstuurt. Eerder opnieuw versturen kan het account langer onbereikbaar maken voor die ontvanger en vertekent je eigen bezorgpercentage. Bird meldt de fout als `rate_limited`. - **`131050` betekent dat de ontvanger "Offers and announcements" heeft uitgeschakeld, en dit mag nooit opnieuw worden geprobeerd.** Meta accepteert de verzending en weigert vervolgens deze te bezorgen. De juiste reactie is het pad voor berichtvoorkeuren, niet opnieuw versturen: onderdruk de ontvanger zelf, of wacht tot deze bezorging weer inschakelt, wat Bird te weten komt via hetzelfde voorkeursmechanisme dat de stop heeft gemeld. Zie [Opt-outs](/docs/guides/whatsapp/opt-outs). - **`132015` en `132016` zijn templatepauzering, geen ontvangersprobleem.** `132015` is een pauze vanwege lage kwaliteit; `132016` is 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 onmiddellijk met verzenden. - **Een afzender op het verkeerde WhatsApp Business Account wordt geweigerd voordat er iets in rekening wordt gebracht.** `from` moet op hetzelfde account staan als de template, anders mislukt de verzending `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch`. ## Volgende stappen - [WhatsApp-templates](/docs/guides/whatsapp/templates): door de catalogus bladeren en het gedeelde send-by-template-contract - [Marketingtemplates](/docs/knowledge-base/whatsapp/marketing-templates): de Marketing Messages API, onboardingstatus en waar marketing beperkt is - [Opt-outs](/docs/guides/whatsapp/opt-outs): suppressies en voorkeuren vastleggen en uitlezen - [Utilitytemplates](/docs/guides/whatsapp/templates/utility): orderupdates, afspraakherinneringen en accountmeldingen ## Related resources - [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video) - [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer) - [WhatsApp message builder](/tools/whatsapp-message-builder) (tool) - [WhatsApp](/products/whatsapp) (product) [Get an implementation brief](/learn/workspace?topic=whatsapp)