Marketing Messages API: cómo migrar tus envíos de marketing antes de octubre de 2027

Actualizado el 28/10/2026

La Marketing Messages API para WhatsApp es la API de Meta dedicada a las plantillas de marketing, antes llamada MM Lite. El 13 de octubre de 2026 Meta anunció que la Cloud API dejará de aceptar mensajes de marketing el 13 de octubre de 2027; las cuentas de mensajes creadas a partir del 13 de abril de 2027 ya nacen sin esa opción. Migrar significa enviar tus plantillas de marketing por el endpoint /marketing_messages, seguir recibiendo respuestas por la Cloud API y enrutar los envíos por categoría.

Qué es la Marketing Messages API

Según la descripción general de Meta, es una API para enviar mensajes de marketing que optimiza la entrega para llegar a las personas con más probabilidad de encontrarlos relevantes. Tiene un esquema técnico similar al de la Cloud API, usa el mismo modelo de cobro y acepta los números y plantillas de marketing que ya tienes.

El nombre cambió en el camino. La documentación anterior hablaba de Marketing Messages Lite API (MM Lite), y ese nombre aún aparece en algunos lugares, como el webhook de estado (marketing_lite) y la configuración del registro insertado (Embedded Signup). Hoy el producto se llama Marketing Messages API for WhatsApp. Su disponibilidad general fue el 19 de noviembre de 2025.

Lo que no hace: recibir mensajes. Meta la describe como una API solo de envío. Las respuestas de los clientes siguen llegando por la Cloud API, al mismo número y por los mismos webhooks.

El cronograma oficial

Fecha	Qué pasa
19/11/2025	Disponibilidad general de la Marketing Messages API
06/04/2026	Las empresas integradas pueden desactivar el marketing en la Cloud API (error 131063)
13/10/2026	Anuncio global del fin del marketing en la Cloud API
13/04/2027	Las cuentas de mensajes creadas desde esta fecha no envían marketing por la Cloud API
13/10/2027	Fin global: enviar marketing por la Cloud API devuelve error

Las cuentas creadas antes del 13/04/2027 pueden seguir enviando marketing por la Cloud API hasta el 13/10/2027. Meta explica que el hito de abril existe para que las empresas nuevas no empiecen por error en el producto anterior. Servicio, autenticación y utilidad siguen en la Cloud API, sin cambios.

¿Quieres probar mientras lees? Crea tu cuenta en Vectalk y envía el primer mensaje por la API oficial. Crear cuenta gratis →

Qué cambia en el código

El endpoint

El envío usa la misma sintaxis de payload y los mismos permisos que la Cloud API. Cambia la ruta:

curl -X POST 'https://graph.facebook.com/<API_VERSION>/<PHONE_NUMBER_ID>/marketing_messages' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "5215512345678",
    "type": "template",
    "template": {
      "name": "buen_fin_2026",
      "language": { "code": "es_MX" }
    },
    "product_policy": "STRICT"
  }'

Lo que deja claro la página de envío:

• Solo acepta plantillas de marketing. Texto libre, autenticación, servicio y utilidad en /marketing_messages devuelven error.
• product_policy. Con CLOUD_API_FALLBACK (predeterminado), si la cuenta no cumplió los requisitos de integración, el mensaje sale por la Cloud API. Con STRICT, no hay respaldo.
• message_activity_sharing. Parámetro opcional que activa o desactiva el envío a Meta de la actividad del mensaje (por ejemplo, lecturas) para optimizar. Si no se envía, vale la configuración de la cuenta.
• BSUID. Desde el 5 de mayo de 2026, el campo recipient acepta el identificador de usuario creado para los nombres de usuario de WhatsApp. Los envíos por BSUID no reciben optimización de entrega.

Los webhooks de estado

La MM API dispara los webhooks de estado habituales (sent, delivered, read). Cuando el mensaje salió por ella, pricing.category y conversation.origin.type llegan como marketing_lite. Si cayó en el respaldo de la Cloud API, llega marketing:

{
  "conversation": { "id": "<CONVERSATION_ID>", "origin": { "type": "marketing_lite" } },
  "pricing": { "billable": true, "pricing_model": "PMP", "category": "marketing_lite" }
}

Meta recomienda guardar, para cada wamid, qué API se usó. Si tu código filtra category === "marketing" en reportes de costo, agrega marketing_lite. El formato general de estos eventos está en estados de mensaje por webhook.

El error 131063 y la desactivación del marketing en la Cloud API

Desde el 6 de abril de 2026, quien completó la integración con la MM API puede bloquear las plantillas de marketing en /messages:

curl -X POST 'https://graph.facebook.com/<API_VERSION>/<WABA_ID>' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{ "disable_marketing_messages_on_cloud_api": true }'

Con esa opción activa, una plantilla de marketing enviada por la Cloud API vuelve con:

{
  "error": {
    "message": "(#131063) Marketing templates disabled for Cloud API",
    "type": "OAuthException",
    "code": 131063
  }
}

Cuidado con el orden. Si la cuenta empezó la integración pero no aceptó los términos de la MM API, el respaldo de /marketing_messages hacia la Cloud API también se rechaza con 131063. Es decir: activar esta opción antes de completar la integración detiene todos tus envíos de marketing. Para revertirlo, envía el mismo campo en false.

Este error será frecuente en 2027. Trata 131063 como señal de que la plantilla llegó al endpoint equivocado, no como falla temporal: no reintentes en el mismo endpoint.

Enrutamiento por categoría: el detalle que rompe integraciones

La migración no es solo cambiar la URL de las campañas. Meta puede reclasificar una plantilla de utilidad como marketing, y la orientación oficial es que los mensajes reclasificados se envíen por la MM API. En la práctica, tu sistema necesita:

1. Mantener un mapa plantilla → categoría actualizado (Meta publicó el 24/09/2026 una guía de enrutamiento de plantillas justamente para eso).
2. Elegir el endpoint por categoría al momento del envío, no por tipo de campaña.
3. Manejar cambios de categoría: si una plantilla pasó a marketing, las próximas llamadas van a /marketing_messages.

Si tienes dudas sobre qué considera marketing Meta, consulta cómo Meta clasifica tu plantilla.

Funciones que solo existen en la MM API

Meta enumera funciones no disponibles para plantillas de marketing en la Cloud API:

• Optimización de entrega. Meta orienta la entrega hacia quien tiene más probabilidad de interactuar. Algunas funciones tienen restricciones geográficas.
• Optimizaciones automáticas de creatividades. Filtros de imagen, extracción de título, formato de texto y más. A nivel de plantilla vienen activadas por defecto; a nivel de cuenta, desde el 21 de abril de 2026, vienen desactivadas y tú decides activarlas.
• Tiempo de vida (TTL) para marketing. Define hasta cuándo Meta intenta entregar, útil para ofertas con hora de vencimiento.
• GIF y otros formatos de medios.
• Métricas. Comparativas con empresas similares, recomendaciones y métricas de conversión fuera de WhatsApp (que exigen el Píxel de Meta o la API de Conversiones; consulta API de Conversiones de Meta para WhatsApp).
• Precio máximo. En beta abierta desde el 1 de octubre de 2026: defines el valor máximo por entrega y Meta cobra ese valor o menos. Los envíos con precio máximo a países no compatibles devuelven el error 131065.

Un detalle operativo: después de crear una plantilla de marketing (o usar una inactiva por más de 7 días), Meta pide esperar 10 minutos antes de enviar, por la sincronización con la cuenta publicitaria.

¿Y el precio?

Meta solo dice que la MM API usa el mismo modelo de cobro que la Cloud API, por mensaje entregado. No publica una tarifa distinta para quien migra. Para destinatarios en Brasil, la tarifa oficial de marketing es de R$ 0,3217 (reales brasileños) por mensaje desde el 1 de octubre de 2026; los demás países siguen la tabla de Meta. Con el precio máximo activado, el cobro pasa a ser el tope que definiste o menos. Para estimar una campaña, consulta cuánto cuesta una campaña en WhatsApp.

Checklist de migración

1. Acepta los términos de la Marketing Messages API.
2. Confirma los requisitos de integración. Meta estima unas dos semanas para la mayoría de las integraciones.
3. Separa el envío por categoría con el mapa de plantillas descrito arriba.
4. Empieza con CLOUD_API_FALLBACK y monitorea pricing.category: si aparece marketing, el respaldo se está usando.
5. Pasa a STRICT cuando todos los envíos salgan como marketing_lite.
6. Ajusta reportes y costos para reconocer marketing_lite.
7. Activa disable_marketing_messages_on_cloud_api solo al final, para detectar con el error 131063 cualquier llamada olvidada a /messages antes del plazo de Meta.
8. Hazlo antes de tu temporada alta. Si tu Black Friday o tu Buen Fin de 2027 caen después del 13 de octubre, ya correrán solo en la MM API.

Para los demás cambios del año, consulta novedades de la API de WhatsApp en 2026.

Cómo funciona con Vectalk

Vectalk es un proxy de la WhatsApp Cloud API oficial: usas los payloads de Meta, pagas a Vectalk y Vectalk paga a Meta. Hoy la documentación de Vectalk describe el envío de plantillas por POST /api/messages, el equivalente a /messages de la Cloud API, que sigue siendo válido para marketing hasta los plazos indicados. Las respuestas de los clientes siguen llegando a los webhooks que registraste. Para empezar, crea tu cuenta en apps.vectalk.com.br/register.

Preguntas frecuentes

¿La Marketing Messages API es lo mismo que MM Lite?

Sí. MM Lite (Marketing Messages Lite API) era el nombre anterior. El producto actual es la Marketing Messages API for WhatsApp, y marketing_lite todavía aparece en los webhooks de estado.

¿Necesito otro número para usar la MM API?

No. Meta indica que se pueden usar los números y las plantillas de marketing existentes. El mismo número envía marketing por la MM API y recibe mensajes por la Cloud API.

¿Las plantillas de utilidad y autenticación también cambian de endpoint?

No. Servicio, autenticación y utilidad siguen en la Cloud API. /marketing_messages rechaza todo lo que no sea plantilla de marketing.

¿Qué pasa si no migro antes del 13/10/2027?

Según la documentación, después de esa fecha el envío de marketing por la Cloud API devuelve error. Si tu cuenta de mensajes se crea a partir del 13/04/2027, eso aplica desde el inicio.

¿Cómo recibo las respuestas de una campaña enviada por la MM API?

Por la Cloud API, en el mismo número comercial y en los mismos webhooks. La MM API solo envía.

---

Fuentes oficiales consultadas el 28/10/2026: Marketing Messages API for WhatsApp: descripción general (actualizada el 13/10/2026), Enviar mensajes de marketing (actualizada el 21/05/2026), Registro de cambios de la Marketing Messages API, Registro de cambios de la plataforma de WhatsApp, Precios de la plataforma de WhatsApp Business (actualizada el 30/09/2026).