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 único botón para copiar código. Al tocarlas, el código se copia al portapapeles del cliente.

Limitaciones

  • Actualmente, el cliente web de WhatsApp no admite 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 se limitan a un botón para copiar código.

Crear plantillas de código de cupón

Utiliza el extremo 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ónEjemplo de valor

<NAME>

Cadena

Obligatorio.


Nombre de la plantilla.


Máximo 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 de cupón que se copia al tocarlo.


Máximo 15 caracteres.

25OFF

Respuesta

Si la operación se realiza correctamente, la API responderá con lo siguiente:

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

Propiedades de la respuesta

Marcador de posiciónDescripciónEjemplo de valor

<CATEGORY>

Enumeración

Categoría de la 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 nube para enviar plantillas de código de cupón aprobadas en mensajes de plantilla. Consulta Enviar plantillas de código de cupón.