Límite de mensajes de la API de WhatsApp: niveles, calidad y cómo subir

Actualizado el 29/10/2026

El límite de mensajes de la API de WhatsApp es la cantidad máxima de usuarios distintos a los que tu empresa puede enviar mensajes fuera de la ventana de atención en un período móvil de 24 horas. Desde el 7 de octubre de 2025 se define por portafolio comercial y lo comparten todos sus números: empieza en 250, sube a 2.000 después de completar una vía de escalamiento (como verificar la empresa) y, a partir de ahí, crece solo a 10.000, 100.000 e ilimitado, siempre que los mensajes tengan buena calidad y uses al menos la mitad del límite en 7 días.

A continuación: qué cuenta en el límite, cómo subir de nivel, cómo entra la calidad en la cuenta y cómo consultar todo por API.

Qué cuenta en el límite y qué no

El límite mide destinatarios únicos, no mensajes. Y solo cuenta a quien recibe un mensaje fuera de la ventana de atención de 24 horas, es decir, los mensajes que la empresa inicia con una plantilla.

Situación	¿Cuenta en el límite?
Plantilla enviada a un cliente que no escribió en las últimas 24 horas	Sí, 1 destinatario
Tres plantillas al mismo cliente en el mismo período de 24 horas	Sí, pero solo 1 destinatario
Respuesta libre a un cliente que escribió hace 2 horas	No
Plantilla enviada como respuesta, con la ventana abierta	No, porque está dentro de la ventana
Intento de envío de una plantilla pausada	No (la API la rechaza sin contarla)

La ventana de atención se explica en el artículo sobre la ventana de 24 horas de WhatsApp. En la práctica, la atención entrante casi no consume límite; quienes chocan con él son las notificaciones en volumen y las campañas.

Los niveles de límite

Nivel	Usuarios únicos en 24 horas	Cómo llegar
Inicial	250	Portafolio recién creado
2.000	2.000	Completar una vía de escalamiento y pasar el análisis de Meta
10.000	10.000	Escalamiento automático
100.000	100.000	Escalamiento automático
Ilimitado	Sin tope	Escalamiento automático

El límite es del portafolio, no del número

Antes de octubre de 2025, cada número tenía su propio límite. Ahora el valor se calcula y se define en el portafolio comercial, y todos sus números comparten la misma cuota. Dos consecuencias:

• Un número nuevo ya nace con el límite del portafolio. No hace falta «calentar» un número desde cero.
• Un número puede consumir toda la cuota. Si el número de cobranza envía a 9.000 clientes en un portafolio con límite de 10.000, quedan 1.000 para el número de ventas en las mismas 24 horas.

En la migración, Meta definió el límite de cada portafolio existente con el mayor límite entre sus números.

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

Cómo pasar de 250 a 2.000

Meta ofrece tres vías de escalamiento. Basta con completar una:

1. Verificar la empresa en el portafolio comercial de Meta.
2. Que un socio verifique la empresa, cuando el registro lo hizo un proveedor que ofrece verificación a cargo del socio.
3. Entregar 2.000 mensajes fuera de la ventana de atención, a destinatarios únicos, en un período móvil de 30 días, usando plantillas de alta calidad.

Completada la vía, Meta analiza la calidad de tus mensajes y aprueba o niega la elegibilidad para el escalamiento automático.

• Aprobado: el límite pasa a 2.000 al instante. Recibes un correo, una alerta para desarrolladores y el webhook business_capability_update con max_daily_conversations_per_business igual al nuevo límite (en webhooks v24.0 o posteriores).
• Negado: el límite sigue igual, y el webhook account_alerts informa el motivo en alert_type.

alert_type	Qué hacer
INCREASED_CAPABILITIES_ELIGIBILITY_DEFERRED	Entregar 2.000 mensajes fuera de la ventana, a destinatarios únicos, en 30 días, con plantillas de alta calidad
INCREASED_CAPABILITIES_ELIGIBILITY_FAILED	La misma vía de los 2.000 mensajes
INCREASED_CAPABILITIES_ELIGIBILITY_NEED_MORE_INFO	Verificar tu identidad en Meta o seguir la vía de los 2.000 mensajes

La verificación de la empresa suele ser la vía más rápida para quien ya tiene su registro y documentación en orden (en Brasil, el CNPJ, el registro nacional de empresas; en otros países, el equivalente local). El paso a paso está en verificación de la empresa en Meta Business.

Escalamiento automático: de 2.000 a ilimitado

A partir de 2.000, Meta sube el límite un nivel a la vez, sin solicitud, cuando se cumplen dos condiciones:

• envías mensajes de alta calidad en todos los números y plantillas del portafolio;
• en los últimos 7 días, usaste al menos la mitad del límite actual.

Con las dos condiciones cumplidas, el aumento ocurre en hasta 6 horas. Para un portafolio en 10.000, eso significa haber enviado a al menos 5.000 usuarios únicos fuera de la ventana en algún momento de la última semana.

Quien quiera llegar a 100.000 para una fecha específica (Black Friday, Buen Fin, vencimiento de facturas, campaña de inscripciones) necesita planificar el crecimiento con anticipación. Cada escalón exige uso real del anterior. La guía de Black Friday y Buen Fin en WhatsApp trae un calendario de envíos pensado para esto.

No confundas el límite con el throughput ni con los límites por usuario

Cuatro mecanismos distintos pueden bloquear un envío. Cada uno tiene su causa y su código de error:

Mecanismo	Qué limita	Valor	Error
Límite de mensajes	Usuarios únicos fuera de la ventana en 24 horas, por portafolio	250 a ilimitado	—
Throughput	Mensajes por segundo, por número	80/s por defecto; hasta 1.000/s con mejora automática	130429
Límite por par	Demasiados mensajes al mismo usuario en poco tiempo	Sin valor publicado	131056
Límite de marketing por usuario	Plantillas de marketing que un usuario recibe de todas las empresas	Dinámico, según la interacción del usuario	131049

La mejora a 1.000 mensajes por segundo exige un portafolio con límite ilimitado, un número que ya haya alcanzado 100.000 usuarios únicos fuera de la ventana en 24 horas y calidad media o alta. Los detalles están en throughput y rate limit en la API de WhatsApp. Para el 131049, Meta recomienda esperar al menos 24 horas antes de reenviar al mismo usuario; los reintentos repetidos dentro de ese plazo pueden bloquear nuevos intentos a ese usuario por hasta 24 horas. El artículo sobre el error 131049 profundiza en el tema.

Calificación de calidad

Meta evalúa la calidad de los mensajes según lo que pasó en los últimos 7 días, con más peso para lo más reciente. Las señales que menciona la documentación son bloqueos, denuncias, silenciamientos, archivados y los motivos que el usuario indica al bloquear.

Hay dos calificaciones que debes seguir:

Calificación	Dónde aparece	Valores
Calidad del número	Campo quality_rating del número y WhatsApp Manager	GREEN (alta), YELLOW (media), RED (baja)
Calidad de la plantilla	Campo quality_score de la plantilla	GREEN, YELLOW, RED, UNKNOWN

Los números con mucho tráfico pueden cambiar de calidad en intervalos cortos, a veces en minutos. El significado de cada color se detalla en calidad del número en la API de WhatsApp.

Qué cambió: la baja calidad ya no reduce el límite

Hasta octubre de 2025, un número con calidad «Flagged» durante 7 días perdía un nivel de límite. Meta eliminó ese estado: hoy, si la calidad del número baja, el límite no se reduce.

Eso no vuelve irrelevante la calidad. Sigue decidiendo tres cosas:

• Si el límite sube. El escalamiento automático exige mensajes de alta calidad en todos los números y plantillas.
• Si la plantilla sigue activa. Una plantilla que llega a RED se pausa 3 horas, luego 6 horas, y la tercera vez se desactiva.
• Si la empresa recibe sanciones. La política de cumplimiento de Meta indica que el exceso de quejas de los usuarios puede llevarla a limitar la empresa o a retirarla de WhatsApp. El artículo sobre número bloqueado en la API de WhatsApp detalla esas medidas.

Qué frena el crecimiento

Los motivos más comunes para que el límite deje de subir, o para que los mensajes dejen de salir, son previsibles:

• Lista sin opt-in. Los contactos que no esperaban el mensaje bloquean y denuncian.
• Mensaje genérico. Meta recomienda evitar mensajes de bienvenida o de presentación abiertos y personalizar el contenido.
• Frecuencia alta. Varias plantillas al día para el mismo contacto bajan la calificación y chocan con el límite por par.
• Público frío en volumen. Enviar a toda la base de una vez, sin probar la reacción de un grupo más pequeño.
• Uso por debajo de la mitad del límite. Sin uso, no hay escalamiento automático.
• Plantilla de marketing clasificada como utilidad. Además de la recategorización, genera restricciones específicas. Consulta la guía de plantillas de la API de WhatsApp.

Cómo consultar límite y calidad por API

En la Graph API, el límite actual del portafolio está en el campo whatsapp_business_manager_messaging_limit, que se puede leer en el portafolio comercial, en la cuenta de WhatsApp Business o en el número. El campo antiguo messaging_limit_tier quedó obsoleto.

curl 'https://graph.facebook.com/v26.0/PHONE_NUMBER_ID?fields=whatsapp_business_manager_messaging_limit' \
  -H 'Authorization: Bearer TOKEN_DE_META'

# Respuesta
{ "whatsapp_business_manager_messaging_limit": "TIER_250", "id": "PHONE_NUMBER_ID" }

En Vectalk, los datos del número vienen de GET /api/phone-numbers, con el número resuelto por el token de instancia. La documentación muestra el parámetro fields y una respuesta con quality_rating y el nivel de throughput:

curl 'https://apis.vectalk.com.br/api/phone-numbers?fields=id,display_phone_number,verified_name,quality_rating' \
  -H 'Authorization: Bearer TU_TOKEN_DE_INSTANCIA'

Para no depender de consultas, maneja los webhooks. Vectalk reenvía los eventos en el formato de Meta:

• business_capability_update: nuevo límite del portafolio en max_daily_conversations_per_business (valores 2000, 10000, 100000 o UNLIMITED);
• phone_number_quality_update: cambios en el estado de calidad del número;
• account_alerts: negativa de escalamiento y próximos pasos;
• message_template_quality_update y message_template_status_update: calificación y pausa de las plantillas.

Cómo planificar un envío dentro del límite

Para envíos en volumen, controla los destinatarios únicos de las últimas 24 horas antes de llamar a la API y pasa el resto al día siguiente. Un esbozo:

const LIMITE = 2000;               // léelo del webhook business_capability_update
const VENTANA_MS = 24 * 60 * 60 * 1000;

async function puedeEnviar(waId) {
  const desde = new Date(Date.now() - VENTANA_MS);
  const yaRecibio = await db.envios.exists({ wa_id: waId, fuera_de_ventana: true, enviado_en: { $gte: desde } });
  if (yaRecibio) return true; // el mismo destinatario no cuenta dos veces
  const unicos = await db.envios.countDistinct("wa_id", { fuera_de_ventana: true, enviado_en: { $gte: desde } });
  return unicos < LIMITE * 0.95; // margen para envíos de otros números del portafolio
}

Recuerda sumar todos los números del portafolio en el conteo. El artículo sobre envío masivo con la API oficial cubre cola, ritmo y segmentación.

Preguntas frecuentes

¿Puedo pedirle a Meta que aumente mi límite manualmente?

La documentación describe solo las vías de escalamiento para llegar a 2.000 y el escalamiento automático a partir de ahí. El camino práctico es verificar la empresa y usar el límite con mensajes bien recibidos.

¿Agregar más números aumenta el límite?

No. El límite es del portafolio y se reparte entre todos los números. Un número nuevo solo pasa a usar la misma cuota.

¿Responder a los clientes consume el límite?

No. El límite cuenta solo a los destinatarios de mensajes fuera de la ventana de atención. Las respuestas dentro de la ventana de 24 horas quedan fuera.

Mi calidad bajó a amarillo. ¿Voy a perder el nivel?

Con la regla actual, no. La baja de calidad no reduce el límite, pero puede impedir nuevos aumentos y llevar a la pausa de plantillas. Revisa público, frecuencia y contenido antes del próximo envío.

Escala tus envíos con Vectalk

Con Vectalk conectas tus números con el registro insertado (Embedded Signup) de Meta y operas todas las cuentas con un token, recibiendo los webhooks de límite y calidad en el formato de la documentación oficial. El cobro funciona con una mensualidad más saldo prepago: Vectalk coloca su propia línea de crédito en tu número, cada mensaje entregado se descuenta del saldo y no registras tarjeta en Meta. También tienes coexistencia con la app WhatsApp Business. Crea tu cuenta en apps.vectalk.com.br/register, consulta la documentación o habla con el equipo en la página de contacto.

---

Fuentes oficiales consultadas el 29/10/2026: Límites de mensajes, Cambios en los límites de mensajes (vigentes desde el 7/10/2025), Calidad de los mensajes, Throughput, Códigos de error, Pausa de plantillas.