Modelli di codici coupon

I modelli di codici coupon sono modelli di marketing che visualizzano un singolo pulsante per copiare il codice. Quando toccato, il codice viene copiato negli appunti del cliente.

Limitazioni

I modelli di codici coupon al momento non sono supportati dal client web WhatsApp.
I codici sono limitati a 15 caratteri.
Il testo del pulsante non può essere personalizzato.
I modelli sono limitati a un solo pulsante per copiare il codice.

Creazione di modelli di codici coupon

Usa l'endpoint WhatsApp Business Account > Message Templates per creare modelli di codici coupon.

Sintassi della richiesta

POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates

Corpo del post

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

Proprietà

Segnaposto Descrizione Valore di esempio

Segnaposto	Descrizione	Valore di esempio
`<NAME>` Stringa	Obbligatorio. Nome del modello. Massimo 512 caratteri.	`fall2023_promotion`
`<LANGUAGE>` Enum	Obbligatorio. Codice della lingua e della relativa variante del modello.	`en_US`
`<EXAMPLE>` Stringa	Obbligatorio. Codice coupon da copiare quando toccato. Massimo 15 caratteri.	`25OFF`

<NAME>

Stringa

Obbligatorio.

Nome del modello.

Massimo 512 caratteri.

fall2023_promotion

<LANGUAGE>

Enum

Obbligatorio.

Codice della lingua e della relativa variante del modello.

en_US

<EXAMPLE>

Stringa

Obbligatorio.

Codice coupon da copiare quando toccato.

Massimo 15 caratteri.

25OFF

Risposta

In caso di azione eseguita correttamente, l'API risponderà con quanto segue:

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

Proprietà della risposta

Segnaposto Descrizione Valore di esempio

Segnaposto	Descrizione	Valore di esempio
`<CATEGORY>` Enum	Categoria del modello.	`MARKETING`
`<ID>` Stringa numerica	ID modello.	`1924084211297547`
`<STATUS>` Enum	Stato del modello.	`PENDING`

<CATEGORY>

Enum

Categoria del modello.

MARKETING

<ID>

Stringa numerica

ID modello.

1924084211297547

<STATUS>

Enum

Stato del modello.

PENDING

Esempio di richiesta

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"
        }
      ]
    }
  ]
}'

Esempio di risposta

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

Invio di modelli di coupon

Usa l'API Cloud per inviare modelli di codici coupon approvati in un modello di messaggio. Consulta Invio dei modelli di codici coupon.