Ejecución de una verificación masiva de WhatsApp desde un archivo
Cómo realizar una verificación masiva de WhatsApp desde un archivo TXT o CSV: prepare la lista, elija el producto, siga la tarea y descargue el resultado.
Una guía paso a paso sobre las tareas asíncronas de verificación masiva de WhatsApp y cómo se diferencian de las verificaciones en tiempo real.
Una verificación masiva de WhatsApp desde un archivo es una tarea asíncrona: usted sube una lista en formato TXT o CSV, recibe una tarea que puede rastrear, espera mientras se procesa y descarga un archivo de resultados cuando finaliza. Utilice este método cuando la lista sea mucho más extensa de lo que debería procesar una solicitud en tiempo real. Para números individuales o grupos pequeños que requieren una respuesta inmediata, utilice una verificación en tiempo real.
Cuándo es adecuada la verificación masiva mediante archivo
Las verificaciones en tiempo real responden dentro de la misma solicitud que realiza la consulta. Esto es ideal para un formulario de registro, un activador de CRM o un grupo pequeño copiado. Una verificación masiva mediante archivo se ajusta a la situación opuesta: una lista exportada, una base de datos adquirida o heredada, o una limpieza periódica de toda una tabla de contactos.
La diferencia práctica radica en el flujo de trabajo, no en la pregunta realizada. Con el tiempo real, usted obtiene los resultados inmediatamente en la respuesta. Con el método masivo, usted envía la solicitud una vez, la tarea se procesa por separado y usted regresa para obtener la salida. Planifique las verificaciones masivas como un trabajo programado, no como algo que una persona deba esperar frente a una pantalla.
Existen cuatro productos masivos, cada uno limitado a una señal específica:
| Producto masivo | Señal que cubre |
|---|---|
| Registro | Si el número tenía una cuenta de WhatsApp en el momento de la verificación |
| Avatar | Si hay un avatar disponible para la cuenta |
| Cuenta de empresa | Si la cuenta es de tipo empresa |
| Días de actividad | Días transcurridos desde la última actividad |
Cada producto tiene sus propios límites por archivo, por lo que debe leer la documentación de la API actual antes de dimensionar una ejecución. No asuma que los límites de un producto se aplican a otro.
Prepare el archivo antes de subirlo
La mayoría de las ejecuciones masivas fallidas o ineficientes se deben al archivo de entrada. Siga esta lista primero:
- Formato. Utilice un archivo TXT o CSV con un número por línea. No se aceptan formatos de hoja de cálculo como XLSX, por lo que debe exportar a CSV.
- Formato internacional. Proporcione cada número con su código de país, sin espacios, paréntesis ni guiones. Los números con formato local sin el código de país no pueden interpretarse de manera fiable.
- Un país por archivo. La lista debe corresponder esencialmente al país que usted seleccione. Un archivo con una proporción sustancial de números de otros países será rechazado en la preverificación, así que divida las listas mixtas por país primero.
- Eliminación de duplicados. Las filas repetidas se cobran igual que cualquier otra, por lo que debe eliminarlas de antemano.
- Verifique el soporte regional. Las tareas masivas mediante archivo no cubren números de China continental, Hong Kong o Macau. Esas regiones solo cuentan con soporte limitado para verificaciones individuales en tiempo real.
- Consentimiento. Confirme que dispone de una base legítima para contactar a estas personas antes de utilizar el archivo para cualquier tipo de difusión.
El rechazo en una preverificación es una advertencia temprana útil. Le cuesta unos pocos minutos, no una ejecución finalizada con un archivo incorrecto.
Envíe la tarea y siga su estado
Puede enviar una tarea masiva desde el panel de control o a través de la API. El flujo de la API utiliza POST /api/v1/bulk-tasks para crear la tarea y GET /api/v1/bulk-tasks/{id} para leer su estado. El panel de control también enumera sus tareas masivas y su estado, lo cual es conveniente cuando una persona, y no un script, ejecuta el trabajo.
Una rutina sensata es:
- Elija el producto masivo que coincida con la señal que necesita.
- Suba el archivo preparado y envíelo.
- Conserve la referencia de la tarea devuelta al momento del envío.
- Consulte el estado en intervalos moderados, o revise el panel de control, en lugar de saturar el endpoint. La documentación de la API describe los controles de concurrencia y tiempo de espera; consúltela para conocer las reglas de uso actuales.
- Descargue el archivo de resultados cuando la tarea haya finalizado.
El saldo se reserva al momento del envío. Tras el procesamiento, la parte no utilizada de la reserva regresa al saldo de su cuenta, y una tarea fallida libera la reserva completa. Esto es una conciliación de facturación, no un programa de reembolso para verificaciones ordinarias. Los resultados completados se cobran independientemente de si un número está registrado o no.
Lea el archivo de resultados correctamente
El archivo de resultados descargable es un archivo CSV con una fila por cada número procesado. Considere cada fila como una señal en el momento de la ejecución:
- Un resultado Registrado significa que existía una cuenta en el momento de la verificación.
- Un valor de avatar o de empresa complementa al registro. La ausencia de un avatar no significa que el número no esté registrado, y una etiqueta de empresa identifica el tipo de cuenta en lugar de una empresa verificada.
- Los números que no pudieron ser determinados deben ser reintentados en una ejecución posterior en lugar de ser tratados como No registrado.
Cargue el archivo de nuevo en su CRM o herramienta de marketing, vincúlelo mediante el número de teléfono y almacene la fecha de verificación junto al resultado. Los segmentos se convierten entonces en filtros simples: números registrados a la cola de WhatsApp, otros a canales diferentes.
Mezcla de verificaciones masivas y en tiempo real en un flujo de trabajo
La mayoría de los equipos terminan utilizando ambos métodos. Ejecute una tarea masiva para limpiar la base de datos existente una vez, y luego utilice verificaciones en tiempo real para cada nuevo contacto que llegue posteriormente. Esto mantiene la lista actualizada sin repetir trabajos grandes. Ambos consumen el mismo saldo de cuenta, por lo que una recarga cubre el panel de control, la API y las tareas masivas. Consulte la página de precios para conocer los detalles del plan y el saldo actual.
Preguntas frecuentes
¿Cómo pueden los equipos enviar una verificación masiva de WhatsApp?
Suba un archivo TXT o CSV preparado desde el panel de control o cree una tarea a través de la API, luego siga el estado de la tarea y descargue el archivo de resultados cuando esté completo.
¿Por qué podría ser rechazado un archivo masivo en la preverificación?
Un archivo puede ser rechazado cuando una gran parte de sus números pertenecen a un país diferente al seleccionado, o cuando los números carecen de códigos de país. Dividir la lista por país antes de subirla evita esto.
¿Qué sucede con el saldo reservado no utilizado después de una tarea masiva?
El saldo se reserva al momento del envío. Cualquier parte no utilizada regresa al saldo de la cuenta después del procesamiento, y una tarea fallida libera la reserva completa.
¿En qué se diferencia una verificación masiva de una verificación en tiempo real?
Una verificación en tiempo real devuelve su respuesta en la misma solicitud. Una verificación masiva devuelve primero una tarea, procesa el archivo por separado y entrega un archivo de resultados descargable más tarde.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.