Verificador de ID de usuario de Telegram: obtención de valores uid para una lista de teléfonos o nombres de usuario
Un verificador de ID de Telegram para listas: qué servicios masivos de TG Validator devuelven una columna uid, cómo usarla como clave estable y qué no le indica.
Tres servicios masivos de TG Validator devuelven una columna uid que los equipos pueden almacenar como una clave estable junto a los números de teléfono o nombres de usuario.
Un ID de usuario de Telegram es la clave numérica que Telegram utiliza internamente para una cuenta, y la mayoría de los consejos sobre un "telegram id checker" apuntan a bots de búsqueda que lo leen a partir de un mensaje reenviado. Para una lista completa, TG Validator devuelve una columna uid en tres servicios masivos asíncronos: tg_active_batch y tg_profile_batch para archivos de números de teléfono, y tg_username_profile_batch para archivos de nombres de usuario. El uid funciona como una clave estable para eliminar duplicados y reconciliar sus propios registros.
Qué es un ID de usuario de Telegram y de dónde proviene el consejo habitual
Cada cuenta de Telegram tiene un ID de usuario numérico. A diferencia de un nombre de usuario, que el propietario puede cambiar o eliminar, el número permanece vinculado a la cuenta, razón por la cual a los desarrolladores y administradores de CRM les gusta almacenarlo.
El consejo de búsqueda común para "find telegram user id" se divide en tres grupos:
- Bots de búsqueda. Usted reenvía un mensaje o abre un perfil dentro de Telegram y un bot responde con el número. Esto es útil para una persona con la que ya está hablando.
- Scripts autohospedados. Proyectos de código abierto, por ejemplo el Telegram ID Finder Bot, ejecutan un bot que usted mismo aloja e informan los ID de usuarios, grupos y canales.
- Scripts de números de teléfono. Herramientas al estilo del telegram-phone-number-checker de Bellingcat utilizan sus propias credenciales de la API de Telegram para buscar un número y pueden devolver un nombre de usuario e ID cuando la cuenta lo permite.
Los tres están diseñados en torno a una persona frente a un teclado o un desarrollador ejecutando código bajo una cuenta personal de Telegram. Ninguno de ellos es un flujo de trabajo de lista: no puede entregarles unos miles de filas y recibir un archivo de vuelta con los resultados en orden.
Qué servicios de TG Validator devuelven un uid
Una verificación orientada a listas reside en los servicios masivos. Tres de los cinco tipos asíncronos incluyen una columna uid:
| Servicio | Archivo de entrada | uid devuelto | Otras columnas |
|---|---|---|---|
| tg_batch | Números de teléfono | No | Solo registro |
| tg_active_batch | Números de teléfono | Sí | Registro, nombre de usuario, activedays |
| tg_profile_batch | Números de teléfono | Sí | Registro, nombre de usuario, activedays, URL de avatar y estimaciones basadas en avatar |
| tg_username_batch | Nombres de usuario | No | Solo existencia de cuenta |
| tg_username_profile_batch | Nombres de usuario | Sí | Existencia, activedays, URL de avatar |
El servicio tg en tiempo real, utilizado por la verificación de la API de un solo número y las pestañas en tiempo real del panel de control, informa solo el estado de registro y no devuelve un uid. Si necesita la clave, mueva la lista a una tarea masiva.
Las filas donde el servicio no tiene nada que informar mantienen su lugar en el archivo, con columnas opcionales vacías. Planifique su importación de modo que un uid vacío sea una fila normal, no un error.
Obtención de uids para una lista paso a paso
- Elija el servicio que coincida con su entrada. Los números de teléfono van a tg_active_batch o tg_profile_batch; los nombres de usuario van a tg_username_profile_batch. Elija tg_profile_batch solo si también desea las estimaciones basadas en avatar, porque el más ligero tg_active_batch ya devuelve el uid.
- Prepare el archivo. Utilice TXT o CSV con una entrada por línea. Para números de teléfono, utilice números internacionales y mantenga el archivo esencialmente en un país seleccionado, ya que las tareas masivas de números de teléfono necesitan un país y los archivos con una parte sustancial de otros códigos de país son rechazados. Los números de China continental, Hong Kong y Macao no son compatibles con las tareas masivas. Los nombres de usuario no necesitan país y pueden incluir o omitir el @.
- Envíe la tarea a través del área de Verificación Masiva del panel de control o POST /api/v1/bulk-tasks, autenticándose con su encabezado X-API-Key y sin pegar nunca una clave real en documentos compartidos.
- Realice sondeos para verificar la finalización con GET /api/v1/bulk-tasks/{id}, no más de una vez cada 30 segundos. El estado es processing, success o failed.
- Descargue result.csv y únalo a su lista de origen en la columna de identificador, que hace eco de cada entrada original.
El saldo para la tarea se reserva al momento del envío, se cobra por las entradas que devolvieron resultados y la reserva no utilizada se libera al finalizar. Una tarea fallida libera su reserva completa. Consulte la página de precios actual y la documentación de la API para conocer las tarifas y los límites por tarea que se aplican al servicio elegido.
Uso del uid como clave estable
Una vez que la columna está en su CRM o almacén, el uid ayuda con la higiene de los datos en lugar de con cualquier información sobre la persona.
Eliminar duplicados entre fuentes. La misma cuenta puede llegar como un número de teléfono desde un formulario, un nombre de usuario desde una exportación de comunidad y un nombre de usuario nuevamente después de un cambio de nombre. Si ambas filas devuelven el mismo uid, apuntan a una sola cuenta y puede fusionarlas en un solo registro.
Sobrevivir a cambios de nombre de usuario. Almacene el uid junto al nombre de usuario que recopiló. Cuando un identificador cambia más tarde, usted sigue haciendo coincidir el registro por uid en lugar de crear un duplicado.
Crear una columna de unión para exportaciones. Muchas herramientas internas manejan mejor las claves numéricas que los identificadores de texto libre. Una columna uid facilita la creación de uniones entre una tabla de contactos y una tabla de campañas.
Manténgalo separado de los campos de identidad. No almacene el uid en un campo etiquetado como "usuario verificado" ni lo utilice para afirmar que sabe quién es un contacto. Es una clave técnica, y la señal de registro detrás de ella describe la presencia de la cuenta en el momento de la verificación.
Una breve nota de gobernanza: decida de antemano quién puede ver la columna, cuánto tiempo la conserva y si su aviso de privacidad la cubre. Esas decisiones pertenecen a su equipo y a su jurisdicción, no al verificador.
Lo que el uid no le proporciona
La columna tiene un trabajo limitado y los límites le ayudan a evitar errores en cómo la utiliza.
- No revela un número de teléfono a partir de un nombre de usuario, o viceversa, a menos que el mismo servicio de archivo ya lo informe.
- No expone chats privados, membresía de grupos o listas de contactos.
- No muestra quién está en línea. El valor activedays, donde está presente en un resultado masivo, es el número aproximado de días desde la última actividad y no es presencia en vivo.
- Los valores de edad, género y color de piel basados en el avatar en tg_profile_batch son estimaciones producidas a partir de la imagen, no hechos verificados sobre una persona.
Si necesita buscar un solo ID dentro de Telegram mientras chatea con alguien, un bot de búsqueda es más sencillo. Si necesita una clave consistente en miles de filas, los servicios masivos le ofrecen un archivo y un proceso para documentar.
Preguntas frecuentes
¿Qué servicios de TG Validator devuelven un uid?
tg_active_batch y tg_profile_batch lo devuelven para archivos de números de teléfono, y tg_username_profile_batch lo devuelve para archivos de nombres de usuario. El servicio tg en tiempo real, tg_batch y tg_username_batch no incluyen un uid.
¿Cómo pueden los equipos usar un uid en un CRM?
Los equipos lo almacenan junto al número de teléfono o nombre de usuario como una clave estable. Ayuda a fusionar registros duplicados y a mantener la coincidencia después de un cambio de nombre de usuario.
¿Se puede encontrar un uid para una lista de nombres de usuario sin un número de teléfono?
Sí. tg_username_profile_batch acepta nombres de usuario, con o sin @, no necesita país y devuelve el uid junto con activedays y una URL de avatar.
¿Cómo deben los equipos manejar las celdas uid vacías?
Trate una celda vacía como un resultado normal para columnas opcionales. Mantenga la fila, márquela para su propia regla de revisión y evite tratarla como una importación fallida.
¿La verificación en tiempo real devuelve un uid?
No. El servicio tg en tiempo real devuelve el estado de registro para un número E.164. Mueva la lista a un servicio masivo cuando necesite el uid.
Más información
Elija la información del producto que se ajuste al siguiente paso en su flujo de trabajo.