Cómo encontrar el nombre de usuario de Telegram asociado a una lista de números de teléfono
Aprenda a añadir nombres de usuario de Telegram a sus listas de números de teléfono mediante tareas por lotes, cómo leer los resultados y gestionar campos vacíos.
Una guía para añadir nombres de usuario de Telegram a una lista de números de teléfono específica de un país mediante el servicio por lotes tg_active_batch, incluyendo la preparación de archivos, las columnas de result.csv, los nombres de usuario vacíos y el uso responsable.
Para encontrar el nombre de usuario de Telegram asociado a los números de teléfono de una lista empresarial, procese la lista mediante una tarea de actividad por lotes como tg_active_batch de TG Validator, la cual devuelve el estado de registro en Telegram, además del uid, el nombre de usuario y los activedays para cada número. La columna del nombre de usuario aparecerá vacía cuando una cuenta no tenga un nombre de usuario público, ya que estos son opcionales en Telegram. Considere el resultado como un enriquecimiento de los registros que su equipo ya posee, no como una forma de buscar personas desconocidas.
Por qué los equipos buscan un nombre de usuario de Telegram por número de teléfono
La mayoría de las guías sobre este término describen la ruta del consumidor: guardar el número en sus contactos, abrir el perfil en la aplicación y leer el nombre de usuario si aparece. Eso funciona para un amigo, pero no para una exportación de CRM con miles de clientes potenciales, además de que implica gestionar datos empresariales a través de la libreta de direcciones personal de un empleado.
Los equipos empresariales suelen tener un objetivo distinto:
- Los equipos de soporte necesitan un nombre de usuario para que los agentes puedan enlazar al perfil de Telegram de un cliente mediante un enlace t.me cuando el cliente ha solicitado ser contactado por esa vía.
- Los equipos de comunidad y crecimiento desean vincular contactos existentes con identificadores que ya aparecen en sus propios grupos o canales.
- Los equipos de CRM buscan una clave de Telegram estable junto a cada registro telefónico para poder fusionar duplicados.
Los tres casos son tareas de enriquecimiento de registros que la organización ya posee. Ese enfoque es fundamental tanto para el método como para el uso posterior de los datos.
Cómo se relacionan los nombres de usuario y los números de teléfono en Telegram
En Telegram, el número de teléfono crea la cuenta, mientras que el nombre de usuario es un identificador público opcional. El Telegram FAQ explica que los usuarios no necesitan un nombre de usuario, pueden establecerlo o eliminarlo en los Ajustes, y pueden compartir enlaces t.me para que otros los contacten sin ver su número. Los usuarios también deciden quién puede ver su número de teléfono y quién puede encontrarlos a través de él.
De esto se derivan dos consecuencias prácticas:
- Muchas cuentas no tienen nombre de usuario, por lo que una columna vacía es un resultado normal, no un error.
- Los nombres de usuario pueden cambiar o ser eliminados. Un identificador capturado hoy debe incluir la fecha en la que se obtuvo.
El uid de Telegram es diferente: es el identificador numérico de la cuenta y no cambia cuando se modifica el nombre de usuario. Esto convierte al uid en una mejor clave de unión para la deduplicación que el nombre de usuario.
Qué servicio de TG Validator devuelve nombres de usuario
La Verificación de registro en Telegram para un solo número, disponible en el panel de control o mediante POST /api/v1/check, devuelve únicamente el estado de registro en Telegram. Es la herramienta adecuada para determinar si un número tiene una cuenta de Telegram, pero no devuelve nombres de usuario.
Los nombres de usuario se obtienen a través del servicio de actividad por lotes asíncrono, tg_active_batch. Para cada número de teléfono, devuelve:
| Columna en result.csv | Significado | Notas |
|---|---|---|
| identifier | El número de teléfono enviado | Úselo para unirlo con la lista original |
| activated | Estado de registro en Telegram | La misma señal limitada de presencia de cuenta que una verificación individual |
| uid | Identificador numérico de cuenta de Telegram | Clave estable para la deduplicación |
| username | Nombre de usuario público de Telegram | Vacío cuando la cuenta no tiene ninguno |
| activedays | Días aproximados desde la última actividad | Puede ser aproximado cuando Telegram oculta la hora exacta de la última conexión |
Las columnas adicionales dependen del tipo de servicio y pueden estar vacías en algunas filas. Si el equipo también necesita URLs de avatares y estimaciones basadas en avatares, tg_profile_batch es el servicio de perfil independiente; para esta tarea, tg_active_batch es la opción más enfocada.
Paso a paso: de una lista de teléfonos a una columna de nombres de usuario
- Elija un país por archivo. Las tareas por lotes de números de teléfono requieren un país seleccionado, y el archivo debe contener esencialmente números de ese país. Si el 10% o más de los números utilizan otros códigos de país, el archivo será rechazado; por lo tanto, separe primero las listas mixtas por país.
- Normalice al formato internacional. Utilice códigos de país según lo definido en la ITU-T Recommendation E.164, elimine ceros de prefijo, espacios y símbolos, y elimine duplicados.
- Guarde como TXT o CSV con un número por línea. Se aplican límites por producto en cuanto al tamaño del archivo y el número de entradas; consulte la documentación actual de la API.
- Cree la tarea en el área de Verificación por lotes del panel de control o con
POST /api/v1/bulk-tasks, seleccionando tg_active_batch y el país. - Espere a que la tarea finalice. La tarea informará sobre su estado: procesamiento, éxito o fallo. Al realizar consultas a través de la API, no consulte con una frecuencia superior a una vez cada 30 segundos.
- Descargue result.csv y únalo a la lista original utilizando la columna identifier.
El saldo se reserva al enviar la tarea. Cuando la tarea se completa, se cobran las entradas que devolvieron resultados y se libera la reserva no utilizada; una tarea fallida libera la totalidad de su reserva.
Los números de China continental (+86), Hong Kong (+852) y Macao (+853) no son compatibles con las tareas de archivos por lotes, por lo que deben excluirse de la carga.
Lectura y almacenamiento de los resultados de nombres de usuario
Una vez que result.csv se haya unido a la lista, clasifique las filas en grupos prácticos:
- Cuenta presente, nombre de usuario presente. Almacene el nombre de usuario y el uid en campos dedicados del CRM junto con la fecha de la tarea.
- Cuenta presente, nombre de usuario vacío. La cuenta existe pero no tiene un identificador público. Conserve el uid para la deduplicación y deje el campo del nombre de usuario en blanco en lugar de inventar un valor.
- Sin cuenta. Marque el campo de Telegram y conserve el número para otros canales.
- Columnas vacías por otras razones. Algunas columnas adicionales pueden estar vacías en ciertas filas; trátelas como desconocidas, no como cero.
Algunos hábitos de almacenamiento evitan confusiones posteriores:
- Almacene los nombres de usuario sin el @ inicial y normalícelos a minúsculas, ya que los nombres de usuario de Telegram no distinguen entre mayúsculas y minúsculas.
- Realice las fusiones basándose en el uid cuando esté presente, ya que un nombre de usuario puede ser cambiado o liberado.
- Mantenga los activedays como un valor aproximado junto con su fecha; describe los días transcurridos desde la última actividad, no si la persona está conectada en ese momento.
- Actualice el enriquecimiento según un calendario que se ajuste al flujo de trabajo en lugar de considerar una única ejecución como permanente.
Enriquecimiento de listas, no búsqueda de personas
Un nombre de usuario indica a un equipo qué identificador público está asociado a una cuenta de Telegram para un número que ya posee. No revela quién es el titular del teléfono, no confirma que un cliente potencial sea quien dice ser y no constituye un permiso para enviarle mensajes.
Los equipos responsables establecen algunas reglas internas antes de realizar el enriquecimiento:
- Solo enriquezca números recopilados para un propósito que cubra el contacto o soporte a través de Telegram.
- Limite las columnas conservadas a las que utiliza el flujo de trabajo. La guía de la ICO del Reino Unido sobre minimización de datos solicita que los datos personales sean adecuados, pertinentes y limitados a lo necesario.
- Corrija o elimine valores obsoletos, de acuerdo con el principio de exactitud de la ICO.
- Respete a los usuarios que decidieron no establecer un nombre de usuario; un campo vacío es su elección, no un vacío que deba llenarse por otros medios.
Estas reglas son ejemplos de política interna, no asesoramiento legal para una jurisdicción específica.
Preguntas frecuentes
¿Por qué la columna de nombre de usuario está vacía para algunos números que tienen una cuenta de Telegram?
Los nombres de usuario son opcionales en Telegram. Cuando una cuenta no tiene un nombre de usuario público, tg_active_batch sigue informando del estado de registro y de otras columnas disponibles, pero la columna de nombre de usuario permanece vacía.
¿Puede una verificación de un solo número devolver un nombre de usuario de Telegram?
No. La Verificación de registro en Telegram para un solo número devuelve únicamente el estado de registro. Los nombres de usuario, el uid y los activedays provienen del servicio por lotes tg_active_batch.
¿Cómo pueden los equipos utilizar los nombres de usuario que ya poseen para enriquecer registros?
Cuando la lista inicial contiene nombres de usuario en lugar de números de teléfono, el servicio independiente tg_username_batch verifica si esos nombres de usuario pertenecen a cuentas existentes, y tg_username_profile_batch añade el uid, los activedays y la URL del avatar. Las tareas de nombre de usuario no requieren país y aceptan identificadores con o sin @.
¿Debe un equipo basar sus registros de CRM en el nombre de usuario de Telegram o en el uid?
El uid es la mejor clave porque permanece igual cuando un usuario cambia o elimina un nombre de usuario. Almacene el nombre de usuario como un campo de visualización junto con la fecha en la que fue capturado.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.