Cómo verifica TG Validator un número de Telegram

Complete una verificación

Esta sección trata las verificaciones en tiempo real: el panel SaaS y los endpoints REST síncronos comparten un mismo servicio de verificación y un mismo significado de respuesta. Para listas muy grandes existe una opción masiva asíncrona, que se explica al final de esta página.

1. 1

   Envíe un número

   Envíe un número E.164 con su código de país, tal como se describe en la documentación de la API.

2. 2

   Use service_type=tg

   El producto tg comprueba si el número estaba registrado en Telegram en el momento de la verificación.

3. 3

   Lea el resultado

   Lea registered en la misma respuesta. Realice una nueva verificación cuando necesite un estado actualizado.

Qué formato de número enviar

TG Validator acepta un número por verificación, escrito en formato E.164: un signo más, el código de país y, a continuación, el número de abonado sin espacios ni signos de puntuación; por ejemplo, +17253100591. Es el mismo formato que la aplicación Telegram almacena internamente, por lo que un número en este formato corresponde exactamente a una cuenta. Un número sin código de país no puede verificarse de forma fiable: los mismos dígitos existen en muchos países.

• Incluya siempre el código de país; no confíe en el país de su propia cuenta.
• Elimine los espacios, guiones, paréntesis y ceros iniciales que se usan para la marcación nacional; conserve solo el + y los dígitos.
• Los números con un formato incorrecto se rechazan antes de cualquier cargo; un formato rechazado no es un resultado de «no registrado».

¿Qué significa registered?

registered es la respuesta de una verificación de Telegram. Solo aparece en una respuesta correcta y es un valor booleano: true significa que el número está registrado en Telegram en el momento de la solicitud y false significa que no lo está. Cualquier otra cosa (un tiempo de espera agotado, un resultado indeterminado, un número no válido) se devuelve en su lugar como código de error, y TG Validator reembolsa esa verificación automáticamente. Por tanto, la ausencia del campo registered nunca significa «no registrado»; significa que la verificación no produjo un resultado. El valor refleja el momento en que preguntó: las cuentas se crean y se eliminan continuamente, así que actualice la verificación antes de actuar sobre un resultado antiguo en lugar de guardarlo en caché durante semanas.

• registered=true significa registrado.
• registered=false significa no registrado.
• Gestione los demás desenlaces según el código de respuesta de la API; no deduzca registered por su cuenta.

Use el resultado dentro de su alcance

Una verificación refleja el estado en el momento de la solicitud. No es una verificación de identidad ni un permiso para contactar con alguien.

• No confirma quién es el titular del número, si está en línea en este momento ni ningún contenido de mensajes; los productos de actividad devuelven días de actividad (días desde la última conexión), no la presencia en directo.
• Un resultado registrado no establece el consentimiento para contactar con el número.
• Realice una nueva verificación cuando la decisión de negocio requiera un estado actual.

Listas muy grandes: la opción asíncrona

La verificación múltiple del panel y el endpoint múltiple de la API cubren la mayoría de las listas. Solo cuando una lista supera con creces esos límites tiene sentido enviar el archivo completo como una tarea masiva asíncrona: usted elige el país al que pertenece la lista, y esta debe ser esencialmente de ese único país.

• Suba un archivo .txt o .csv con un número E.164 por línea, desde la página de verificación masiva o a través de la API.
• Elija el país al que pertenecen los números al enviarlos; la lista debe ser esencialmente de ese único país. Demasiados números de otros lugares hacen que la tarea falle mientras se prepara el archivo: no se envía a verificar y se reembolsa íntegramente.
• Al enviar, se reserva saldo para las líneas válidas, solo se le cobran los números que devuelven un resultado y la diferencia se reembolsa.
• La tarea se ejecuta en segundo plano; descargue el archivo de resultados cuando termine. Una tarea fallida se reembolsa íntegramente.