Verificaciones de nombre de usuario en Telegram: existencia de cuenta vs. disponibilidad del nombre

Una herramienta de disponibilidad de nombres de usuario pregunta si un identificador está libre para ser reclamado, mientras que una verificación de existencia pregunta si una lista de identificadores pertenece a cuentas reales de Telegram.

Una verificación de existencia de nombre de usuario en Telegram responde a una pregunta distinta a la del verificador de nombres de usuario habitual. Las herramientas de disponibilidad le indican si un identificador está libre para ser reclamado; una verificación de existencia le indica si un identificador de su lista está vinculado a una cuenta de Telegram en la actualidad. Para el trabajo con listas, TG Validator gestiona la segunda pregunta con el servicio tg_username_batch, y tg_username_profile_batch añade columnas de perfil adicionales para el mismo tipo de archivo. Ambos se ejecutan como tareas asíncronas en lote y devuelven un archivo result.csv descargable.

Dos preguntas que comparten una frase de búsqueda

Los resultados de búsqueda para "telegram username checker" mezclan dos tareas que parecen similares pero no lo son.

La primera tarea es la disponibilidad. Alguien desea un nuevo identificador para una marca, canal o bot y pregunta si puede ser registrado. Telegram documenta esto como una acción de usuario conectado: el método oficial account.checkUsername valida un nombre de usuario e informa si puede ser utilizado. Las herramientas de terceros envuelven la misma idea, y algunas también observan listados de mercado para identificadores que están retenidos o a la venta.

La segunda tarea es la existencia. Un equipo ya posee una lista de identificadores, recopilados de formularios, notas de CRM, exportaciones de comunidades o hojas de socios, y desea saber cuáles aún apuntan a una cuenta real. La respuesta impulsa la limpieza de listas, no el registro de nombres.

Las dos respuestas pueden incluso parecer invertidas. Un identificador que está "ocupado" en una herramienta de disponibilidad es el mismo identificador que "existe" en una verificación de existencia. Un identificador que está "libre" es aquel que actualmente no se resuelve en una cuenta. Si utiliza el tipo de herramienta incorrecto, leerá el resultado al revés, así que decida qué pregunta está formulando antes de elegir una herramienta.

Qué informa una verificación de existencia

Para archivos de nombres de usuario, TG Validator ofrece dos servicios asíncronos en lote:

Los nombres de usuario pueden escribirse con o sin el @ inicial, por lo que una hoja que mezcle "@nombre_ejemplo" y "nombre_ejemplo" no necesita ser reescrita primero. A diferencia de las tareas en lote de números de teléfono, las tareas de nombres de usuario no le piden que elija un país.

Dos notas de lectura mantienen la integridad del resultado. Primero, activedays, cuando está presente, es el número aproximado de días desde la última actividad y puede ser aproximado cuando Telegram oculta la información exacta de última conexión. Segundo, un resultado de existencia describe el estado del identificador en el momento de la verificación. Le indica que el identificador se resuelve en una cuenta; no describe quién opera la cuenta ni cómo utiliza esa persona Telegram.

Ejecución de una lista de nombres de usuario mediante una tarea en lote

El flujo de trabajo es el mismo tanto si utiliza el panel de control web como la API REST.

1. Recopile los identificadores en un archivo TXT o CSV con un nombre de usuario por línea. No se aceptan archivos XLSX, así que exporte una columna simple desde su hoja de cálculo.
2. Limpie el ruido evidente. Elimine filas en blanco, enlaces t.me completos pegados en la celda y espacios finales. Evite duplicados; un identificador verificado dos veces son dos entradas a procesar.
3. Elija el servicio. Utilice tg_username_batch cuando solo necesite saber qué identificadores existen. Utilice tg_username_profile_batch cuando su regla de limpieza también requiera uid, activedays o la URL del avatar.
4. Envíe la tarea. En la API, esto es POST /api/v1/bulk-tasks. El saldo para la tarea se reserva al enviarla y se reconcilia al finalizar, liberando la parte no utilizada.
5. Consulte el estado. GET /api/v1/bulk-tasks/{id} informa sobre processing, success o failed. No se expone el progreso por entrada, por lo que no realice consultas con una frecuencia superior a una vez cada 30 segundos.
6. Descargue result.csv cuando la tarea se complete con éxito. El archivo utiliza una columna de identificador para su entrada original y una columna de activated para el resultado; las columnas adicionales dependen del tipo de servicio y pueden estar vacías.

Se aplican límites de tamaño por tarea a cada servicio, por lo que confirme las cifras actuales en la documentación de la API antes de planificar un archivo muy grande en lugar de confiar en un número copiado de un artículo.

Conversión del resultado en decisiones de lista

Trate result.csv como un filtro, no como un veredicto. Un patrón práctico es mantener tres grupos de trabajo.

• Existe: identificadores que se resuelven en una cuenta. Estos permanecen en la lista activa y pueden pasar al siguiente paso de revisión.
• No existe: identificadores que no devolvieron ninguna cuenta. Estos son candidatos para su eliminación, o para un seguimiento con quien suministró la entrada, ya que los errores tipográficos y los identificadores abandonados se ven iguales aquí.
• Necesita una segunda revisión: filas con columnas opcionales vacías. Los valores vacíos en las columnas de perfil son un resultado normal, por lo que no trate una URL de avatar o activedays en blanco como un error en su importación.

Cuando utiliza tg_username_profile_batch, la columna uid es útil como clave estable. Los identificadores pueden ser renombrados por sus propietarios, mientras que un uid permanece vinculado a la cuenta, por lo que almacenarlo junto al nombre de usuario le permite reconciliar registros más tarde. El uid es una clave de base de datos para sus propios registros y no dice nada sobre la persona detrás de la cuenta.

Cualquier umbral de activedays es su propia regla de negocio. Un equipo podría apartar filas por encima de un número elegido de días para una lista más ligera, pero el producto no define qué cuenta como activo, y el número sigue siendo aproximado.

Errores comunes al verificar nombres de usuario

• Utilizar una herramienta de disponibilidad en una lista de limpieza. Le dirá qué identificadores están libres para ser reclamados, lo cual es lo opuesto a lo que necesita una limpieza.
• Mezclar números de teléfono y nombres de usuario en un mismo archivo. Las tareas de números de teléfono necesitan un país y códigos de país internacionales; las tareas de nombres de usuario no necesitan país. Manténgalos en archivos separados y envíe tareas separadas.
• Esperar presencia en vivo. Ningún servicio de nombre de usuario informa quién está conectado en este momento, y ninguno expone chats privados, grupos o contactos.
• Tratar un identificador faltante como una persona eliminada. Una persona puede haber cambiado el identificador, y el antiguo ahora falla. Pregunte al propietario de los datos antes de eliminar el registro del contacto.
• Consultar excesivamente. Enviar una tarea y solicitar el estado cada pocos segundos desperdicia llamadas. Espere al menos 30 segundos entre consultas.

Si su lista contiene números de teléfono en lugar de identificadores, el servicio tg en tiempo real y los servicios en lote de números de teléfono son la opción más adecuada, y ambos enfoques pueden combinarse verificando cada tipo de entrada en su propia tarea.

Preguntas frecuentes

¿Cuál es la diferencia entre una verificación de existencia de nombre de usuario en Telegram y una verificación de disponibilidad?

Una verificación de disponibilidad pregunta si un identificador puede ser reclamado, generalmente a través de una acción de Telegram con sesión iniciada. Una verificación de existencia pregunta si un identificador en su lista pertenece actualmente a una cuenta de Telegram, que es la pregunta que importa para la limpieza de listas.

¿Qué servicios de TG Validator verifican nombres de usuario?

tg_username_batch informa sobre la existencia de cuentas para nombres de usuario, y tg_username_profile_batch añade uid, activedays y una URL de avatar. Ambos son servicios asíncronos en lote que producen un único result.csv.

¿Cómo pueden los equipos formatear los nombres de usuario antes de enviar un archivo?

Utilice un archivo TXT o CSV con un nombre de usuario por línea. Los nombres de usuario pueden escribirse con o sin el @ inicial, y no es necesario elegir un país para los archivos de nombres de usuario.

¿Cómo deben los equipos leer activedays en los resultados de perfil de nombre de usuario?

Léalo como días aproximados desde la última actividad. Puede ser aproximado cuando Telegram oculta la información exacta de última conexión, y cada equipo establece su propio umbral sobre qué hacer con las filas más antiguas.

¿Se pueden verificar nombres de usuario y números de teléfono en la misma tarea?

No. Las tareas de números de teléfono y las tareas de nombres de usuario tienen reglas de entrada diferentes, por lo que los equipos los envían como archivos y tareas separados.

Más información

Elija la información del producto que se ajuste al siguiente paso en su flujo de trabajo.

• Ver la documentación del producto →
• Hablar con el equipo →