Guía de uso del proxy de cuenta de Telegram

Esto no es un bot de la API de Telegram. No lo uses para mensajes basura, envío masivo en frío ni para eludir las restricciones de Telegram. Antes de enviar, editar o eliminar contenido a terceros, tu Agent debe obtener una confirmación explícita.

​

Implementación e inicio de sesión

1. Crea un proxy de cuenta de Telegram en Consola → Aplicaciones, activa la suscripción y haz clic en implementar. Los recursos de la instancia son configurados automáticamente por la plataforma.
2. Cuando la instancia esté lista, haz clic en «Generar código QR de inicio de sesión». El código QR es válido por poco tiempo y puede generarse de nuevo tras caducar.
3. Abre en Telegram Configuración → Dispositivos → Vincular dispositivo de escritorio y escanea el código QR.
4. Si el estado cambia a password_required, introduce la contraseña de verificación en dos pasos de Telegram en la consola. La contraseña solo se envía a la instancia de tu tenant y no se escribirá en la configuración de la plataforma.
5. Cuando el estado cambie a authenticated, la consola mostrará la cuenta actual, la dirección MCP y el token de acceso Bearer.

​

Autenticación y comprobación de estado

Authorization: Bearer <访问令牌>

curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/health
curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/readyz

{"status":"ok"}

{"status":"ready","gateway_connected":true,"login_state":"login_required"}

​

Conectar un cliente MCP

​

Claude Code

claude mcp add \
  --transport http \
  --header "Authorization: Bearer <访问令牌>" \
  telegram \
  https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/mcp

​

Clientes como Cursor que admiten encabezados de solicitud estáticos

{
  "mcpServers": {
    "telegram": {
      "type": "http",
      "url": "https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer <访问令牌>"}
    }
  }
}

​

Herramientas MCP

​

API REST

​

Ejemplos

# 当前账号
curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/whoami \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN"

# 最近会话
curl "https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/chats?limit=20&unread_only=false" \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN"

# 给 Saved Messages 发一条测试消息
curl -X POST https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/messages \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"me","text":"Hello from my Telegram proxy"}'

​

Interfaces completas

​

Preguntas frecuentes

• 401: El token Bearer falta o es incorrecto. Confirma que el token esté en la cabecera de la solicitud, no en los parámetros de consulta de la URL.
• 503: El token de acceso del proxy no está configurado, o el cliente de Telegram aún no está listo. Primero verifica /readyz; si el token de acceso del proxy no está configurado, las interfaces protegidas también devolverán 503.
• 400: Los parámetros o el JSON no son válidos; la búsqueda debe proporcionar q, y limit debe ser un entero mayor o igual a 1.
• 403 / 404: La cuenta actual no tiene permisos, o el ID de target / message no existe.
• 429: Se ha activado el límite de frecuencia de Telegram. Lee retry_after y espera, no reintentes de forma concurrente.
• El código QR sigue sin completarse: Vuelve a generar el código QR y confirma que estás utilizando la entrada de escaneo «Vincular dispositivo de escritorio» de Telegram.
• Se solicita volver a iniciar sesión después de reiniciar: Verifica si el volumen persistente de la instancia funciona correctamente; será necesario volver a escanear después de cerrar sesión activamente, revocar la sesión en la lista de dispositivos de Telegram o cuando la sesión expire.

​

Alcance de la verificación