Modèles marketing WhatsApp

Un modèle marketing transporte du contenu promotionnel, comme une offre, une annonce de produit ou un coupon. Avant l'envoi, préparez un contenu approuvé, obtenez l'autorisation du destinataire et prévoyez une méthode claire pour traiter les réponses et les désinscriptions.

WhatsApp Studio envoie à un seul destinataire à la fois. Une diffusion envoie un modèle marketing à toute une audience depuis le tableau de bord. Pour planifier une campagne, consultez WhatsApp Studio et campagnes marketing.

Avant l'envoi

Le catalogue géré de Bird ne contient aucun modèle marketing. Un envoi marketing utilise donc toujours un modèle créé par votre espace de travail, sur votre propre compte WhatsApp Business :

Connectez un compte WhatsApp Business et un numéro qui vous appartient. Consultez Configuration du numéro de téléphone.
Créez un modèle marketing et soumettez-le à validation. Consultez les Consignes relatives aux modèles pour savoir ce qui est accepté.
Envoyez depuis un numéro rattaché au même compte WhatsApp Business que le modèle. from est obligatoire pour un envoi marketing, et un expéditeur rattaché à un autre compte est refusé 422 E15023 WhatsAppSenderWABAMismatch avant toute facturation.

Envoyer un modèle marketing

POST /v1/whatsapp/messages en définissant from et un objet template qui indique votre propre slug :

const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13125550101",
  template: {
    slug: "summer_sale",
    language: "en",
    parameters: {
      header_url: "https://cdn.example.com/banners/summer.png",
      first_name: "Pablo",
      code: "SUMMER25",
    },
  },
});
console.log(msg.id, msg.status);

msg = client.whatsapp.send(
    to="+16505551234",
    from_="+13125550101",
    template="summer_sale",
    language="en",
    parameters={
        "header_url": "https://cdn.example.com/banners/summer.png",
        "first_name": "Pablo",
        "code": "SUMMER25",
    },
)
print(msg.id, msg.status)

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}
	msg, err := client.Whatsapp.Send(context.Background(), bird.WhatsappSendParams{
		To:         "+16505551234",
		From:       "+13125550101",
		Template:   "summer_sale",
		Language:   "en",
		Parameters: map[string]any{
			"header_url": "https://cdn.example.com/banners/summer.png",
			"first_name": "Pablo",
			"code":       "SUMMER25",
		},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(msg.Id, *msg.Status)
}

$message = $bird->whatsapp->send(
    to: '+16505551234',
    from: '+13125550101',
    template: 'summer_sale',
    language: 'en',
    parameters: [
        'header_url' => 'https://cdn.example.com/banners/summer.png',
        'first_name' => 'Pablo',
        'code' => 'SUMMER25',
    ],
);
echo $message->getId(), ' ', $message->getStatus();

bird whatsapp send \
  --from +13125550101 \
  --language en \
  --parameters '{"code":"SUMMER25","first_name":"Pablo","header_url":"https://cdn.example.com/banners/summer.png"}' \
  --template summer_sale \
  --to +16505551234

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "to": "+16505551234",
      "from": "+13125550101",
      "template": {
        "slug": "summer_sale",
        "language": "en",
        "parameters": {
          "header_url": "https://cdn.example.com/banners/summer.png",
          "first_name": "Pablo",
          "code": "SUMMER25"
        }
      }
    }'

Les variables du corps sont nommées, comme pour les modèles utilitaires, donc first_name constitue sa propre clé.
Le code d'un bouton de coupon se place dans code, comme dans l'exemple ci-dessus. Il n'existe pas de clé distincte pour le coupon.
Un en-tête média utilise header_url, qu'il s'agisse d'une image, d'une vidéo ou d'un gif. Omettez-le pour envoyer l'exemple approuvé du modèle. Un modèle importé depuis Meta n'en a pas, il nécessite donc header_url. Le marketing est la seule catégorie qui accepte un en-tête GIF animé.
Le média et le suffixe d'URL numéroté d'une carte de carrousel utilisent des clés numérotées : header_url_1 et button_url_1 pour la première carte, header_url_2 pour la deuxième, et ainsi de suite. Nommez les variables à l'intérieur des cartes. Un nom utilisé dans deux cartes correspond à une seule clé, donc les deux cartes reçoivent la même valeur. Un carrousel dont chaque carte numérote un {{1}} n'utilise que components, avec les valeurs sur cards, et cet envoi doit fournir exactement le nombre de cartes avec lequel le modèle a été approuvé.

Bird achemine automatiquement chaque envoi marketing vers l'API Marketing Messages de Meta ; vous n'avez pas à vous inscrire et il n'existe aucun réglage par envoi. Le statut d'intégration du compte professionnel auprès de cette API conditionne les optimisations de Meta, et non la distribution elle-même, sauf pour les en-têtes gif et les modèles à prix maximal, qui exigent un compte intégré. Consultez Modèles marketing pour l'état du compte, ce que l'intégration débloque et les pays où le marketing est limité.

Désinscriptions

Lorsque Bird reçoit de Meta un événement valide d'arrêt du marketing, il enregistre une préférence du destinataire pour ce compte professionnel. Cette préférence est distincte d'une suppression de tous les messages. Vérifiez les deux enregistrements avant l'envoi. Un échec de distribution peut arriver avant l'événement de préférence correspondant ; respectez le choix du destinataire et examinez cet historique au lieu de réessayer. Consultez Préférences pour enregistrer et lire ces enregistrements.

Coût

Appliquez le tarif marketing publié pour la destination et la devise, ou définissez un prix maximal pour des frais de distribution Meta variables, dans la limite de votre plafond. Bird facture ses frais d'envoi avant la soumission ; une distribution ou une lecture facturable peut ajouter les frais de Meta. Consultez Coûts et facturation et Tarifs WhatsApp.

Points d'attention

La catégorie attribuée par Meta détermine le prix. Meta peut reclasser un contenu promotionnel en marketing après l'approbation. Vérifiez la catégorie actuelle de chaque langue avant l'envoi ; un envoi à prix maximal exige la catégorie marketing. Consultez le processus d'examen des catégories de Meta si vous contestez la classification.
131049 est une pause de distribution, et non une limitation du débit que vous avez configurée ; réessayer aggrave la situation. Meta signale 131049 à la fois pour sa pause générale aux États-Unis et pour un plafond marketing par utilisateur, et recommande d'attendre environ un jour avant de renvoyer. Un renvoi plus rapide peut rendre le compte indisponible plus longtemps pour ce destinataire et fausse votre propre taux de distribution. Bird signale l'échec sous la forme rate_limited.
131050 signifie que le destinataire a désactivé "Offers and announcements", et il ne faut jamais réessayer l’envoi. Meta accepte l’envoi, puis refuse de le distribuer. La bonne réponse passe par les préférences de messagerie, pas par un nouvel envoi : placez vous-même le destinataire sur la liste de suppression, ou attendez qu’il réactive la distribution. Bird en est informé par le même mécanisme de préférences que celui qui a signalé l’arrêt. Consultez Preferences.
132015 et 132016 indiquent une mise en pause du modèle, pas un problème lié au destinataire. 132015 est une pause due à une qualité faible ; 132016 est une désactivation définitive après des pauses répétées, et le seul remède consiste à créer un nouveau modèle au contenu différent. Vérifiez le statut propre à la langue plutôt que celui du modèle, car une langue en pause cesse immédiatement d’envoyer.
Un expéditeur rattaché au mauvais WhatsApp Business Account est refusé avant toute facturation. from doit se trouver sur le même compte que le modèle, sinon l’envoi échoue 422 E15023 WhatsAppSenderWABAMismatch.

Étapes suivantes

Modèles WhatsApp : parcourir le catalogue et le contrat commun d’envoi par modèle
Modèles marketing : la API Marketing Messages, le statut d’intégration et les pays où le marketing est limité
Préférences : enregistrer et lire les déclarations des destinataires
Modèles utilitaires : mises à jour de commande, rappels de rendez-vous et notifications de compte

Poursuivez avec la documentation, les guides et les exemples sur ce sujet.

Essayez la pratique et obtenez un guide d'implémentation