Sign inGet Started

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:

  1. Koppel een WhatsApp Business Account en een eigen nummer. Zie Telefoonnummer instellen.
  2. Stel een marketingtemplate op en dien die in ter beoordeling. Zie Richtlijnen voor templates voor wat wordt goedgekeurd.
  3. Verstuur vanaf een nummer op hetzelfde WhatsApp Business Account als de template. from is verplicht bij een marketingbericht, en een afzender op een ander account wordt geweigerd 422 E15023 WhatsAppSenderWABAMismatch voordat 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);
  • Body-variabelen hebben een naam, net als bij utility, dus first_name is 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 een gif is. 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 heeft header_url nodig. 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_1 en button_url_1 voor de eerste kaart, header_url_2 voor 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 alleen components, met de waarden in cards. 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.
  • 131049 is een bezorgpauze, geen limiet die je zelf hebt ingesteld, en opnieuw proberen maakt het erger. Meta meldt 131049 zowel 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 als rate_limited.
  • 131050 betekent 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.
  • 132015 en 132016 betekenen dat de template is gepauzeerd, niet dat er een probleem met de ontvanger is. 132015 is een pauze vanwege lage kwaliteit. 132016 is 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. from moet op hetzelfde account staan als de template, anders mislukt de verzending 422 E15023 WhatsAppSenderWABAMismatch.

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