Plantillas WhatsApp API: crear, listar y enviar por API

Las plantillas pertenecen a la WABA y tienen un ciclo de revisión/calidad independiente de tu código. Una aplicación debe tratar nombre + idioma + categoría + estructura como datos administrables, no como strings dispersos por el backend.

Listar plantillas

GET https://graph.facebook.com/{VERSION}/{WABA_ID}/message_templates
Authorization: Bearer {ACCESS_TOKEN}

Crear una plantilla

POST https://graph.facebook.com/{VERSION}/{WABA_ID}/message_templates
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json

{
  "name": "confirmacion_cita",
  "language": "es",
  "category": "UTILITY",
  "components": [
    {"type": "BODY", "text": "Tu cita está confirmada para {{1}}."}
  ]
}

La categoría del ejemplo debe corresponder al propósito real. No asumas que un nombre “transaccional” convierte automáticamente el contenido en Utility si el cuerpo incluye promoción.

Enviar una plantilla aprobada

POST https://graph.facebook.com/{VERSION}/{PHONE_NUMBER_ID}/messages
Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "573001234567",
  "type": "template",
  "template": {
    "name": "confirmacion_cita",
    "language": {"code": "es"},
    "components": [
      {"type":"body","parameters":[{"type":"text","text":"21 de agosto, 3:00 p. m."}]}
    ]
  }
}

Diseño interno

Crea una tabla/catálogo por WABA con ID externo, nombre, idioma, categoría, status, última sincronización y hash de estructura. Si el administrador cambia una plantilla, sincroniza antes de permitir campañas. Una plantilla pausada/rechazada no debería producir cientos de errores por un job masivo que nunca refrescó estado.

¿Tu empresa no necesita desarrollar esto?

Optimify ya integra la capa empresarial sobre WhatsApp API

Esta sección existe para equipos que realmente quieren construir o integrar. Si la empresa solo necesita CRM, multiagente, campañas, automatización e IA, MensajAPI recomienda comparar el costo de desarrollo y mantenimiento frente a usar Optimify, que ofrece una plataforma lista y soporte en español.

Ver alternativa gestionada con Optimify

Documentación oficial para mantener la integración actualizada

Versionado: los ejemplos usan {VERSION} en lugar de fijar una versión de Graph API. Sustituye esa variable por una versión vigente y soportada en tu aplicación y revisa cambios antes de actualizar producción.

Plantillas de WhatsApp API para desarrolladores