Verificación masiva de números en Telegram: Cómo verificar una lista grande para ver si está registrada
Aprenda a realizar una verificación masiva en Telegram: prepare un TXT o CSV, elija el país, envíe una tarea tg_batch, consulte el estado y lea result.csv.
Una guía paso a paso para verificar el registro en Telegram de una lista extensa de números de teléfono mediante una tarea asíncrona tg_batch, desde la preparación del archivo hasta la obtención del archivo result.csv.
Una verificación masiva de números en Telegram es una tarea asíncrona: usted carga un archivo TXT o CSV con un número de teléfono por línea, elige el país y el servicio tg_batch, espera a que la tarea finalice y luego descarga un único archivo result.csv. Este archivo le indica si cada número estaba registrado en Telegram en el momento de la verificación, lo que ayuda a su equipo a decidir qué registros conservar en una lista de difusión de Telegram. Telegram no ofrece una búsqueda masiva oficial, por lo que las listas grandes requieren un servicio de verificación dedicado en lugar de copiar y pegar lotes.
Cuándo es la tarea masiva la herramienta adecuada
Las verificaciones en tiempo real devuelven un resultado en la misma sesión, lo cual es adecuado para un solo número o un lote pequeño copiado y pegado. Una vez que una lista es mucho más grande de lo que una sola solicitud puede procesar, una tarea asíncrona es la mejor opción: usted entrega el archivo, el trabajo se ejecuta en segundo plano y usted recopila el resultado posteriormente.
| Situación | Opción más adecuada |
|---|---|
| Un número durante el envío de un formulario o chat de soporte | Verificación individual en tiempo real |
| Una lista corta copiada y pegada revisada en pantalla | Verificación de lote en tiempo real en el panel o el endpoint de lotes |
| Una exportación completa de CRM o un archivo de leads adquirido | Tarea masiva asíncrona con tg_batch |
Los límites por producto para cada ruta se enumeran en la documentación de la API actual, por lo que debe consultarlos antes de planificar una ejecución grande.
Prepare el archivo para una verificación masiva de números en Telegram
La mayoría de las tareas fallidas o rechazadas se deben al archivo de entrada. Antes de cargarlo:
- Utilice un archivo TXT o CSV simple con un número de teléfono por línea. No se aceptan formatos de hoja de cálculo como XLSX, por lo que debe exportar primero a CSV.
- Escriba cada número con su código de país internacional.
- Elija un país para la tarea. Las tareas masivas de números de teléfono están diseñadas en torno a un único país seleccionado, y un archivo que contenga mayoritariamente números de otros códigos de país puede ser rechazado. Divida las listas mixtas por país y envíe una tarea por cada uno.
- Elimine los duplicados evidentes y las líneas en blanco para no pagar por verificar el mismo número dos veces.
- Mantenga los números de China continental, Hong Kong y Macao fuera del archivo: las tareas masivas asíncronas no cubren esas regiones.
Si no está seguro del formato, lea la guía sobre ITU-T Recommendation E.164 antes de normalizar la lista.
Envíe la tarea tg_batch y espere
El servicio masivo exclusivo de registro se denomina tg_batch. En el panel, usted elige la opción de Verificación masiva, carga el archivo y selecciona el país y el servicio. A través de la API, la tarea se crea con POST /api/v1/bulk-tasks y su estado se consulta con GET /api/v1/bulk-tasks/{id}.
Vale la pena planificar tres comportamientos:
- El saldo se reserva al momento del envío. La plataforma retiene el saldo de todo el archivo por adelantado, cobra por las entradas que devolvieron resultados y libera la reserva no utilizada cuando la tarea se completa. Si una tarea falla, se libera la reserva completa.
- No hay progreso por número. Una tarea informa los estados de procesamiento, éxito o fallo, por lo que debe estructurar su flujo de trabajo en torno a esos tres estados en lugar de una barra de progreso.
- Consulte el estado con moderación. Verifique el estado de la tarea con una frecuencia no mayor a 30 segundos. Consultar más rápido aumenta la carga sin producir resultados más pronto.
El tiempo de finalización depende del archivo, por lo que debe evitar prometer a las partes interesadas un tiempo de entrega fijo.
Lea result.csv y actúe en consecuencia
Una tarea finalizada le proporciona un archivo result.csv descargable. Para tg_batch, este contiene el número enviado y una columna que indica si estaba registrado. Considere esa columna como una señal de presencia de cuenta en Telegram en el momento de la verificación.
Una forma práctica de utilizarlo:
- Registrado: manténgalo en el segmento de Telegram de su lista de difusión.
- No registrado: diríjalo a otro canal o exclúyalo de las campañas de Telegram.
- Filas faltantes o vacías: vuelva a enviarlas en una tarea posterior más pequeña o revíselas manualmente.
El registro no demuestra que una persona esté activa, que el número pertenezca al contacto que usted espera o que hayan dado su consentimiento para recibir mensajes. Si también necesita una señal aproximada de recencia, un servicio masivo diferente, tg_active_batch, devuelve columnas adicionales; mantenga la salida de cada servicio por separado en lugar de asumir que todos los archivos tienen las mismas columnas.
Errores comunes en las verificaciones de listas grandes
- Cargar un archivo de varios países y dejar que el rechazo le enseñe la regla.
- Enviar antes de eliminar duplicados, lo que infla el saldo reservado.
- Consultar el estado cada pocos segundos en un bucle.
- Tratar el registro como una prueba de consentimiento o identidad.
- Volver a ejecutar todo el archivo para corregir unas pocas filas en lugar de enviar solo los elementos restantes.
Para obtener detalles sobre la facturación, consulte la página de precios actual y la documentación de la API en lugar de confiar en las cifras citadas en artículos.
Preguntas frecuentes
¿Puede un equipo verificar una lista de Telegram sin tener su propia cuenta de Telegram?
Sí. Los equipos envían el archivo a un servicio de verificación a través del panel o la API REST y descargan el archivo result.csv, por lo que no se necesita un inicio de sesión personal en Telegram para la verificación.
¿Cómo pueden los equipos gestionar una lista que contiene varios países?
Divida el archivo por país y envíe una tarea tg_batch para cada uno, ya que las tareas masivas de números de teléfono están vinculadas a un país seleccionado.
¿Cómo funciona el saldo para una tarea masiva?
El saldo se reserva cuando se envía la tarea, se cobra por las entradas que devolvieron resultados y se libera el remanente no utilizado. Una tarea fallida libera su reserva completa.
¿Un resultado Registrado significa que el contacto responderá?
No.
Más información
Elija la información del producto que se ajuste al siguiente paso en su flujo de trabajo.