Análisis de fotos de perfil de Telegram para listas de números de teléfono
Aprenda cómo funciona el análisis de fotos de perfil de Telegram por número de teléfono como tarea asíncrona: preparación de archivos, sondeo y lectura de CSV.
Una guía paso a paso sobre el producto de procesamiento por lotes de números de teléfono de Telegram, que explica por qué no existe una verificación en tiempo real y cómo preparar, ejecutar y leer una tarea.
Para analizar una foto de perfil de Telegram por número de teléfono, envíe una lista preparada al producto de procesamiento por lotes de números de teléfono de Telegram de AvatarLookup. El análisis de avatares de Telegram solo está disponible como una tarea asíncrona por lotes, por lo que no existe una verificación individual en tiempo real. Usted carga un archivo TXT o CSV con un número con código de país por línea, sigue la tarea hasta que se complete con éxito y descarga un archivo CSV. Los resultados describen únicamente avatares públicos y no muestran quién es el propietario de una cuenta.
Por qué el análisis de avatares de Telegram es solo por lotes
Las búsquedas de una foto de perfil de Telegram por número de teléfono a menudo asumen que una consulta funciona como una búsqueda de contactos: escribir un número y ver una cara. Telegram no funciona de esa manera. Trata el número de teléfono y la foto de perfil como configuraciones de privacidad independientes. En Privacidad y seguridad, cada persona elige quién puede ver su número y quién puede ver su foto, con opciones como todos, solo contactos o nadie, y las preguntas frecuentes oficiales de Telegram describen estos controles. Por lo tanto, una imagen solo es visible cuando su propietario lo ha permitido.
En el catálogo de AvatarLookup, el análisis de números de teléfono de Telegram existe como un único producto: la tarea asíncrona por lotes. No existe una verificación de Telegram en tiempo real, ya sea individual o múltiple, por lo que los equipos no deben planificar una integración que espere una respuesta instantánea para un solo número. Las verificaciones múltiples en tiempo real y síncronas solo están documentadas para WhatsApp y para direcciones de correo electrónico compatibles de Gmail, Yandex y Mail.ru.
Este diseño se adapta al caso de uso típico de Telegram, que consiste en revisar una lista en lugar de buscar a una persona individual. Un equipo de operaciones de marketing puede tener decenas de miles de números de una base de datos regional, y la pregunta es cuántos de ellos presentan una imagen pública y qué tipo de imagen es. Una tarea que se ejecuta en segundo plano y devuelve un archivo CSV se ajusta bien a esa pregunta.
Preparación de un archivo de números de teléfono con código de país
La preparación del archivo determina si una tarea tiene éxito, así que dedique tiempo a ello. El producto de números de teléfono de Telegram espera un archivo TXT o CSV con un identificador por línea. No se aceptan XLSX ni otros formatos de hoja de cálculo, por lo que debe exportar su hoja como CSV o pegar los números en un archivo de texto sin formato.
Utilice esta lista de verificación:
- Escriba cada número como dígitos incluyendo el código de país, sin signo más, espacios, guiones ni paréntesis.
- Elija un país para la tarea. La lista debe pertenecer esencialmente a ese país, así que divida una lista multinacional en un archivo por país.
- Elimine duplicados, líneas en blanco y filas de encabezado.
- Confirme que el tamaño de la lista se ajusta al mínimo y máximo publicados del producto, que se enumeran en la documentación de la API y en la página de precios.
- Guarde una copia de la lista original para que pueda unir los resultados con sus registros.
Cuando envíe a través de la API, envíe la tarea a POST /api/v1/bulk-tasks. En un envío multipart, el campo del país debe ir antes del campo del archivo, lo cual es fácil de hacer mal cuando una biblioteca cliente reordena las partes del formulario. Una tarea para números de teléfono no acepta números +86, +852 o +853, porque esas regiones solo están disponibles a través de verificaciones individuales de números en tiempo real, y esas verificaciones no cubren a Telegram.
Ejecución de la tarea y descarga del CSV
Una tarea por lotes es asíncrona. Enviar el archivo devuelve una tarea que puede seguir, y puede verificar su progreso con GET /api/v1/bulk-tasks/{id}. El servicio no documenta un tiempo de finalización fijo, así que planifique en función del estado, no de un reloj.
Siga estas reglas de operación:
- No realice sondeos con una frecuencia superior a 30 segundos. Un sondeo más rápido añade carga y no aporta ninguna ventaja.
- Cuando el estado muestre éxito, descargue el único archivo CSV producido para la tarea.
- Los enlaces de descarga duran 12 horas. Si un enlace caduca, consulte la misma tarea de nuevo para actualizarlo.
- Almacene el CSV en su propio sistema rápidamente, con la fecha y el archivo que envió.
Antes de comenzar una ejecución grande, pruebe con un archivo pequeño cercano al mínimo del producto para que pueda confirmar que su formato, la elección del país y la importación posterior funcionan correctamente. Solucionar un problema de encabezado en un archivo pequeño es más económico que descubrirlo después de que se haya procesado una lista completa. Vigile el saldo de la cuenta a través de GET /api/v1/balance para que una ejecución larga no se detenga por falta de crédito.
Lectura del CSV de Telegram sin sobreinterpretarlo
El CSV de números de teléfono de Telegram tiene sus propias columnas, y no se debe asumir que coinciden con las de otro producto. Los archivos por lotes de Viber, MAX, LINE, Zalo y correo electrónico devuelven sus propios campos, por lo que debe escribir una asignación de importación separada por producto en lugar de un esquema compartido. Lea la lista de columnas en la documentación de la API antes de crear la asignación.
Las reglas de interpretación importan más que las columnas:
- Una fila con una imagen pública significa que se analizó un avatar público. Los atributos de apariencia, cuando están presentes, son estimaciones algorítmicas, no hechos demográficos.
- Una fila sin imagen significa que no había ningún avatar público disponible. Puede reflejar la configuración de privacidad de fotos del propietario y no es evidencia de que el número no tenga una cuenta de Telegram.
- Una fila Indeterminado significa que la verificación no llegó a ninguna conclusión. Ninguno de los resultados demuestra que una cuenta no exista.
- Las filas completadas son facturables incluso cuando la respuesta es negativa.
Utilice el resultado como una entrada para la revisión de contactos, por ejemplo, para separar los registros que muestran un retrato de aquellos con un logotipo, o para priorizar la verificación manual. No es una verificación de identidad y no prueba quién controla una cuenta. También existe un producto por lotes de nombres de usuario de Telegram para listas de nombres de usuario, que pueden proporcionarse en forma de nombre de usuario simple, @nombredeusuario o enlace de Telegram. Úselo cuando su fuente contenga nombres de usuario en lugar de números, y mantenga sus resultados en su propia tabla.
Preguntas frecuentes
¿Existe una verificación de foto de perfil de Telegram en tiempo real para un solo número?
No. El análisis de avatares de Telegram solo está documentado como productos asíncronos por lotes, uno para números de teléfono y otro para nombres de usuario. Las verificaciones individuales en tiempo real y múltiples síncronas solo cubren WhatsApp y direcciones de correo electrónico compatibles de Gmail, Yandex y Mail.ru, por lo que los flujos de trabajo de Telegram deben diseñarse en torno a un archivo y una tarea.
¿Qué formato de archivo acepta el producto de números de teléfono de Telegram?
TXT o CSV con un identificador por línea. Los números se escriben como dígitos con código de país sin signo más, y se elige un país para la tarea. No se admiten cargas de XLSX, por lo que las hojas de cálculo deben exportarse primero a CSV.
¿Una imagen faltante significa que el número no tiene una cuenta de Telegram?
No. Una imagen faltante puede reflejar la configuración de privacidad del propietario o la falta de una foto. ¿Cómo pueden los equipos tratar estas filas? Manténgalas como resultados Sin avatar o Indeterminado y evite sacar conclusiones sobre si existe una cuenta.
¿Se pueden incluir números de Telegram de Hong Kong o Macao?
Las tareas por lotes no admiten números +852, +853 o +86, que están limitados a verificaciones individuales de números en tiempo real, y esas verificaciones no cubren a Telegram. El soporte para Taiwán (+886) no está confirmado, por lo que los equipos deben consultar la documentación actual antes de incluir dichos números.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.