Plantillas de mensajes de WhatsApp API: Términos clave y mecánicas explicadas

• Las plantillas son activos de la Cuenta de la API de WhatsApp Business que las empresas utilizan para enviar mensajes estructurados a través de la API de WhatsApp.
• Los mensajes de plantilla son el único tipo de mensaje que puede enviarse a los usuarios de WhatsApp fuera de una ventana de servicio al cliente.
• Las plantillas se utilizan comúnmente para mensajes masivos, campañas, alertas, recordatorios, OTPs y seguimientos cuando no hay una ventana de servicio al cliente activa.

Creación

Abre YCloud Console → WhatsApp Manager → Plantilla → Nueva Plantilla

• La categoría indica a WhatsApp si la plantilla es de Marketing, Utilidad o Autenticación.
• Los componentes definen lo que contiene la plantilla, como encabezado, cuerpo, pie de página, botones, variables o medios.

Puedes crear hasta 100 plantillas por cuenta de WhatsApp Business por hora.

Sintaxis común de la API

curl 'https://graph.facebook.com/v23.0/<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '
{
  "name": "<NAME>",
  "category": "<CATEGORY>",
  "language": "<LANGUAGE>",
  "parameter_format": "<PARAMETER_FORMAT>",
  "components": [<COMPONENTS>]
}'

Nombres

• order_update en inglés
• order_update en hindi
• order_update en español

• Letras minúsculas
• Caracteres alfanuméricos
• Guiones bajos

• order_confirmation
• payment_reminder
• login_otp
• cart_recovery_offer

• Order Confirmation
• Payment-Reminder
• Login OTP!

Categorías

• Marketing
• Utilidad
• Autenticación

• Marketing se utiliza para promociones, ofertas, actualizaciones de productos, retargeting y reconexión con clientes.
• Utilidad se utiliza para actualizaciones no promocionales como confirmaciones de pedido, recordatorios de pago, alertas de entrega, actualizaciones de cuenta y seguimientos de soporte.
• Autenticación se utiliza para OTPs, códigos de inicio de sesión, recuperación de cuentas y verificación de identidad.

Read this One-Stop Guide to WhatsApp API Message Template Categories to know about WhatsApp API Message Template in detail.

• Aprobación de plantillas
• Restricciones de mensajes
• Precios
• Revisión de categoría
• Recategorización futura por parte de WhatsApp

Componentes

• Encabezado — texto, imagen, video, documento o ubicación que se muestra en la parte superior del mensaje.
• Cuerpo — el texto principal del mensaje. Aquí es donde se utilizan la mayoría de las variables y los detalles específicos del cliente.
• Pie de página — texto de apoyo breve, generalmente utilizado para descargos de responsabilidad o contexto adicional.
• Botones — acciones clicables como visitar un sitio web, llamar a un número, copiar un OTP o respuestas rápidas.

Idiomas

• en_US para inglés
• hi para hindi
• es para español
• pt_BR para portugués brasileño

• order_update en inglés
• order_update en hindi
• order_update en español

Formatos de Parámetros

• Aquí, {{first_name}} y {{order_number}} son parámetros.

• Elegir un formato de parámetro: Nombrados o Posicionales
• Agregar valores de ejemplo para cada parámetro
• Pasar valores reales en la carga útil del mensaje de envío más adelante

Parámetros Nombrados

• Debe ser único
• Usar letras minúsculas y guiones bajos
• Envuelto entre llaves dobles
• Los valores se pueden enviar en cualquier orden porque cada parámetro tiene un nombre

Thank you, {{first_name}}! Your order number is {{order_number}}.

[
  {
    "type": "text",
    "parameter_name": "first_name",
    "text": "Jessica"
  },
  {
    "type": "text",
    "parameter_name": "order_number",
    "text": "SKBUP2-4CPIG9"
  }
]

Parámetros Posicionales

• Debe comenzar desde {{1}}
• Debe seguir el mismo orden que el texto plantilla
• Los valores deben enviarse en la misma secuencia

Hi {{1}}! Your order number is {{2}}. Thank you.

[
  {
    "type": "text",
    "text": "Jessica"
  },
  {
    "type": "text",
    "text": "SKBUP2-4CPIG9"
  }
]

Parámetros Nombrados vs Posicionales

Medios

• Imagen del producto
• Banner de oferta
• PDF de factura
• Documento de ticket o reserva
• Vista previa de video

Revisión de Plantillas

• Si la categoría seleccionada es correcta
• Si el mensaje sigue las pautas de plantillas
• Si las variables y ejemplos son claros
• Si el contenido coincide con el caso de uso empresarial
• Si los medios, botones y componentes son válidos

Know How WhatsApp Assigns a Category During Template Creation

Estado de la Plantilla

• Aprobado — la plantilla aprobó la revisión y se puede usar.
• Pendiente — la plantilla aún está en revisión.
• Rechazado — la plantilla no aprobó la revisión y no se puede usar.
• Pausado — la plantilla está temporalmente detenida debido a problemas de calidad.
• Deshabilitado — la plantilla ya no se puede usar.

Ejemplo de Solicitud

curl 'https://graph.facebook.com/<API_VERSION>/<TEMPLATE_ID>?fields=status' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'

Ejemplo de Respuesta

{
  "status": "APPROVED",
  "id": "1259544702043867"
}

WhatsApp Manager

A continuación, veamos los límites de plantillas y cuántas plantillas de mensajes de WhatsApp API puede crear tu negocio.

Límites de Plantillas

• Límites de mensajería — controlan cuántos mensajes de plantilla puedes enviar fuera de la ventana de servicio al cliente.
• Pacing de plantillas — ralentiza la entrega para que los usuarios de WhatsApp puedan dar retroalimentación antes de que la plantilla se amplíe.
• Pausa de plantillas — detiene temporalmente las plantillas que reciben retroalimentación negativa o baja participación.
• Archivado de plantillas — archiva y elimina plantillas inactivas por 12 meses o más. Las plantillas archivadas se eliminan después de 28 días a menos que se restauren.
• Límites de plantillas de marketing por usuario — restringen cuántos mensajes de plantillas de marketing puede recibir un usuario de WhatsApp de las empresas.

Tiempo de Vida

"message_send_ttl_seconds": 900

"message_send_ttl_seconds": -1

¿Qué sucede cuando expira el TTL?

TTL y actualizaciones de categoría

Calificación de calidad

Ejemplo de Solicitud

curl 'https://graph.facebook.com/v25.0/<TEMPLATE_ID>?fields=quality_score' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'

Ejemplo de Respuesta

{
  "quality_score": {
    "score": "GREEN",
    "date": 1758754645
  },
  "id": "1387372356726668"
}

Secuencia de Entrega de Múltiples Mensajes

1. Orden confirmada
2. Pago recibido
3. Entrega programada

• Flujos OTP
• Procesos de pago
• Actualizaciones de pedidos
• Onboarding paso a paso
• Campañas multimensaje
• Automatización de soporte al cliente

Gestión de Plantillas

• Solo Aprobadas, Rechazadas o Pausadas las plantillas pueden editarse.
• Las plantillas aprobadas pueden editarse hasta 10 veces en 30 días o una vez en 24 horas.
• No puedes editar componentes individuales. Si editas componentes, el conjunto completo de componentes se reemplaza.
• Si eliminas una plantilla aprobada, no puedes crear otra plantilla con el mismo nombre durante 30 días.
• Las plantillas inactivas por 12 meses o más pueden ser archivadas y programadas para su eliminación después de 28 días.

Crea plantillas de WhatsApp API más rápido con YCloud AI

• Promociones
• Actualizaciones de pedidos
• Recordatorios de pago
• OTPs
• Seguimientos de soporte
• Campañas de reactivación

¿Cómo obtener YCloud?

¿Cómo obtener YCloud GRATIS?

¡Conclusión!