Modèles de code de coupon

Les modèles de code de coupon sont des modèles marketing qui contiennent un bouton de copie de code unique. Lorsque le client ou la cliente appuie sur ce dernier, le code est copié dans son presse-papiers.

Limites

Les modèles de code de coupon ne sont actuellement pas pris en charge par le client Web WhatsApp.
Les codes ne peuvent pas dépasser 15 caractères.
Le texte du bouton n’est pas personnalisable.
Les modèles sont limités à un bouton de copie de code.

Création de modèles de code de coupon

Utilisez le point de terminaison Compte WhatsApp Business > Modèles de message pour créer des modèles de code de coupon.

Syntaxe de la requête

POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates

Corps de la requête POST

{
  "name": "<NAME>",
  "language": "<LANGUAGE>",
  "category": "MARKETING",
  "components": [
    ... // Additional components, if using
    {
      "type":"BUTTONS",
      "buttons": [
        {
          "type":"COPY_CODE",
          "example": "<EXAMPLE>"
        },
        ... // Additional buttons, if using
      ]
    }
  ]
}

Propriétés

Espace réservé Description Exemple de valeur

Espace réservé	Description	Exemple de valeur
`<NAME>` Chaîne	Obligatoire. Nom du modèle. 512 caractères maximum.	`fall2023_promotion`
`<LANGUAGE>` Énumération	Obligatoire. Code langue et région du modèle.	`en_US`
`<EXAMPLE>` Chaîne	Obligatoire. Code coupon à copier lorsque l’utilisateur·ice sélectionne le bouton. 15 caractères maximum.	`25OFF`

<NAME>

Chaîne

Obligatoire.

Nom du modèle.

512 caractères maximum.

fall2023_promotion

<LANGUAGE>

Énumération

Obligatoire.

Code langue et région du modèle.

en_US

<EXAMPLE>

Chaîne

Obligatoire.

Code coupon à copier lorsque l’utilisateur·ice sélectionne le bouton.

15 caractères maximum.

25OFF

Réponse

En cas de réussite, l’API répond comme suit :

{
   "category" : "<CATEGORY>",
   "id" : "<ID>",
   "status" : "<STATUS>"
}

Propriétés de la réponse

Espace réservé Description Exemple de valeur

Espace réservé	Description	Exemple de valeur
`<CATEGORY>` Énumération	Catégorie du modèle.	`MARKETING`
`<ID>` Chaîne numérique	ID du modèle.	`1924084211297547`
`<STATUS>` Énumération	Statut du modèle.	`PENDING`

<CATEGORY>

Énumération

Catégorie du modèle.

MARKETING

<ID>

Chaîne numérique

ID du modèle.

1924084211297547

<STATUS>

Énumération

Statut du modèle.

PENDING

Exemple de requête

curl 'https://graph.facebook.com/v21.0/102290129340398/message_templates' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "name": "coupon_code_fall2023_25off",
  "language": "en_US",
  "category": "MARKETING",
  "components": [
    {
      "type": "HEADER",
      "format": "TEXT",
      "text": "Our Fall Sale is on!"
    },
    {
      "type": "BODY",
      "text": "Shop now through November and use code {{1}} to get {{2}} off of all merchandise!",
      "example": {
        "body_text": [
          [
            "25OFF",
            "25%"
          ]
        ]
      }
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "QUICK_REPLY",
          "text": "Unsubscribe"
        },
        {
          "type": "COPY_CODE",
          "example": "250FF"
        }
      ]
    }
  ]
}'

Exemple de réponse

{
  "category" : "MARKETING",
  "id" : "1924084211297547",
  "status" : "PENDING"
}

Envoi de modèles de coupon

Utilisez l’API Cloud pour envoyer des modèles de code de coupon approuvés dans des messages de modèle. Reportez-vous à Envoi de modèles de code de coupon.