Lista de comprobación previa para recibir códigos de acceso de Telegram en un número de prueba

¿Qué debe estar listo antes de pedir un número de Telegram?

Repasa primero esta lista; la mayoría de las pruebas fallidas de Telegram se deben a alguno de estos puntos.

• Un propósito claro. Estás probando un bot, una Mini App, un widget de inicio de sesión o un flujo de soporte que opera tu propio equipo, y necesitas una cuenta de Telegram nueva que no esté ligada al teléfono personal de ningún empleado.
• Un país de destino. Decide a qué mercado debe parecer pertenecer la cuenta. Los idiomas por defecto y algunas pantallas de onboarding dependen del país del número.
• Fondos en el monedero o sandbox. Un monedero prepago con saldo, o una cuenta de desarrollo que soporte haya pasado a sandbox para ensayos.
• Una clave de API, si vas a automatizar. Crea una con el prefijo or_live_ en la consola de desarrolladores.
• Un dispositivo o emulador limpio. Telegram entrega los códigos dentro de la aplicación a cualquier sesión ya iniciada, así que un dispositivo sin sesión previa hace predecible el camino del SMS.
• Tiempo. Cada activación permanece abierta 20 minutos; no inicies una hasta que quien prueba esté listo para escribir el número.

¿Cuándo envía Telegram realmente un código por SMS?

Telegram identifica cada cuenta por su número de teléfono. Pide un código cuando alguien registra una cuenta nueva y cuando una cuenta existente inicia sesión en un dispositivo nuevo. Si esa cuenta ya está activa en otro lugar, Telegram suele enviar el código de acceso como mensaje dentro de la sesión existente en lugar de por SMS, y por eso un número recién estrenado en un dispositivo limpio es la forma más fiable de probar el paso del SMS. También puede ofrecer una llamada o un reenvío tras una breve espera.

La verificación en dos pasos de Telegram es una contraseña de nube aparte, definida dentro de la aplicación. No es un factor por SMS, así que guarda esa contraseña en el gestor de secretos de tu equipo si la activas en una cuenta de prueba.

¿Qué países puedo elegir para Telegram y por qué importa?

El servicio telegram figura actualmente en 199 países, entre ellos India, Alemania, Brasil, Nigeria, Indonesia, Reino Unido, Ucrania, Kazajistán, Uzbekistán, Turquía, España, México, Filipinas, Vietnam y Egipto.

Adapta el país al caso de prueba. Un bot que responde en portugués debería probarse desde una cuenta brasileña; un equipo de soporte que cubre Asia Central puede querer un número kazajo. Telegram también puede tratar con más cautela los números de algunos países que los de otros, así que, si una ruta falla una y otra vez, un mercado vecino es una alternativa razonable. La disponibilidad en vivo cambia a lo largo del día, así que léela desde la API en lugar de usar una lista guardada.

¿Cómo automatizo el código de Telegram con la API?

1. Opcionalmente, confirma el coste con GET /api/v1/prices?country=<id>&service=telegram.
2. Crea el pedido: POST /api/v1/activations con {"service": "telegram", "country": "<id>"}, donde el id del país sale de GET /api/v1/countries (por ejemplo br o de).
3. Pasa el número devuelto a tu ejecutor de pruebas, que lo escribe en el cliente o emulador de Telegram.
4. Espera el código. Con webhook, escucha activation.sms_received; si no, consulta GET /api/v1/activations/{id} a un intervalo razonable.
5. Limpia con POST /api/v1/activations/{id}/cancel si la ejecución se aborta.

Con webhooks, verifica X-OTPRoute-Signature recalculando HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, rechaza las marcas de tiempo antiguas y registra cada id de activación ya procesado para que un evento reenviado se ignore. Cada cuenta dispone de hasta 5 endpoints de webhook y 300 solicitudes por minuto. La guía de pipelines de CI explica las ejecuciones en paralelo.

¿Puedo hacer los mismos pasos a mano desde el panel?

Sí. Inicia sesión, abre OTP Gateway, elige Telegram y el país, comprueba el precio y haz el pedido. Copia el número en la pantalla de teléfono de Telegram, selecciona el prefijo de país correspondiente y solicita el código. Cuando llegue el SMS aparecerá junto al pedido, listo para pegar.

El código de Telegram no llegó. ¿Qué hay en la lista de resolución de problemas?

• ¿Hay una sesión existente? Si el número se usó antes, Telegram puede haber enviado el código dentro de la aplicación. Una activación nueva lo evita.
• ¿Terminó la ventana? Deja correr el temporizador de 20 minutos. Solo pagas si el código llega; si caduca o cancelas, se reembolsa el importe completo automáticamente.
• ¿Se acepta la ruta? Telegram puede rechazar algunos números virtuales. Eso queda fuera de nuestro control y es justo la razón de la regla de reembolso.
• Reintenta con intervalos. Vuelve a pedir más tarde o en otro país; no repitas el pedido en un bucle rápido, que no ayuda ni a la entrega ni a tu límite de solicitudes.
• Revisa el prefijo de país en el dispositivo. Una discrepancia entre el país seleccionado y el número es un error fácil en las pruebas manuales.

¿Cuándo encaja mejor un Número Dedicado para Telegram?

Un número puntual de OTP Gateway sirve para pruebas de registro. Si la cuenta de Telegram tiene que volver a iniciar sesión el mes que viene, por ejemplo una cuenta de equipo que gestiona un canal de soporte o el acceso de administrador de un bot, necesita un número de teléfono que tu equipo siga controlando. Los Números Dedicados en Estados Unidos y Canadá, desde $1.95/mes, siguen siendo tuyos mientras se renuevan y reenvían los SMS entrantes al panel y a tu webhook como number.sms_received. La comparativa de números temporales frente a dedicados explica las ventajas e inconvenientes.

¿Cómo es una prueba responsable con Telegram?

Cumple las condiciones del servicio de Telegram. Crea una cuenta por persona real o finalidad de negocio, úsala para tus propios productos, bots y operaciones, y nunca para spam, creación masiva de cuentas ni para eludir un bloqueo. Cada pedido de Telegram que hagas también está cubierto por la Política de Uso Aceptable de OTP Route. Telegram es una marca comercial de su titular y OTP Route no está afiliado a ella.

Preguntas frecuentes

¿Puedo obtener un código de verificación de Telegram sin usar mi teléfono personal?

Sí. Pide un número de Telegram en OTP Gateway de OTP Route, introdúcelo en la aplicación y lee el código SMS en el panel o a través de la API.

¿Cuál es el id de servicio de Telegram en la API?

Es telegram. Combínalo con un id de país de GET /api/v1/countries al crear una activación.

¿Cuánto cuesta una verificación por SMS de Telegram para pruebas?

Desde $0.20 por código; el precio exacto depende del país y lo devuelve en vivo el endpoint de precios.

¿Por qué Telegram envió el código dentro de la aplicación en lugar de por SMS?

Telegram entrega los códigos de acceso a una sesión existente cuando hay una disponible. Usa un número nuevo y un dispositivo sin sesión iniciada para probar el camino del SMS.

¿Puedo reutilizar un número de un solo uso para volver a entrar en Telegram más tarde?

No, los números de OTP Gateway son para un único código. Para accesos repetidos, usa un Número Dedicado en EE. UU. o Canadá.

¿Me cobran si Telegram rechaza el número?

No. Si no llega ningún código al número en 20 minutos, o cancelas, el importe completo vuelve a tu monedero.

Los nombres de los servicios son marcas registradas de sus respectivos propietarios. OTP Route no está afiliado a ellos. Usa los números de forma lícita y respeta las condiciones de cada servicio y nuestra Política de Uso Aceptable.