Administrar plantillas de WhatsApp

​

Qué es

​

Antes de comenzar

• Conecta la WABA que será propietaria de la plantilla.
• Elige la categoría de la plantilla, el idioma admitido, el nombre y los componentes.
• Prepara ejemplos representativos de variables y contenido multimedia requeridos para la revisión.
• Sigue las políticas de Meta para contenido de autenticación, utilidad y marketing.
• Configura un endpoint de webhook que pueda recibir eventos whatsapp.template.reviewed.

​

Cómo funciona

1. Crea la plantilla en una WABA.
2. Almacena su nombre, idioma, categoría y status actual.
3. Espera la aprobación cuando se requiera revisión.
4. Consulta o lista las plantillas para observar los cambios de estado.
5. Envía únicamente una plantilla que sea válida para el caso de uso objetivo y que esté en un estado listo para envío.
6. Edita o elimina la plantilla cuando cambie su contenido o ciclo de vida.

​

Solicitud

curl --request POST https://api.ycloud.com/v2/whatsapp/templates \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "wabaId": "WABA_ID",
    "name": "order_ready",
    "language": "en_US",
    "category": "UTILITY",
    "components": [
      {
        "type": "BODY",
        "text": "Order {{0}} is ready for pickup.",
        "example": {
          "body_text": [["A-10001"]]
        }
      }
    ]
  }'

​

Respuesta

{
  "wabaId": "WABA_ID",
  "name": "order_ready",
  "language": "en_US",
  "category": "UTILITY",
  "status": "PENDING",
  "components": [
    {
      "type": "BODY",
      "text": "Order {{0}} is ready for pickup."
    }
  ]
}

​

Definir una identidad de recurso estable

• auth_login_otp_v1
• orders_pickup_ready_v2
• growth_summer_offer_v3

​

Elegir la categoría antes de redactar el contenido

​

Fijar el contrato de variables

• Proporciona una muestra segura y representativa para cada variable del cuerpo o encabezado de texto.
• Valida las URL, los formatos y los tamaños de archivo de los encabezados multimedia.
• Mantén el encabezado de texto con un máximo de una variable e incluye su muestra.
• Confirma que las variables de los botones de tipo URL aparezcan únicamente donde la API lo permita e incluye una URL de muestra completa.
• Nunca utilices credenciales, códigos de un solo uso, datos personales ni archivos multimedia privados en los ejemplos de revisión.

​

Organizar las configuraciones regionales como un solo lanzamiento

​

Condicionar los envíos al estado de la plantilla

​

Sincronizar el estado

1. Verifica la firma de cada evento whatsapp.template.reviewed.
2. Deduplica las entregas por el id del evento.
3. Resuelve el recurso mediante wabaId, name y language.
4. Almacena tanto el evento de actualización como el status actual.
5. Detén el enrutamiento de inmediato cuando el estado actual no sea APPROVED.
6. Obtén la plantilla cuando un evento falte, se retrase o entre en conflicto con un estado del registro más reciente.
7. Ejecuta una conciliación de listas paginadas programada para detectar discrepancias.

​

Comportamiento de edición y eliminación

• Edita solo plantillas en un estado admitido por el endpoint.
• Incluye el conjunto completo de componentes deseados en una solicitud de edición.
• Eliminar por nombre borra todos los idiomas asociados a ese nombre.
• Eliminar por nombre e idioma borra únicamente esa plantilla localizada.
• Las plantillas archivadas aún pueden aparecer en los resultados de listado y obtención.

​

Publicar, revertir y retirar versiones

1. Crea un nuevo nombre versionado para cada configuración regional requerida. Mantén sin cambios la versión aprobada actual.
2. Espera hasta que cada configuración regional de destino esté en APPROVED y luego valida sus variables, archivos multimedia, botones, categoría y contenido renderizado.
3. Enruta una proporción controlada de envíos aptos a la nueva versión y supervisa la entrega, la calidad, las respuestas y las actualizaciones de estado.
4. Transfiere el tráfico restante únicamente después de que la nueva versión cumpla con tus criterios de despliegue.

​

Límites y resolución de problemas

• Una solicitud de envío falla cuando la plantilla no está aprobada o sus componentes no coinciden con los parámetros del mensaje.
• Las plantillas de autenticación utilizan estructuras predefinidas restringidas.
• La categoría y el contenido de la plantilla deben alinearse con las políticas de Meta.
• Revisa los detalles del rechazo antes de volver a crear el mismo contenido.
• Utiliza un nuevo nombre cuando una plantilla eliminada o modificada sustancialmente no se pueda restaurar de forma segura.

​

Lista de verificación para la puesta en marcha

• Se han registrado el nombre, el propósito, el propietario, la categoría y la versión.
• Cada variable tiene un único significado, formato, ejemplo seguro y regla de respaldo.
• Los archivos multimedia y los botones superan las validaciones de formato, destino y ejemplos.
• Cada configuración regional requerida se encuentra de forma independiente en APPROVED.
• La ruta de envío rechaza cualquier estado distinto de APPROVED.
• El procesamiento de Webhooks está verificado, es idempotente y se concilia con la obtención.
• El despliegue puede restaurar una versión aprobada anterior.
• Las colas, campañas, configuraciones, pruebas y guías operativas utilizan la versión prevista.