Guía de producto
Cómo verificar en tiempo real el registro en Telegram de un CSV de números de teléfono
Verifique el registro en Telegram de un CSV de números con TG Validator: formato E.164, un número o hasta 100 por solicitud síncrona y límites de concurrencia.
Una guía técnica para verificar en tiempo real el registro en Telegram de un CSV de números de teléfono con TG Validator, centrada en la preparación de datos, los endpoints síncronos individual y múltiple, la gestión de la concurrencia y la interpretación de resultados.
TG Validator verifica el registro en Telegram en tiempo real: envíe un número E.164 a POST /api/v1/check, o hasta 100 números al endpoint múltiple síncrono POST /api/v1/batch-check, y el resultado completado se devuelve en la misma respuesta HTTP. Para verificar un CSV, normalice la columna al formato E.164, envíela a través del endpoint múltiple con hasta 100 identificadores por solicitud y gestione la concurrencia en el lado del cliente según la documentación de la API. Un archivo completo que supere con creces una solicitud en tiempo real también puede subirse como tarea masiva asíncrona.
Cómo preparar sus datos para la verificación
Al procesar un CSV de contactos, el primer paso es normalizar la entrada. TG Validator exige que todos los números de teléfono enviados estén en formato E.164. Este plan internacional de numeración garantiza que cada número sea único a escala mundial; normalmente empieza por un '+' seguido del código de país y del número de abonado. Normalizar la columna de su CSV al formato E.164 antes de iniciar las solicitudes a la API evita errores por números de teléfono no válidos y garantiza que el sistema pueda verificar con precisión el estado de registro en Telegram.
El flujo de trabajo de la API de TG Validator
El modelo principal de TG Validator es de solicitud y respuesta síncronas, tanto para las verificaciones individuales como para las múltiples. Utilice POST /api/v1/check para un número, o el endpoint múltiple síncrono POST /api/v1/batch-check con service_type=tg para hasta 100 identificadores E.164 de un CSV; ambos responden en la misma respuesta HTTP, sin pasos de envío de tareas, consulta periódica ni descarga.
Gestión del rendimiento y de los límites de la API
Procese el CSV con el endpoint múltiple síncrono, hasta 100 identificadores por solicitud, y respete los controles de uso de la API de la plataforma. TG Validator aplica un límite de concurrencia por usuario, así que confirme el valor vigente en la documentación de la API antes de decidir cuántas solicitudes mantiene abiertas su script. Para un archivo completo que supere con creces una solicitud en tiempo real, también está disponible una tarea masiva asíncrona (subir, esperar, descargar); consulte sus límites vigentes en la documentación de la API. Si su script supera estos umbrales, la API devolverá códigos de error específicos que indican que todas las ranuras de concurrencia están ocupadas o que la verificación se quedó sin tiempo. Los rechazos de este tipo no se cobran y no generan ningún resultado de verificación. Implementar un retardo o una cola que limite la concurrencia en su script de procesamiento del CSV garantiza una ejecución fluida sin errores innecesarios.
Cómo interpretar los resultados y gestionar los errores
La API devuelve un sobre de respuesta documentado que contiene code, msg y data. En las verificaciones de Telegram, el campo data.registered proporciona la señal de presencia de cuenta.
En una verificación de Telegram completada, el objeto data devuelto contiene únicamente service_type, identifier y registered; los campos internos de registro, transacción, estado y facturación no se devuelven.
Preguntas frecuentes
¿Qué formato deben tener los números de teléfono para la verificación?
Todos los números de teléfono deben enviarse en formato E.164, que garantiza que cada número sea único a escala mundial al empezar por un '+' seguido del código de país y del número de abonado.
¿Qué ocurre si supero el límite de concurrencia?
Si supera el límite de concurrencia documentado, la API devuelve un código de error. Estos rechazos por límite no se cobran y no generan ningún resultado de verificación.
¿Puedo verificar varios números en una sola solicitud?
Sí. El endpoint múltiple síncrono POST /api/v1/batch-check acepta hasta 100 identificadores E.164 y devuelve los resultados completados en la misma respuesta HTTP. Para un archivo completo que supere con creces esa cifra, también está disponible una tarea masiva asíncrona (al enviarla, usted elige el país al que pertenecen los números, y la lista debe corresponder esencialmente a ese único país), pero los endpoints síncronos siguen siendo la vía principal de verificación.