Cómo realizar una consulta de registro de WhatsApp

Una guía práctica para equipos de negocio y técnicos sobre cómo realizar verificaciones síncronas de registro en WhatsApp con la plataforma WA Lookup, que abarca los flujos de número individual y por lotes.

Una consulta de registro de WhatsApp es una verificación síncrona que confirma si un número de teléfono concreto está asociado actualmente a una cuenta de WhatsApp. Con la plataforma WA Lookup, las organizaciones pueden obtener señales de presencia de cuenta en tiempo real para números individuales o lotes pequeños. Estas verificaciones proporcionan datos inmediatos para orientar los flujos de revisión interna, lo que ayuda a los equipos a segmentar audiencias y priorizar el contacto según el registro actual en la plataforma.

Cómo interpretar las señales de registro de WhatsApp

Cuando las organizaciones procesan listas de contactos, una señal de registro de WhatsApp ofrece un indicador claro de presencia de cuenta en el momento exacto de la verificación. Esta señal confirma que un número de teléfono E.164 enviado está registrado en la plataforma. La plataforma WA Lookup devuelve estos datos de forma síncrona, lo que permite a los equipos integrar el resultado directamente en sus flujos operativos. Es importante delimitar correctamente esta señal dentro de los procesos de negocio. Un resultado de registro informa estrictamente de la presencia de cuenta. Al tratar la señal como una entrada más junto con otras comprobaciones, los equipos pueden organizar mejor sus estrategias de comunicación sin sobrestimar la alcanzabilidad de un contacto determinado.

Cómo realizar una consulta de un número individual

Los equipos pueden verificar números de teléfono individuales con la API REST síncrona de WA Lookup. El contrato de solicitud documentado requiere enviar una solicitud POST /api/v1/check. Esta solicitud debe incluir una cabecera X-API-Key para la autenticación y una carga JSON que contenga el número de teléfono E.164 de destino y un campo service_type. Como la arquitectura es totalmente síncrona, la API devuelve el resultado completado en la respuesta HTTP inicial. El envoltorio externo de la respuesta para una verificación completada incluye code, msg y data. Si no se puede decidir una verificación, la API devuelve un código de negocio distinto de cero en lugar de un objeto de resultado completado.

Verificación de registro estándar

El tipo de servicio ws devuelve el objeto de datos básico. Este incluye service_type, identifier y un campo booleano registered que indica la presencia de cuenta.

Verificación con enriquecimiento de avatar

Seleccionar el tipo de servicio ws_avatar realiza la verificación de registro estándar y añade los campos avatar y avatar_url a la respuesta. El avatar_url puede devolverse como una cadena vacía según la configuración de la cuenta.

Verificación de perfil de empresa

El tipo de servicio ws_business verifica el registro estándar y añade un campo booleano business para indicar si la cuenta utiliza WhatsApp Business.

Procesamiento de consultas por lotes

Para los flujos que requieren mayor capacidad de procesamiento, WA Lookup admite un endpoint síncrono por lotes. Las organizaciones pueden enviar hasta 100 identificadores en una sola solicitud. Esta capacidad está diseñada para ofrecer eficiencia manteniendo el mismo modelo de respuesta en tiempo real que la verificación de número individual. El endpoint por lotes procesa los números E.164 enviados y devuelve el conjunto completo de resultados en una sola respuesta, o falla en su totalidad. Esto elimina la necesidad de arquitecturas asíncronas complejas. Los equipos no necesitan implementar colas de envío de tareas, mecanismos de sondeo ni webhooks de devolución de llamada para obtener sus datos. El diseño síncrono garantiza que los resultados del lote estén disponibles de inmediato para el enrutamiento o la segmentación posteriores.

Acceso a los resultados desde el panel o la API

Las organizaciones pueden utilizar WA Lookup a través de un panel web SaaS o de forma programática mediante la API REST. Ambos métodos de acceso comparten la misma semántica de resultados síncronos y el mismo saldo de cuenta subyacente. El panel web ofrece una interfaz visual para gestionar las claves API, consultar el saldo de la cuenta y analizar el historial de verificaciones. Los equipos pueden acceder a informes por producto, revisar las verificaciones recientes, supervisar el gasto de saldo y observar las tendencias de uso de 7 días. Para el acceso programático, la documentación de la API describe los controles de concurrencia por usuario y de tiempo de espera. La facturación funciona con un modelo de pago por verificación, en el que las verificaciones fallidas o indeterminadas se reembolsan automáticamente.

Integración con clientes de IA compatibles con MCP

Además del acceso estándar mediante la API REST, WA Lookup ofrece un servidor oficial de Model Context Protocol (MCP). Este servidor es accesible en la ruta /mcp del sitio web mediante Streamable HTTP y JSON-RPC. Permite que clientes de IA compatibles con MCP, como Claude Code o Claude Desktop, interactúen directamente con las herramientas de verificación. La integración MCP utiliza la clave API existente del cliente y comparte exactamente los mismos productos, saldo, límites de concurrencia y facturación que la API REST. Expone herramientas concretas al asistente de IA: listar los productos disponibles, verificar un único número E.164, verificar de forma síncrona un lote pequeño de hasta 100 números y consultar el saldo de la cuenta. Al igual que la API estándar, las llamadas MCP son síncronas y en tiempo real, y devuelven señales de presencia de cuenta sin crear tareas asíncronas ni archivos descargables.

Preguntas frecuentes

¿Qué significa un estado «registered»?

Un resultado registrado indica que el número de teléfono E.164 enviado está asociado a una cuenta de WhatsApp en el momento de la verificación. Sirve como señal de presencia de cuenta para orientar los flujos de trabajo internos.

¿Pueden las organizaciones verificar varios números a la vez?

Sí, WA Lookup ofrece un endpoint síncrono por lotes que acepta hasta 100 identificadores en una sola solicitud. Todo el lote se procesa y se devuelve en la misma respuesta HTTP.

¿Cómo pueden los equipos obtener crédito en la cuenta para hacer pruebas?

Las cuentas nuevas pueden ponerse en contacto con el soporte para recibir 100 verificaciones gratuitas, que pueden usarse para probar el servicio y evaluar la API síncrona o las funciones del panel.

¿Existen límites de solicitudes por minuto para la API?

La documentación pública de la API describe controles de concurrencia por usuario y de tiempo de espera, en lugar de un límite estricto de solicitudes por minuto. Los equipos deben consultar la documentación actual de la API para conocer el comportamiento aplicable y las pautas de concurrencia.