Modèles marketing
Chaque modèle WhatsApp appartient à l'une des trois catégories de Meta : authentication, utility ou marketing. Marketing est la catégorie promotionnelle, et c'est la seule que Meta achemine via une seconde API. Les envois marketing passent par l'API Marketing Messages API de Meta, et toutes les autres catégories passent par la Cloud API, sur le même numéro de téléphone.
La catégorie détermine aussi le prix. Un modèle marketing est facturé au tarif marketing du pays du destinataire, quelle que soit l'API utilisée. Les tarifs figurent sur la page de tarification WhatsApp, et Coûts et facturation décrit à quel moment chaque partie d'un envoi est facturée.
Ce qu'il vous faut pour en envoyer un
Notre catalogue géré ne contient que des modèles d'authentification et utilitaires, donc un envoi marketing utilise toujours un modèle créé par votre espace de travail :
- Connectez un WhatsApp Business Account qui vous appartient, car un modèle que vous créez est enregistré sur votre compte et non sur le nôtre. Voir Configuration du numéro de téléphone.
- Créez un modèle avec la catégorie marketing et soumettez-le pour examen. Meta examine la catégorie en même temps que le contenu, et recatégorise un modèle à caractère promotionnel. Directives relatives aux modèles décrit ce qui passe l'examen.
- Envoyez depuis un numéro du compte qui détient le modèle. Un modèle appartient à un seul WhatsApp Business Account, donc un envoi désignant un numéro sur un autre compte est rejeté avant d'atteindre Meta.
Marketing Messages API sur le compte professionnel
Ouvrez Numbers, choisissez un numéro, puis ouvrez son compte professionnel pour voir ce que Meta rapporte sur le compte sous lequel le numéro envoie. La ligne Marketing Messages API indique l'état d'intégration de ce compte :
| Valeur | Signification |
|---|---|
| Eligible | Meta accepterait une demande d'intégration pour ce compte |
| Onboarded | Le compte est intégré et ses envois marketing sont optimisés |
La ligne est absente tant que Meta n'a pas signalé de valeur. Il s'agit d'une lecture fournisseur enregistrée, pas d'une vérification d'éligibilité en temps réel. Bird actualise périodiquement les métadonnées des comptes connectés ; des délais et des échecs peuvent laisser certains champs plus anciens que la dernière lecture réussie. Confirmez l'intégration dans WhatsApp Manager lorsqu'un envoi en dépend.
Meta accepte les conditions une seule fois pour l'ensemble d'un portefeuille d'entreprise, donc le panneau affiche aussi un second état, à l'échelle du portefeuille : not_started, request_sent ou term_of_service_signed. Meta donne aux deux champs le même nom mais deux vocabulaires différents. Consultez la ligne du compte pour l'éligibilité et la ligne du portefeuille pour l'avancement dans les conditions.
L'intégration se fait chez Meta et non dans le tableau de bord Bird. Une personne disposant du contrôle total du portefeuille d'entreprise accepte les conditions Marketing Messages API dans WhatsApp Manager, sous Overview > Accept terms to get started. Le guide d'intégration de Meta décrit les étapes en vigueur.
Envoyer avant l'intégration du compte
Le chemin d'envoi prend en charge le product_policy de CLOUD_API_FALLBACK de Meta, permettant aux messages marketing éligibles d'utiliser la Cloud API tant que l'intégration Marketing Messages API est incomplète. La catégorie marketing détermine toujours le tarif applicable. Ce repli ne contourne pas les restrictions liées au destinataire, au compte ou au contenu, et ne garantit pas la livraison. Les formats nécessitant l'API Marketing Messages API, y compris les en-têtes GIF, exigent toujours l'intégration.
Fonctionnalités supplémentaires et paramètres d'envoi
Meta propose des fonctionnalités supplémentaires d'optimisation et de mesure marketing pour les comptes et marchés éligibles. Confirmez les fonctionnalités disponibles pour votre compte dans le comparatif des fonctionnalités de Meta avant de faire dépendre un lancement de celles-ci. L'intégration seule ne prouve pas que chaque fonctionnalité d'optimisation ou de reporting est activée pour chaque destinataire.
Le chemin d'envoi actuel de Bird sélectionne l'API Marketing Messages API pour les modèles marketing et inclut CLOUD_API_FALLBACK. Il ne fournit pas de plafonds d'optimisation par envoi, de surcharges de fonctionnalités créatives de modèle, de configuration de mesure de conversion, ni de configuration de liens profonds Android. Ne présumez pas que ces paramètres sont configurés parce qu'un modèle a été approuvé.
Lorsque Meta signale la catégorie tarifaire marketing_lite, Bird la fait correspondre à la catégorie de tarif marketing. Consultez le coût signalé du message et les relevés de facturation pour le montant réel ; un message soumis et un message livré ont des déclencheurs de frais différents.
Vérifiez les restrictions de destination et de destinataire
L'éligibilité marketing peut varier selon le pays du destinataire, le compte, le format et les limites par destinataire de Meta. Confirmez les restrictions en vigueur dans la documentation de Meta et dans WhatsApp Manager pour les destinations de votre campagne. Le pays d'un numéro professionnel ne garantit pas que tous ses destinataires prévus peuvent recevoir des modèles marketing.
L'erreur Meta 131049 est signalée par Bird sous la forme rate_limited. Examinez les détails du fournisseur, l'éligibilité de la destination et les limites par destinataire avant de réessayer. Ne considérez pas un envoi accepté ou un modèle approuvé comme preuve de l'éligibilité du destinataire, et ne renvoyez pas un message restreint de manière répétée.
Quand un destinataire refuse les messages marketing
WhatsApp offre à chaque destinataire un contrôle Offers and announcements sur votre profil d'entreprise. Choisir Not interested alimente les limites par utilisateur de Meta, et l'arrêt complet de la livraison bloque vos modèles marketing tout en laissant les messages utilitaires et d'authentification intacts.
Un refus du fournisseur peut signaler l'erreur Meta 131050. Consultez le code fournisseur dans last_error.meta_error_code ainsi que l'erreur normalisée de Bird et le journal des messages. Lorsque Bird dispose déjà d'une préférence de désinscription applicable, il peut rejeter le message avant la livraison par le fournisseur. Examinez le choix enregistré du destinataire avant de réessayer.
Lorsque Bird reçoit un événement d'arrêt valide de Meta, il enregistre une préférence d'origine destinataire, non transactionnelle, limitée au WhatsApp Business Account. Celle-ci figure dans l'onglet Preferences, et non dans la liste Suppressions. Un événement de reprise met à jour cette préférence ; les blocages indépendants restent en vigueur. Vérifiez les deux onglets et l'historique des événements avant d'ajouter une suppression distincte de tous les messages. Un refus du fournisseur peut arriver avant l'enregistrement de la préférence correspondante. Voir Désinscriptions pour la portée et la couverture.
Étapes suivantes
- Directives relatives aux modèles : les règles selon lesquelles Meta examine un modèle marketing
- Modèles WhatsApp : navigation, statuts et lecture du contenu d'un modèle via l'API
- Envoyer des messages WhatsApp : nommer un modèle et un expéditeur lors d'un envoi
- Qualité du numéro et limite de messagerie : l'impact du volume marketing sur la notation d'un numéro
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Regarder le guideConnecting WhatsApp to Bird: from buying a number to a live channelComprendre le conceptWhat is the 24-hour customer service window on WhatsApp?Utiliser l'outilWhatsApp message builderExplorer la fonctionnalitéWhatsApp
Essayez la pratique et obtenez un guide d'implémentation