Cómo obtener tu api_id y api_hash de Telegram

Tu api_id y tu api_hash de Telegram los da Telegram, no TelegramBuddy. Inicia sesión en my.telegram.org con tu número de teléfono, abre API development tools, rellena un formulario corto que describe la app que vas a usar y la página te entrega dos cosas: un número llamado api_id y una cadena de 32 caracteres llamada api_hash. Pega ambos en la pantalla de primer inicio de TelegramBuddy y la configuración queda hecha. Los valores se guardan en tu propia computadora y no te los volverá a pedir.

Esa es la respuesta corta. El resto de esta página explica qué son esos dos valores, qué no son, por qué una app no puede llegar sin más con un par ya rellenado y qué hacer si el formulario del sitio de Telegram te da problemas.

Qué son realmente el api_id y el api_hash

Telegram publica una API: un conjunto documentado de instrucciones que permite a otros programas hablar directamente con su red, igual que lo hacen las apps oficiales. Quien escribe un programa así tiene que registrarlo una vez. El registro produce un par de valores que viajan con cada solicitud que hace el programa, para que Telegram pueda saber qué software está al otro lado de la línea.

Eso es todo lo que son. Identifican la aplicación, no a ti. Tu nombre, tus chats y tus contactos no están en ellos, y no son una licencia, una suscripción ni nada que se pague.

Vale la pena ser preciso sobre lo que no son:

• No son tu contraseña de Telegram. Nadie puede leer tus mensajes solo con un api_id y un api_hash. Iniciar sesión en tu cuenta es un paso aparte, descrito más abajo.
• No son un token de bot. Un bot es una cuenta propia, con su propio conjunto de chats. TelegramBuddy no es un bot: inicia sesión como tú y, por tanto, ve exactamente los chats que tú ya ves.
• No los emite TelegramBuddy. No hay cuenta de TelegramBuddy ni servidor de TelegramBuddy, así que no hay nada de nuestro lado que pudiera darte un par ni guardar una copia del tuyo.

Cómo obtener tu api_id y tu api_hash de Telegram

Todo el proceso ocurre en el sitio web de Telegram y toma un par de minutos.

1. Abre my.telegram.org en cualquier navegador.
2. Escribe tu número de teléfono en formato internacional, empezando por un + y el código de tu país.
3. Telegram envía el código de acceso como un mensaje dentro de Telegram, no como SMS. Abre Telegram en tu teléfono o en el escritorio, lee el código e introdúcelo en la página.
4. En la página que aparece, haz clic en API development tools.
5. Rellena el formulario corto (los campos se explican más abajo) y envíalo.
6. La página muestra ahora App api_id y App api_hash. Nadie revisa ni aprueba nada; los valores existen en cuanto se envía el formulario.
7. Copia ambos en la pantalla de primer inicio de TelegramBuddy. Si cierras la pestaña demasiado pronto, al volver a API development tools verás el mismo par otra vez.

Cómo rellenar el formulario

El formulario pregunta por una app, lo que resulta raro cuando solo estás intentando usar una. Aquí nada se comprueba contra nada, así que respuestas sencillas y honestas valen:

• App title y Short name: cualquier cosa que reconozcas después, como My Downloader. El nombre corto quiere letras y números sin espacios.
• URL: opcional. Déjalo vacío.
• Platform: elige Desktop.
• Description: opcional. Unas pocas palabras, o nada.

api_id, inicio de sesión de la cuenta y token de bot: las diferencias

Estos tres se confunden constantemente, y mezclarlos es la razón habitual de que una pantalla de configuración se niegue a avanzar.

	Qué identifica	De dónde viene	Si lo consigue otra persona
api_id y api_hash	El software que hace las solicitudes	my.telegram.org, una sola vez, gratis	Puede hacer solicitudes que cuentan contra tus límites de uso
Tu inicio de sesión de Telegram	A ti, el titular de la cuenta	Un código QR o un código enviado a tu Telegram	Podría leer tus chats, así que este es el que más importa
Un token de bot	Una cuenta de bot aparte	El BotFather de Telegram	Controla ese bot, que no es tu cuenta

Por qué cada instalación debería tener su propio par

Telegram cuenta los límites de uso contra el api_id. Cuando un programa pide demasiado y demasiado rápido, Telegram responde con un flood wait —una pausa de unos segundos a unos minutos antes de volver a responder— y esa pausa queda asociada al id que hizo las solicitudes.

Comparte un mismo api_id entre miles de instalaciones y el tráfico de todo el mundo cae en el mismo cubo: una persona que se baja una década de video ralentiza a todos los demás, y un solo id restringido tumbaría con él a todas las instalaciones. Tu propio par mantiene tus límites como tuyos. Son dos minutos de trabajo, una sola vez, a cambio de no verte afectado por desconocidos. La página de descarga expone el mismo razonamiento de forma más breve.

Los flood waits son normales y esperables, no una señal de que algo se haya roto. TelegramBuddy los espera y continúa por su cuenta, y por eso también se puede dejar sola una descarga masiva larga; reanudar descargas interrumpidas entra en qué ocurre cuando una transferencia se detiene por otros motivos.

Si usas TelegramBuddy en dos computadoras, darle a cada una su propio par evita que sus límites se solapen.

Cómo mantener privados los dos valores

Trata el api_hash como tratarías cualquier clave. No lo publiques en un hilo de un foro, en un informe de errores ni en un repositorio de código público, y recorta o difumina antes de compartir una captura de la pantalla de configuración. El api_id es un número corto y mucho menos sensible, pero no hay razón para publicar ninguno de los dos.

Si un par se filtra, el daño es limitado e indirecto: las solicitudes de otra persona contarían contra tus límites de uso, lo que significa descargas más lentas para ti. Aun así no podrían tocar tus mensajes sin el inicio de sesión de tu cuenta. Puedes crear un par nuevo en my.telegram.org e introducir ese en su lugar.

En tu propia máquina los valores están en los ajustes de TelegramBuddy, y no se envían a ninguna parte salvo a Telegram, como parte de las solicitudes que existen para identificar.

Iniciar sesión en tu cuenta es un paso aparte

Una vez puestas las credenciales, TelegramBuddy te pide iniciar sesión en tu propio Telegram, ya sea escaneando un código QR con el teléfono o introduciendo tu número y el código que Telegram te envía. Ese inicio de sesión se convierte en un archivo de sesión en tu computadora. Nunca se sube a ninguna parte, porque no hay ningún sitio al que subirlo: la app habla directamente con Telegram y escribe los archivos descargados directamente en tu disco.

Así que las dos mitades de la configuración hacen trabajos distintos. El api_id y el api_hash dicen qué programa está llamando. El inicio de sesión dice en nombre de quién. Ninguno de los dos da a nadie acceso al otro, y las preguntas frecuentes responden al resto de las dudas de privacidad que suelen venir después.

Si el formulario te da problemas

• La página muestra un error al enviarlo. Espera un rato e inténtalo de nuevo, idealmente en una ventana privada o en otro navegador, con cualquier bloqueador de anuncios o de scripts pausado para el sitio.
• No llega el código de acceso. Búscalo dentro de Telegram, no en tu bandeja de SMS. El código llega como un mensaje de Telegram en la app.
• La app dice que las credenciales son incorrectas. Busca algún espacio suelto al principio o al final de cualquiera de los dos valores. El api_id son solo dígitos. El api_hash tiene exactamente 32 caracteres, entre letras y números.
• No encuentras dónde quedaron los valores. Abre API development tools otra vez en my.telegram.org; la app que registraste sigue ahí con su par.

Siguientes pasos

Con las credenciales introducidas y la sesión de tu cuenta iniciada, la app puede abrir cualquier chat del que seas miembro, incluidos los canales y grupos privados a los que se llega con un enlace de invitación. Desde ahí puedes recorrer todo el historial, descargar archivos en bloque o exportar los mensajes de un chat a HTML o JSON. Un recorrido por lo que hace la app está en la página de funciones. Algo que vale la pena decir con claridad: la app guardará con gusto todo lo que puedas ver, así que conserva solo lo que tengas derecho a conservar.