Eine Bestellbestätigung kann ihren Wortlaut wiederverwenden und dabei die Bestellnummer für jeden Empfänger ändern. So bleibt der Ablauf einheitlich, während sich die Daten ändern.
Was enthält ein Template?
Ein Template enthält festen Text, Variablendefinitionen und die Nachrichtenkategorie, die den Grund Ihres Versands klassifiziert. Ein Zielland kann diese Inhaltsklassifizierung auf seine Registrierungsregeln anwenden.
Jede Variable benennt einen Wert, der sich zwischen den Sendungen ändert, etwa eine Bestellnummer. Das Template definiert den akzeptierten Typ, ob der Wert erforderlich ist und eventuelle Einschränkungen.
Kampagneninhalte und -vorlagen verbinden wiederverwendbare Formulierungen mit empfängerspezifischen Werten. Der Vorlagenkatalog von Bird enthält Systemvorlagen für Authentifizierungs- und Transaktionsnachrichten. Mit Workspace-Vorlagen können Sie eigene Texte in mehreren Sprachen veröffentlichen. Die Erstellung erfolgt über die API zur Vorlagenverwaltung.
Lesen Sie die Variablen, bevor Sie ein Template wählen. Eine vertraut wirkende Vorschau belegt nicht, dass die erforderlichen Werte zu den Daten Ihrer Anwendung passen.
Müssen SMS-Templates genehmigt werden?
Integrierte Vorlagen sind sofort versandbereit. Beim Veröffentlichen einer Workspace-Vorlage werden Text und Variablen validiert. Die veröffentlichte Version ist sofort verfügbar, ohne Genehmigung durch Meta. Zielabhängige Regeln können weiterhin eine Inhaltsregistrierung erfordern.
Das sind getrennte Prozesse. Der wiederverwendbare Nachrichtentext eines Anbieters stellt allein keine Konformität mit den Regeln eines Ziellandes her.
Beispielsweise verlangt die TRAI-Richtlinie für Absender, die indische Telekommunikationsregulierungsbehörde, die Registrierung von Inhalts-Templates für Nachrichten über registrierte Absenderidentitäten in Indien. Diese Anforderung betrifft die Nachrichtenstruktur einschließlich fester und variabler Teile.
Prüfen Sie das Zielland, bevor Sie den Versandablauf wählen. Absenderregistrierung betrifft die Absenderidentität und kann neben einer Inhaltsanforderung bestehen.
Wie wählt Bird Kategorie und Absender?
Die Vorlage liefert die Kategorie, also die Klassifizierung des Inhalts nach dem Versandzweck. Integrierte Vorlagen wählen einen Absender für das Ziel; Workspace-Vorlagen verwenden den von Ihnen angegebenen Absender.
Ein Vorlagenversand lehnt text, category und media_urls neben template ab. Lassen Sie from bei einer integrierten Vorlage weg und geben Sie es bei einer Workspace-Vorlage an. Der Vertrag für den Vorlagenversand dokumentiert diese Anforderungen.
Verwenden Sie eine Workspace-Vorlage oder Freitext, wenn Ihre Anwendung einen bestimmten Absender auswählen muss.
Prüfen Sie from und category in der Antwort. Diese Felder zeigen Ihnen, welchen Absender und welche Inhaltsklassifizierung Bird für diese Nachricht gewählt hat.
Wie sende ich ein Template in Bird?
Geben Sie eine veröffentlichte Vorlage an und übermitteln Sie ihre Variablenwerte im Objekt template des Versands.
Identifizieren Sie sie mit slug oder id. Rufen Sie GET /v1/sms/templates/{template_ref} ab, um ihre live_version_id zu erhalten, und anschließend GET /v1/sms/templates/{template_ref}/versions/{version_id} für Inhalt und Variablendefinitionen.
Tragen Sie Werte in parameters ein, indiziert nach Variablenname. Fehlende Pflichtfelder, nicht deklarierte Schlüssel oder ungültige Formate liefern 422 zurück – validieren Sie die Werte daher vor dem Versand.
Das serialisierte Parameters-Objekt darf maximal 16 KB groß sein. Bird lehnt einen Request ab, der dieses Limit überschreitet – beschränken Sie sich daher auf die deklarierten Werte des Templates.
Wählen Sie language bei Bedarf. Die Spracheinstellungen des Templates bestimmen Standard und Fallback – prüfen Sie diese Einstellungen, statt anzunehmen, dass jede gewünschte Sprache existiert.
Ändern Templates die Abrechnung von SMS?
Der gerenderte Text wird wie jeder andere SMS-Body gezählt.
Setzen Sie die echten Werte ein, bevor Sie Segmente schätzen. Eine lange Bestellreferenz oder ein Name außerhalb des kompakten Alphabets kann die Anzahl erhöhen.
Eine Template-Referenz ist kein Festpreis pro Empfänger. Das Feld segments.count in der Antwort meldet die abrechenbaren Teile für diese gerenderte Nachricht.
Wann sollte ich ein Template wählen?
Wählen Sie ein Katalog-Template, wenn dessen Text, Variablen und Absenderauswahlverhalten zu Ihrem Ablauf passen.
- Verwenden Sie ein Template, wenn der bereitgestellte Text zur Nachricht passt und Sie die erforderlichen Werte haben.
- Veröffentlichen Sie eine Workspace-Vorlage für wiederverwendbare Formulierungen mit eigenem Absender oder verwenden Sie Freitext für eine einzelne Nachricht.
- Wenden Sie die Registrierungsanforderungen des Ziellandes auf beide Varianten an.
Kurz gesagt
Vorlagen enthalten wiederverwendbaren Text und Variablendefinitionen.
Wählen Sie eine integrierte Vorlage oder verwenden Sie eine veröffentlichte Workspace-Vorlage und geben Sie deren erforderliche Werte an.
Die Absenderauswahl hängt vom Geltungsbereich der Vorlage ab.
Integrierte Vorlagen verwenden einen von Bird ausgewählten Absender. Workspace-Vorlagen erfordern einen Absender, der Ihnen gehört. Die Vorlage liefert die Kategorie.
Die Veröffentlichung im Workspace erfordert keine Prüfung durch Meta.
Beim Veröffentlichen einer Workspace-Vorlage wird ihr Entwurf validiert. Die veröffentlichte Version kann sofort zum Senden verwendet werden. Zielabhängige Regeln zur Inhaltsregistrierung gelten unabhängig davon.
Eingesetzte Werte beeinflussen weiterhin die Segmentanzahl.
Prüfen Sie die gerenderte Nachricht, da längere Werte die abrechenbaren Segmente erhöhen können.