Une mise à jour de commande nécessite un libellé fixe et des détails propres à l'achat. Un modèle sépare le libellé approuvé des valeurs telles que le numéro de commande.
Quand ai-je besoin d'un modèle ?
Utilisez un modèle approuvé lorsque vous envoyez en dehors de la fenêtre de service de 24 heures du client.
À l'intérieur d'une fenêtre ouverte, vous pouvez répondre avec du contenu libre. L'envoi d'un modèle ne rouvre pas cette fenêtre en soi ; c'est la réponse du client qui le fait.
L'approbation ne remplace pas le consentement du client. Suivez la politique de messagerie de Meta pour le message que vous souhaitez envoyer.
Que contient un modèle dans Bird ?
Un modèle identifie du contenu réutilisable, tandis que ses versions contiennent le libellé pour chaque langue.
Utilisez le slug lors de l'envoi. Le nom d'affichage identifie le modèle, mais ce n'est pas l'identifiant utilisé pour résoudre un envoi.
Choisissez authentication, marketing ou utility lors de la création du modèle. Bird fixe la catégorie déclarée et le slug après la création.
Le contenu d'une langue inclut un bloc body obligatoire. Il peut aussi inclure un header, un footer, un buttons ou un carousel, selon les règles de contenu du modèle.
Pour inspecter le contenu approuvé, lisez live_version_id depuis le modèle. Récupérez ensuite la langue de cette version via la commande de langue.
Un modèle sans version active ne peut pas envoyer. Son brouillon peut encore contenir du contenu qui n'a pas passé l'examen.
Quelle langue et quelle catégorie un envoi utilisera-t-il ?
Vérifiez available_languages pour les langues disponibles à l'envoi. Vérifiez le category propre à la langue pour la classification tarifaire de Meta.
Le status du modèle résume ses langues. Un modèle active possède au moins une langue disponible à l'envoi. Une autre langue peut être rejetée, suspendue ou désactivée.
Meta peut retirer l'approbation ou la disponibilité d'une langue après le lancement. Vérifiez l'état de la langue au moment de l'envoi au lieu de conserver une liste permanente issue du déploiement.
Meta peut aussi reclasser une langue sans modifier la catégorie que vous avez déclarée. Utilisez la classification de cette langue avec les tarifs WhatsApp publiés pour estimer les coûts.
Utilisez des exemples pour vérifier la catégorie avant de soumettre une langue :
| Exemple de contenu | Leçon sur la catégorie visée |
|---|---|
Your order {{reference}} has shipped. | Une mise à jour de transaction spécifique correspond au modèle utility |
Your code is {{code}}. | Un message d'authentification utilise la catégorie authentication et ses règles de rédaction |
Get 20% off your next order. | Une offre promotionnelle relève du parcours marketing |
Gardez les exemples à titre indicatif. Meta examine la langue soumise et peut la classer différemment de la catégorie que vous avez sélectionnée.
Définissez on_missing_language pour décider du comportement lorsque la langue demandée n'a pas de contenu disponible. Bird attribue par défaut fail aux nouveaux modèles WhatsApp. Chaque langue est approuvée et tarifée séparément, de sorte qu'un substitut silencieux pourrait envoyer un contenu inattendu à un tarif non prévu.
Cette politique autorise tout de même une balise plus large : pt peut répondre à une requête pour pt-BR. Elle ne substitue pas la variante sœur pt-PT.
Choisissez fallback uniquement lorsque la substitution par la langue par défaut configurée est acceptable pour vos destinataires. Les modèles gérés par Bird conservent leur politique fixe de langue manquante.
Comment modifier du contenu soumis ?
Créez un nouveau brouillon. Rédigez la langue corrigée. Soumettez cette version pour examen.
Bird rend les versions soumises immuables, de sorte que la modification du libellé du modèle n'altère pas le contenu des messages approuvés.
| Champ | Ce qu'il vous indique |
|---|---|
draft_version_id | Un brouillon non soumis existe |
pending_version_id | Une version soumise contient encore des langues non résolues |
live_version_id | Cette version fournit le contenu utilisé pour les envois |
L'approbation d'une seule langue peut rendre toute sa version active. D'autres langues de cette version peuvent encore être en attente ou rejetées.
Vérifiez la langue de la version soumise pour suivre un examen. Le modèle peut encore afficher une version active antérieure pendant qu'un remplacement attend l'approbation.
Comment envoyer un modèle ?
Nommez le modèle. Fournissez les variables requises par la langue que vous souhaitez envoyer.
Trouvez les modèles disponibles avec :
bird whatsapp templates listUtilisez bird whatsapp templates get pour inspecter le modèle sélectionné. Récupérez le contenu de sa langue avant d'assembler les components de l'envoi, qui portent les valeurs des variables de ce modèle.
Dans le tableau de bord, le détail du modèle fournit un exemple cURL avec les valeurs d'exemple de ce modèle. Remplacez le destinataire, les identifiants et les variables par vos valeurs souhaitées avant l'envoi.
Un modèle rédigé nécessite un expéditeur sur le même compte Business WhatsApp. Suivez la procédure d'envoi. Suivez l'identifiant de message retourné via les événements de livraison.
Une réponse 202 accepte la requête pour traitement. Confirmez la livraison à partir du résultat ultérieur avant de considérer le message comme reçu.
En bref
Vérifiez la langue avant l'envoi.
Un modèle actif peut contenir des langues indisponibles. Utilisez
available_languagespour vérifier si la langue du destinataire peut envoyer.Consultez la catégorie de la langue.
Meta peut classer une langue différemment de la catégorie que vous avez déclarée. La tarification suit la classification de Meta.
Modifiez via un nouveau brouillon.
Bird gèle les versions soumises. Créez un nouveau brouillon pour modifier le contenu. Soumettez la langue corrigée pour examen.
Envoyez le contenu approuvé avec ses variables.
Nommez le modèle et fournissez les valeurs attendues par sa langue. Une requête acceptée ne garantit pas la livraison.