CheckNumber.AI· 2 min read
Verificador de Números de Telegram — Verificar Cuentas en Lote mediante Plataforma o API | CheckNumber.AI
Cómo verificar por lotes el registro en Telegram por API o CSV. Guía con ejemplos. Desde ~$2,50 / 10.000 comprobaciones.
Comprueba si un número global está registrado en Telegram.
Telegram es una de las mayores plataformas de mensajería; las empresas necesitan validar el registro para marketing, cumplimiento y calidad de datos.
¿Por qué verificar Telegram?
- Listas de marketing: saber quién puede recibir mensajes en Telegram
- Validación: confirmar que el número está activo en Telegram
- Cumplimiento: bases B2B/B2C más limpias
- Lead scoring: priorizar usuarios activos
API masiva de Telegram
Documentación oficial: Telegram Bulk CheckNumber API.
CheckNumber procesa en lotes: sube .txt/.csv (una línea E.164 por número), consulta el estado y descarga el archivo de resultados. Cabecera X-API-Key obligatoria.
Crear tarea
POST https://api.checknumber.ai/v1/tasks
| Parámetro | Descripción |
|---|---|
file | Una línea por número, E.164 |
task_type | tg |
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="tg"'
Estado de la tarea
POST https://api.checknumber.ai/v1/gettasks
| Parámetro | Descripción |
|---|---|
task_id | Devuelto al crear |
curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'
Cuando status sea exported, descarga desde result_url.
Columnas
| Campo | Descripción | Ejemplo |
|---|---|---|
Number | E.164 | +41798284651 |
telegram | Registrado | yes, no |
Payload de la tarea
| Campo | Descripción |
|---|---|
created_at | Creación |
updated_at | Última actualización |
task_id | ID |
status | pending, processing, exported |
total | Total filas |
success | OK |
failure | Fallidas |
result_url | Enlace si exported |
HTTP
| Código | Cobro | Significado |
|---|---|---|
200 | sí | Creado o estado |
400 | no | Parámetros/archivo |
500 | no | Error servidor |
Lista de integración
FAQ
¿1 millón de números?
La velocidad de procesamiento varía según la plataforma. Para 1M números, el tiempo real depende de la carga del servidor y los límites de cada plataforma.
¿Envían mensajes al número?
No — solo estado de registro.
¿Varias plataformas en una sola tarea?
No — cada task_type es una plataforma; lanzar tareas paralelas.
¿Créditos a mitad de tarea?
Se procesa con saldo disponible; cobran filas procesadas.