> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plantillas de código de cupón

> Permite que los clientes copien un código de oferta desde un mensaje de marketing.

Una plantilla de código de cupón es un mensaje de marketing con un botón que copia un código promocional en el portapapeles del cliente.

<Frame caption="A promotional code is copied for redemption.">
  <div style={{ position: "relative", width: "100%", maxWidth: "480px", margin: "0 auto" }}>
    <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-coupon-code-components.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=88616456fe6538fb7eaab12f5f5050c1" alt="Mensaje de cupón de Meta que etiqueta el código promocional, el descuento, el botón para copiar el código y el botón de respuesta rápida." style={{ width: "100%", height: "auto", margin: 0 }} width="546" height="739" data-path="product-assets/whatsapp-platform-2026-09-22/meta-coupon-code-components.png" />
  </div>
</Frame>

Fuente: [Ejemplo oficial de Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/coupon-templates/).

## Haz que la oferta sea comprensible

Incluye el beneficio, dónde se puede usar el código y las condiciones importantes. Por ejemplo:

> Ahorra un 15 % en bolsas de viaje seleccionadas con el código TRAVEL15. Válido hasta el 30 de septiembre en pedidos superiores a \$50. Consulta los artículos válidos y los términos completos en nuestra página de ofertas.

Este es un texto ilustrativo, no una afirmación de que todas las promociones o productos sean aptos.

Decide si el código es compartido, de un solo uso o específico para cada cliente. Tu sistema de promociones, no WhatsApp, es el que aplica el pedido mínimo, los productos aptos, el límite de canjes y la fecha de caducidad.

## Configura la plantilla

1. Selecciona la WABA correspondiente y una plantilla de **Marketing** .
2. Escribe el cuerpo del mensaje y proporciona ejemplos realistas para las variables.
3. Añade el botón admitido para copiar el código.
4. Añade un destino o instrucciones que expliquen dónde canjear la oferta.
5. Envía la plantilla y espera su aprobación.

La plantilla define el botón y el ejemplo de revisión. La solicitud de envío proporciona el código promocional real. Si el cuerpo también muestra el código, proporciona el mismo valor en ambos lugares.

Para el envío mediante API, el botón utiliza el subtipo `copy_code` con un parámetro de tipo `coupon_code`. Esto difiere del comportamiento de envío especial de los botones OTP en las plantillas de autenticación.

Ejemplo de un **componente de botón solo en el momento del envío**:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "type": "button",
  "sub_type": "copy_code",
  "index": 0,
  "parameters": [
    { "type": "coupon_code", "coupon_code": "TRAVEL15" }
  ]
}
```

Utiliza la posición real del botón basada en cero; `0` representa el primer botón. Este fragmento no incluye el envoltorio obligatorio del mensaje ni ningún parámetro del cuerpo.

<a id="limitations" />

## Límites y comportamiento del cliente

La documentación actual de Meta sobre plantillas de cupones especifica un botón para copiar el código, una etiqueta de botón controlada por el sistema y un máximo de 20 caracteres para el código de ejemplo. El campo OpenAPI de YCloud no declara un límite máximo propio de longitud de código; si tu editor aplica un límite inferior, utiliza ese límite admitido y confirma cualquier discrepancia antes del envío.

Meta también documenta que este formato no es compatible con el cliente web de WhatsApp. Prueba la experiencia en el teléfono; no apruebes el diseño basándote únicamente en una conversación de escritorio.

Utiliza un código corto y sin ambigüedades. Evita exponer credenciales de cuenta, códigos de autenticación o información personal como códigos promocionales.

## Prueba el canje, no solo el copiado

Comprueba que el valor copiado coincida con el cuerpo, que la página de ofertas lo acepte, que los carritos aptos y no aptos se comporten correctamente y que los códigos caducados o ya utilizados se rechacen de forma adecuada.

Supervisa la entrega del mensaje y el canje real por separado. La interacción con el botón de copiado no es una prueba de compra.

Continúa con [Plantillas de marketing](/es/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates), [Administrar plantillas](/es/api-reference/guides/whatsapp-platform/manage-whatsapp-templates) y [Enviar mensajes de WhatsApp](/es/api-reference/guides/whatsapp-platform/send-whatsapp-message).

Fuente: [Plantillas de código de cupón de Meta](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/coupon-templates/).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.