Guía de producto
Cómo gestionar los límites de verificación de la API de WhatsApp Business
Aprenda a operar dentro de los límites de verificación de la API de WhatsApp Business y a usar verificaciones de registro en tiempo real para mantener una calidad alta.
Descubra cómo las empresas pueden utilizar la API de WhatsApp Business antes de completar la verificación de Meta, gestionar los límites de mensajería iniciales y proteger su calificación de calidad mediante la verificación síncrona de contactos.
Las empresas pueden conectarse a la API de WhatsApp Business y empezar a enviar mensajes de inmediato sin esperar a que concluya la verificación empresarial de Meta. Durante esta etapa preliminar, las organizaciones operan dentro de los límites de mensajería iniciales, que normalmente restringen el alcance saliente a 250 contactos únicos iniciados por la empresa en una ventana móvil de 24 horas. La verificación empresarial de Meta se ejecuta de forma asíncrona en segundo plano. Como la progresión de nivel de mensajería y la situación de la cuenta dependen de mantener una alta calificación de calidad, las organizaciones deben priorizar la higiene de los datos de contacto y verificar la alcanzabilidad en la plataforma antes de enviar campañas.
El camino hacia el acceso a la API de WhatsApp Business
Muchos equipos suponen que la verificación empresarial completa de Meta debe finalizar antes de enviar una sola notificación de WhatsApp o una respuesta de atención al cliente. En la práctica, la verificación empresarial de Meta es un proceso asíncrono que se ejecuta de forma independiente en segundo plano mientras avanza la incorporación técnica. Las organizaciones pueden conectar sus números de teléfono a la API de WhatsApp Business mediante flujos de registro integrados o una incorporación directa por API. Una vez conectados, las capacidades de mensajería se activan de inmediato para pruebas iniciales, programas piloto internos y comunicaciones de producción de bajo volumen. Esta incorporación inmediata permite a los responsables técnicos y a los equipos de producto integrar webhooks, configurar plantillas de mensajes y probar los sistemas operativos sin esperar días o semanas a que concluya la revisión de la documentación corporativa.
Cómo funcionan los límites de mensajería iniciales y la progresión de niveles
Operar antes de la verificación formal sitúa a la cuenta en el nivel de mensajería inicial. En este nivel, los mensajes iniciados por la empresa —como notificaciones transaccionales, avisos de citas y contactos proactivos— están limitados a 250 números de teléfono de destinatarios únicos en cualquier ventana móvil de 24 horas.
| Etapa operativa | Límite de mensajería | Criterios de ampliación |
|---|---|---|
| Inicial (sin verificar) | 250 destinatarios únicos / 24 horas | Finalización de la verificación empresarial de Meta |
| Nivel 1 (verificado) | 1000 destinatarios únicos / 24 horas | Alta calificación de calidad + alcanzar los umbrales de volumen |
| Nivel 2 (verificado) | 10 000 destinatarios únicos / 24 horas | Alta calificación de calidad + alcanzar los umbrales de volumen |
| Nivel 3 (verificado) | 100 000 destinatarios únicos / 24 horas | Alta calificación de calidad + alcanzar los umbrales de volumen |
| Nivel 4 (verificado) | Destinatarios ilimitados / 24 horas | Alta calificación de calidad sostenida a gran escala |
Superar el nivel inicial requiere dos elementos: la verificación empresarial completada y un historial activo de mensajería de calidad. Cuando una cuenta envía de forma constante cerca de su cuota diaria manteniendo una alta calificación de calidad, Meta aumenta automáticamente el límite diario. Si los destinatarios denuncian, bloquean o eliminan con frecuencia las plantillas recibidas, la calificación de calidad de la cuenta baja, lo que puede frenar la progresión del límite o marcar el número de teléfono para una revisión administrativa.
Priorizar la higiene de datos antes de la verificación
Como el nivel inicial solo ofrece 250 envíos salientes diarios, la higiene de los datos de los destinatarios influye directamente en el éxito de la incorporación. Intentar enviar mensajes a teléfonos fijos, líneas móviles desactivadas o números sin cuenta de WhatsApp desperdicia la limitada asignación de volumen diario y perjudica las métricas de entrega. Incorporar una verificación de registro de WhatsApp dedicada ayuda a los equipos a auditar las listas de contactos antes de iniciar el envío de mensajes. Una verificación de registro examina un número de teléfono enviado para confirmar si existe una cuenta en la plataforma en ese preciso momento. Evaluar el registro proporciona una señal de presencia de cuenta en el momento de la verificación. Informa a los sistemas de si un número de destinatario puede recibir contenidos de WhatsApp.
Integración de flujos de verificación en tiempo real
Los equipos técnicos pueden incorporar verificaciones de registro directamente en las canalizaciones de ingesta del CRM, los formularios de registro y las colas de envío de mensajes mediante la API REST de WA Lookup. Las verificaciones se ejecutan de forma síncrona y devuelven datos inmediatos de presencia de cuenta dentro de la conexión HTTP inicial, sin necesidad de colas de tareas, rutinas de sondeo ni webhooks asíncronos. Las solicitudes se envían a POST /api/v1/check con la cabecera X-API-Key, Content-Type: application/json y un cuerpo JSON que especifica el identificador de destino y el tipo de verificación del servicio:
ws: el WhatsApp Checker principal indica si el número de teléfono E.164 enviado está registrado en WhatsApp.ws_avatar: examina el registro en WhatsApp a la vez que verifica la disponibilidad del avatar y devuelve una URL del avatar cuando existe (el campo de URL puede devolverse vacío si no hay ninguna imagen pública configurada).ws_business: evalúa el registro e indica si la cuenta está configurada como perfil de WhatsApp Business.
Todos los números enviados deben seguir estrictamente el formato estándar E.164. La API entrega un envoltorio de respuesta completado que contiene code, msg y un objeto data que incluye service_type, identifier y el campo booleano registered. Si no se puede decidir una verificación, el servicio devuelve un código de negocio distinto de cero en lugar de un resultado incompleto. Para flujos con varios contactos, los equipos pueden evaluar hasta 100 identificadores E.164 en una sola solicitud mediante el endpoint síncrono por lotes, que devuelve juntas las evaluaciones completadas de todo el lote. El comportamiento de uso se rige por los parámetros documentados de concurrencia por usuario y de tiempo de espera; los desarrolladores deben consultar la documentación oficial de la API para conocer los controles vigentes del sistema. Integrar estas verificaciones automatizadas al principio del flujo garantiza que las cuotas iniciales se dediquen exclusivamente a destinos alcanzables.
Preguntas frecuentes
¿Pueden las organizaciones usar la API de WhatsApp Business antes de que termine la verificación de Meta?
Sí. La verificación empresarial de Meta no es un requisito previo para conectar un número de teléfono a la API de WhatsApp Business. Los equipos pueden iniciar pruebas, configurar integraciones y empezar a enviar mensajes salientes de bajo volumen de inmediato, dentro de las restricciones del nivel de mensajería inicial.
¿Qué límites de mensajería se aplican a las cuentas de WhatsApp Business sin verificar?
Las cuentas sin verificar operan con los límites de mensajería iniciales, normalmente restringidos a 250 destinatarios únicos por periodo móvil de 24 horas para las conversaciones iniciadas por la empresa. Las conversaciones de servicio iniciadas por el cliente siguen disponibles para atender las consultas entrantes.
¿Cómo aumentan los niveles de mensajería con el tiempo?
Los límites de mensajería aumentan automáticamente una vez completada la verificación empresarial. La ampliación depende de mantener una calificación de calidad aceptable mientras se alcanzan de forma constante los umbrales de volumen del nivel actual, lo que lleva a Meta a subir la cuenta a niveles diarios superiores.
¿Qué papel desempeña una verificación de registro en la plataforma en los flujos de mensajería?
Ayuda a las organizaciones a filtrar los números no registrados antes del envío, lo que favorece la calificación de calidad del remitente y evita desperdiciar la capacidad de mensajería inicial.
Más información
Elija la información de producto que se ajuste al siguiente paso de su flujo de trabajo.