Inicio rápido: de cero a funcionando, sin saltarte ningún paso

🧾 Lista de verificación

• Telegram Premium — las funciones de Telegram Business en las que se apoya LingoDesk (relé de mensajes a un bot) son exclusivas de Premium. Sin Premium nada de esto funciona.
• Un teléfono — eso es todo lo que necesita el modo alojado en la nube (el predeterminado): haz los pasos 1–3 en tu teléfono, envíanos el token, listo.
• Solo para auto-alojamiento: Node.js ≥ 20 (o Docker), una API Key de Anthropic y un ordenador/servidor siempre encendido. El código es gratis y de código abierto en GitHub.

1Crea tu bot en BotFather

En Telegram, busca @BotFather (fíjate en la insignia azul de verificación) y ten esta conversación:

• El «nombre» es solo un nombre para mostrar; el «username» debe ser globalmente único y terminar en bot — si está ocupado, prueba otro.
• Esa cadena digits:letters de la última respuesta es tu BOT_TOKEN. Cópiala en un lugar seguro. Es en efecto la contraseña del bot — nunca la compartas.

1a. Activa el Secretary Mode (obligatorio; antes «Business Mode»)

⚠️ En mayo de 2026 Telegram renombró este interruptor a Secretary Mode; los clientes antiguos pueden seguir etiquetándolo como Business Mode — es lo mismo. Haz esto dentro del chat de @BotFather (no en la página de perfil de tu bot, ni en los ajustes de Telegram de tu teléfono). Dos interfaces — cualquiera sirve:

Interfaz ① Comandos clásicos — simplemente envía mensajes:

Interfaz ② Nuevo panel de gestión — toca el botón azul Open junto al cuadro de mensajes de BotFather:

1b. Desactiva la Privacidad de grupo (obligatorio)

2Vincula el bot en Telegram Business

En la app móvil de Telegram (este ajuste actualmente solo existe en móvil):

En los clientes más nuevos este elemento se llama «Chat Automation» — etiqueta diferente, mismo acceso.

1. Escribe el username de tu bot (p. ej. my_lingodesk_bot) en el cuadro de búsqueda y selecciónalo.
2. Permisos: activa «Reply to messages» — sin ello el bot puede leer pero nunca enviar en tu nombre.
3. Para «qué chats», elige All 1:1 Chats; añade a la lista de Excluded Chats cualquier contacto privado que quieras mantener fuera del relé.

3Crea tu grupo foro de consola

Este grupo es tu mesa de trabajo: un tema por contacto, con tarjetas de mensaje bilingües apareciendo dentro.

1. Crea un grupo: Nuevo → Nuevo grupo, añade tu bot como único miembro (busca su username). Ponle el nombre que quieras, p. ej. «LingoDesk Console».
2. Activa los temas (Topics): abre el grupo → toca el nombre para su perfil → Editar → activa Topics. El grupo se convierte en supergrupo y obtiene una lista de temas.
3. Asciende el bot a administrador: perfil → Administradores → Añadir admin → tu bot → marca «Manage Topics» (deja el resto por defecto) → guardar.

4Elige una: ☁️ Alojado en la nube o 💻 Auto-alojado

Todo lo del lado del teléfono está hecho. Ahora elige tu ruta — ¿sin servidor? Elige la A: nada que instalar.

☁️ Opción A · Alojado en la nube (recomendado: sin servidor, sin código, instantáneo)

1. Envía un mensaje directo al bot oficial de activación @LingoDeskbot, manda /start y luego pega el BOT_TOKEN del Paso 1 directamente en el chat.
2. Activación automática instantánea: en cuanto el token se valida responde «🎉 Activado» (y borra el mensaje con tu token). El plan Gratis cubre 300 respuestas traducidas/mes; pásate a Pro (500 ⭐/mes) cuando quieras para ilimitado. El motor de traducción corre por nuestra cuenta — sin API keys que registrar.
3. Sigue su respuesta para terminar la vinculación, luego envía /bind en tu grupo de consola — el bot responde «✅ vinculado» y ya está. Salta al Paso 5 para probar. Envíale /status por mensaje directo cuando quieras, o /native en para fijar tu propio idioma.

💻 Opción B · Auto-alojado (tu propia máquina, tus propios datos)

Primero consigue una clave de traducción en console.anthropic.com → API Keys → Create Key (sk-ant-…; unos pocos dólares de crédito duran mucho tiempo a ~$0.001 por mensaje). Luego:

Una vez que veas el banner, envía /bind en tu grupo de consola para vincularlo (el ID del grupo y tu ID de usuario se detectan automáticamente — sin números que buscar). En un servidor, Docker es un solo comando: docker compose up -d — consulta el README de GitHub.

5Chat de prueba

Desde una cuenta de Telegram distinta (una segunda cuenta o un amigo), envía un mensaje directo en un idioma extranjero a tu cuenta personal (¡no al bot!) — di, por ejemplo, «Hola, ¿cuánto cuesta?» en español. En segundos, en tu grupo de consola debería aparecer un tema nuevo con el nombre del remitente:

Toca «✅ Enviar al cliente» — el otro lado ve tu cuenta personal respondiendo en español fluido. Todo el ciclo ya está en marcha 🎉

• Las fotos, archivos y mensajes de voz que envían se reenvían al tema y se archivan automáticamente.
• ¿Idioma detectado incorrecto? Envía /lang es en el tema para corregirlo; /help lista todos los comandos.
• Responder manualmente desde tu teléfono también está bien — el bot lo registra en el archivo del tema.
• Tú también puedes iniciar conversaciones — no hace falta esperarlos. Escribe a cualquiera desde tu cuenta real (aunque sea solo un «hola») y aparecen al instante en la consola con un tema creado; a partir de ahí, escribe aquí en tu idioma para seguir chateando con ellos.

🔧 Solución de problemas