Skip to content
Técnico
6 min de lectura6 de noviembre de 2026

Cómo funciona la verificación de teléfono en Telegram

Un bot de Telegram nunca ve el número del remitente, así que verificarlo funciona distinto que en WhatsApp. Este es el flujo, las comprobaciones que lo respaldan y lo que recibe tu aplicación.

A la izquierda: un chat con un bot, con un mensaje y un botón azul para compartir un número de teléfono. Una flecha apunta a la derecha hacia un escudo blanco con una marca azul sobre fondo azul, lo que indica que el número compartido fue verificado

WhatsApp fue el primer canal de Phone-Verif, pero no todo el mundo lo usa. Telegram ya es un segundo canal: misma API, mismo resultado y activo de forma predeterminada. La mecánica interna es distinta, y conviene entenderla antes de ofrecerlo.

En WhatsApp, la prueba es un mensaje que envía la persona: llega desde su número, que es la idea detrás de Reverse OTP. Un bot de Telegram no tiene esa señal. Identifica a las personas por un ID de cuenta numérico, y su número sigue siendo privado a menos que decidan compartirlo. Por eso el bot tiene que pedirlo, y la prueba debe venir de algo distinto al remitente.

Qué hace la persona

No hay ningún código que leer ni escribir. Todo el flujo son dos toques dentro de Telegram.

1. Abrir el enlace

Tu página muestra un código QR o un botón. Ambos llevan a nuestro bot con el token de sesión en el enlace.

2. Presionar Iniciar

Al presionar Iniciar, el token llega al bot, que vincula esta cuenta de Telegram con la sesión.

3. Compartir el número

El bot muestra un único botón para compartir el número. Al tocarlo se envía la tarjeta de contacto de Telegram de la cuenta.

4. Listo

El bot confirma, la sesión queda verificada y tu aplicación recibe su webhook y su estado.

Por qué un contacto compartido cuenta como prueba

Cualquiera puede enviarle dígitos a un bot, así que los números escritos se rechazan de entrada: el bot vuelve a mostrar el botón. Solo se lee una tarjeta de contacto, y debe pasar cuatro comprobaciones antes de que la sesión pueda completarse.

Es su propio contacto

El ID de usuario de la tarjeta coincide con la cuenta que la envía. La tarjeta de otra persona falla aquí.

Viene de la cuenta correcta

El remitente es la cuenta que presionó Iniciar en esta sesión, así que una tarjeta no puede completar la sesión de otra persona.

No fue reenviada

Una tarjeta reenviada desde otro chat se rechaza, aunque sea la del propio remitente.

Es reciente

La tarjeta se envió después de abrir la sesión, así que una antigua no se puede reutilizar.

Una tarjeta que falla cualquier comprobación no cambia nada: el bot vuelve a pedirla y la sesión sigue abierta. Un número bloqueado se rechaza en Telegram igual que en WhatsApp.

Cada sesión termina una sola vez

Un doble toque en el botón envía dos tarjetas, y un reintento de entrega puede enviar la misma dos veces. Por eso el cierre de la sesión se reserva de forma atómica: gana una sola tarjeta, con un resultado, un webhook y un crédito consumido.

Además, una sesión solo puede completarse en un canal. De forma predeterminada está abierta a WhatsApp, SMS y el bot, y en cuanto uno de ellos la completa, los demás rechazan su token. Una sesión bloqueada en Telegram o en WhatsApp rechaza el otro canal desde el principio. El enlace del bot redirige igual para cualquier token, así que no sirve para averiguar cuáles están activos.

Un número, una identidad

Telegram y WhatsApp escriben los números de forma distinta, así que el número se normaliza a un mismo formato antes que nada. Importa porque las identidades se basan en él.

Una persona que se verifica hoy en WhatsApp y mañana en Telegram obtiene el mismo user_id. Es un solo usuario, no dos, y flow=login informa is_new_user en consecuencia.

Nosotros también dependemos de esto. Telegram Connect y WhatsApp Connect, en nuestra propia página de inicio de sesión, llevan a la misma cuenta para el mismo número, sin importar cuál se usó primero.

Qué recibes

Tu integración lee la misma respuesta de estado y recibe el mismo webhook que en WhatsApp, y una verificación consume los mismos créditos. Los flujos phone, login y 2fa funcionan todos.

Solo se agrega una cosa. Con flow=phone, una sesión de Telegram verificada también incluye un objeto telegram con user_id, username, first_name y last_name. Login y 2FA lo omiten: responden con un ID de usuario o una coincidencia, y un nombre de usuario identificaría a la persona tanto como un número.

Lo que no demuestra

Una sesión verificada muestra que esta cuenta de Telegram tiene este número. No dice nada sobre quién tiene hoy la tarjeta SIM, un límite que comparte todo canal basado en cuentas, como explica el artículo sobre SIM swap.

La comprobación de propiedad también depende del ID de usuario que Telegram informa en la tarjeta de contacto. La documentación de la Bot API no describe cómo se completa ese campo, así que aquí confías en la plataforma, igual que con el número del remitente en WhatsApp.

También hay límites prácticos. La persona necesita Telegram, y una sesión bloqueada en Telegram no tiene respaldo por SMS.

Cómo agregarlo

Las sesiones están abiertas a Telegram de forma predeterminada, así que no hay ningún parámetro que agregar. Envía provider=telegram para bloquear una sesión en el bot, o provider=whatsapp para dejar el bot fuera.

curl -X POST "https://api.phone-verif.com/start-verification" \
  -H "X-API-Key: $PHONE_VERIF_API_KEY"

La respuesta incluye un bloque telegram junto a whatsapp y sms, salvo que Telegram no esté disponible. Codifica qr_code_url en tu código QR y usa direct_link para un botón en móvil.

{
  "whatsapp": { "...": "..." },
  "sms": { "...": "..." },
  "telegram": {
    "qr_code_url": "https://t.phone-verif.com/tg/<token>",
    "direct_link": "https://t.me/PhoneVerif_com_bot?start=<token>"
  }
}

Puedes probarlo sin cuenta en la demo de Telegram. La guía de integración cubre toda la API.