API de administración de WhatsApp Business

Plantillas de código de cupón

Las plantillas de código de cupón son plantillas de marketing que muestran un solo botón de copiar código. Cuando se toca el botón, el código se copia en el portapapeles del cliente.

Limitaciones

  • Por el momento, el cliente de WhatsApp Web no admite las plantillas de código de cupón.
  • Los códigos no pueden superar los 15 caracteres.
  • El texto del botón no se puede personalizar.
  • Las plantillas solo pueden incluir un botón de copiar código.

Crear plantillas de código de cupón

Usa el punto de conexión Cuenta de WhatsApp Business > Plantillas de mensajes para crear plantillas de código de cupón.

Sintaxis de la solicitud

POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates

Cuerpo de la solicitud POST

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

Propiedades

Marcador de posiciónDescripciónValor de ejemplo

<NAME>

Cadena

Obligatorio.


Nombre de la plantilla.


Máximo de 512 caracteres.

fall2023_promotion

<LANGUAGE>

Enumeración

Obligatorio.


Código de idioma y configuración regional de la plantilla.

en_US

<EXAMPLE>

Cadena

Obligatorio.


Código del cupón que se copiará cuando se toque el botón.


Máximo de 15 caracteres.

25OFF

Respuesta

Si la solicitud se procesa correctamente, la API responderá con lo siguiente:

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

Propiedades de la respuesta

Marcador de posiciónDescripciónValor de ejemplo

<CATEGORY>

Enumeración

Categoría de plantilla.

MARKETING

<ID>

Cadena numérica

Identificador de la plantilla.

1924084211297547

<STATUS>

Enumeración

Estado de la plantilla.

PENDING

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Enviar plantillas de cupón

Usa la API de la nube para enviar plantillas de código de cupón aprobadas en mensajes de plantillas. Consulta Enviar plantillas de código de cupón.