Een orderbevestiging kan dezelfde bewoordingen hergebruiken en alleen het ordernummer per ontvanger wijzigen. Dat houdt de workflow consistent terwijl de gegevens veranderen.
Wat bevat een template?
Een template bevat vaste tekst, variabeledefinities en de berichtcategorie, die aangeeft waarom je het bericht verstuurt. Een bestemming kan die contentclassificatie toepassen op haar registratieregels.
Elke variabele benoemt een waarde die per verzending verandert, zoals een ordernummer. Het template definieert het geaccepteerde type, of de waarde verplicht is en eventuele beperkingen op de waarde.
Campagne-inhoud en templates combineren herbruikbare tekst met ontvangerspecifieke waarden. De templatecatalogus van Bird bevat systeemtemplates voor authenticatie- en transactionele berichten. Met werkruimtetemplates kun je eigen tekst in meerdere talen publiceren. Je maakt ze via de API voor templatebeheer.
Lees de variabelen voordat je een template kiest. Een herkenbaar ogende preview garandeert niet dat de vereiste waarden overeenkomen met de gegevens die je applicatie heeft.
Moeten SMS-templates goedgekeurd worden?
Ingebouwde templates zijn klaar voor verzending. Publicatie van een werkruimtetemplate valideert de tekst en variabelen. De gepubliceerde versie is direct beschikbaar, zonder goedkeuring van Meta. Bestemmingsregels kunnen nog steeds inhoudsregistratie vereisen.
Dit zijn afzonderlijke processen. Een herbruikbare berichtbody van een provider betekent op zichzelf geen naleving van de regels van een bestemming.
Bijvoorbeeld, de richtlijn van TRAI voor afzenders vereist registratie van contenttemplates voor communicatie via geregistreerde afzenderidentiteiten in India. Die vereiste heeft betrekking op de berichtstructuur, inclusief vaste en variabele delen.
Controleer de bestemming voordat je de verzendworkflow kiest. Afzenderregistratie heeft betrekking op de afzenderidentiteit en kan naast een contentvereiste bestaan.
Hoe kiest Bird de categorie en afzender?
De template levert de categorie: de inhoudsclassificatie die aangeeft waarom je het bericht verstuurt. Ingebouwde templates kiezen een afzender voor de bestemming; werkruimtetemplates gebruiken de afzender die je opgeeft.
Een templateverzending weigert text, category en media_urls naast template. Laat from weg voor een ingebouwde template en geef het op voor een werkruimtetemplate. Het contract voor templateverzending beschrijft deze vereisten.
Gebruik een werkruimtetemplate of vrije tekst wanneer je toepassing een specifieke afzender moet kiezen.
Controleer from en category in het antwoord. Die velden vertellen je welke afzender en contentclassificatie Bird voor dat bericht heeft geselecteerd.
Hoe verstuur ik een template in Bird?
Geef een gepubliceerde template op en lever de variabelewaarden aan in het template-object van de verzending.
Gebruik slug of id om deze te identificeren. Haal GET /v1/sms/templates/{template_ref} op voor de live_version_id en daarna GET /v1/sms/templates/{template_ref}/versions/{version_id} voor de inhoud en variabeledefinities.
Zet waarden in parameters, met de variabelenaam als sleutel. Ontbrekende verplichte waarden, niet-gedeclareerde sleutels of ongeldige formaten geven 422 terug, dus valideer de waarden voordat je de verzending vrijgeeft.
Het geserialiseerde parameterobject mag maximaal 16 KB zijn. Bird weigert een verzoek dat die limiet overschrijdt, dus beperk je tot de gedeclareerde waarden van het template.
Kies language wanneer nodig. De taalinstellingen van het template bepalen de standaard en eventuele fallback, dus controleer die instellingen in plaats van aan te nemen dat elke gevraagde taal bestaat.
Veranderen templates de facturering van SMS?
De gerenderde tekst wordt geteld als elke andere SMS-body.
Vul de werkelijke waarden in voordat je segmenten schat. Een lange orderreferentie of een naam buiten het compacte alfabet kan het aantal verhogen.
Een templateverwijzing is geen vaste prijs per ontvanger. De segments.count in het antwoord rapporteert de factureerbare delen voor dat gerenderde bericht.
Wanneer kies ik een template?
Kies een catalogustemplate als de body, variabelen en afzenderselectie passen bij je workflow.
- Gebruik een template als de aangeboden body overeenkomt met het bericht en je de vereiste waarden hebt.
- Publiceer een werkruimtetemplate voor herbruikbare tekst met je eigen afzender, of gebruik vrije tekst voor een afzonderlijk bericht.
- Pas de registratievereisten van de bestemming toe op beide opties.
Kort gezegd
Templates bevatten herbruikbare tekst en variabeledefinities.
Kies een ingebouwde template of gebruik een gepubliceerde werkruimtetemplate en geef de vereiste waarden op.
De keuze van de afzender hangt af van het bereik van de template.
Ingebouwde templates gebruiken een afzender die Bird selecteert. Werkruimtetemplates vereisen een afzender die van jou is. De template levert de categorie.
Publicatie in de werkruimte vereist geen beoordeling door Meta.
Het publiceren van een werkruimtetemplate valideert het concept. De gepubliceerde versie is direct beschikbaar voor verzending. Bestemmingsregels voor inhoudsregistratie blijven afzonderlijk gelden.
Ingevulde waarden beïnvloeden nog steeds het aantal segmenten.
Controleer het gerenderde bericht, want langere waarden kunnen het aantal factureerbare segmenten verhogen.