Une confirmation de commande peut réutiliser sa formulation tout en changeant le numéro de commande pour chaque destinataire. Le flux de travail reste cohérent tandis que les données changent.
Que contient un template ?
Un template contient du texte fixe, des définitions de variables et la catégorie du message, qui classifie la raison de l'envoi. Une destination peut appliquer cette classification de contenu à ses règles d'enregistrement.
Chaque variable nomme une valeur qui change entre les envois, comme un numéro de commande. Le template définit le type accepté, s'il est requis et toute contrainte sur sa valeur.
Le contenu et les modèles de campagne associent du texte réutilisable à des valeurs propres au destinataire. Le catalogue de modèles de Bird comprend des modèles système pour les messages d’authentification et transactionnels. Les modèles d’espace de travail permettent de publier votre propre texte dans plusieurs langues. Leur création passe par l’API de gestion des modèles.
Consultez les variables avant de choisir un template. Un aperçu d'apparence familière ne garantit pas que ses valeurs requises correspondent aux données dont votre application dispose.
Les templates SMS nécessitent-ils une approbation ?
Les modèles intégrés sont prêts à l’envoi. La publication d’un modèle d’espace de travail valide son texte et ses variables. La version publiée est disponible immédiatement, sans approbation de Meta. Les règles de destination peuvent toujours exiger l’enregistrement du contenu.
Ce sont des processus distincts. Le corps de message réutilisable d'un fournisseur n'établit pas en soi la conformité avec les règles d'une destination.
Par exemple, les directives de la TRAI pour les expéditeurs exigent l'enregistrement de templates de contenu pour les communications via des identités d'expéditeur enregistrées en Inde. Cette exigence concerne la structure du message, y compris les parties fixes et variables.
Vérifiez la destination avant de choisir le flux d'envoi. L'enregistrement de l'expéditeur concerne l'identité d'envoi et peut coexister avec une exigence de contenu.
Comment Bird choisit-il la catégorie et l'expéditeur ?
Le modèle fournit la catégorie, qui classe le contenu selon le motif d’envoi du message. Les modèles intégrés sélectionnent un expéditeur pour la destination ; les modèles d’espace de travail utilisent celui que vous fournissez.
Un envoi par modèle refuse text, category et media_urls en présence de template. Omettez from pour un modèle intégré et fournissez-le pour un modèle d’espace de travail. Le contrat d’envoi par modèle décrit ces exigences.
Utilisez un modèle d’espace de travail ou du texte libre si votre application doit choisir un expéditeur précis.
Inspectez from et category dans la réponse. Ces champs vous indiquent quel expéditeur et quelle classification de contenu Bird a sélectionnés pour ce message.
Comment envoyer un template dans Bird ?
Identifiez un modèle publié et fournissez les valeurs de ses variables dans l’objet template de l’envoi.
Utilisez slug ou id pour l’identifier. Consultez GET /v1/sms/templates/{template_ref} pour obtenir sa live_version_id, puis GET /v1/sms/templates/{template_ref}/versions/{version_id} pour son contenu et les définitions de ses variables.
Placez les valeurs dans parameters, indexées par nom de variable. Les valeurs requises manquantes, les clés non déclarées ou les formats invalides renvoient 422, validez donc les valeurs avant de lancer l'envoi.
L'objet parameters sérialisé doit tenir dans 16 Ko. Bird rejette une requête qui dépasse cette limite, limitez-vous donc aux valeurs déclarées du template.
Choisissez language si nécessaire. Les paramètres de langue du template déterminent la valeur par défaut et tout repli, inspectez donc ces paramètres au lieu de supposer que chaque langue demandée existe.
Les templates changent-ils la facturation de SMS ?
Le texte rendu est comptabilisé comme tout autre corps de message SMS.
Insérez les valeurs réelles avant d'estimer les segments. Une longue référence de commande ou un nom en dehors de l'alphabet compact peut augmenter le nombre.
Une référence de template n'est pas un prix fixe pour chaque destinataire. Le champ segments.count de la réponse indique les parties facturables pour ce message rendu.
Quand choisir un template ?
Choisissez un template du catalogue lorsque son corps, ses variables et son comportement de sélection d'expéditeur correspondent à votre flux de travail.
- Utilisez un template lorsque le corps fourni correspond au message et que vous disposez de ses valeurs requises.
- Publiez un modèle d’espace de travail pour du texte réutilisable avec votre propre expéditeur, ou utilisez du texte libre pour un message individuel.
- Appliquez les exigences d'enregistrement de la destination quel que soit votre choix.
En bref
Les modèles contiennent du texte réutilisable et des définitions de variables.
Choisissez un modèle intégré ou un modèle publié dans votre espace de travail, puis fournissez les valeurs requises.
La sélection de l’expéditeur dépend de la portée du modèle.
Les modèles intégrés utilisent un expéditeur choisi par Bird. Les modèles d’espace de travail nécessitent un expéditeur qui vous appartient. Le modèle fournit la catégorie.
La publication dans l’espace de travail ne nécessite pas d’examen par Meta.
La publication d’un modèle d’espace de travail valide son brouillon. La version publiée est immédiatement disponible pour l’envoi. Les règles d’enregistrement du contenu propres à la destination restent distinctes.
Les valeurs substituées affectent toujours le nombre de segments.
Vérifiez le message rendu, car des valeurs plus longues peuvent augmenter le nombre de segments facturables.