MCP Telegram
← Volver al inicio rápido

Enviar archivos y voz a Telegram

Documentos, fotos, notas de voz, video notes, álbumes e incluso historias y una nueva foto de perfil — todo lo que tenga bytes adjuntos. La IA los envía en su nombre, ya sea desde un archivo subido una vez o directamente desde una URL https:// pública.

1

Elija cómo llegan los bytes

Dos caminos: (1) suba un archivo una sola vez en mcp-telegram.com/my/upload, copie el uploadId devuelto y referéncielo en sus prompts; o (2) dé a la IA una URL https:// que apunte al archivo — la cloud la descargará (con protección SSRF, así que las direcciones locales/internas están bloqueadas). El tamaño máximo es de unos 50 MB.

2

Envíe un único archivo o una nota de voz

Diga: «Envía este PDF a @friend» con el uploadId o la URL. La IA llama a telegram-send-file. Para mensajes de voz (preferiblemente OGG/Opus; M4A/MP3 también valen) use telegram-send-voice. Para video notes (vídeos redondos) use telegram-send-video-note.

3

Envíe un álbum de 1 a 10 fotos o vídeos

Diga: «Envía estas 5 fotos a mi chat de familia como un álbum, con leyendas». La IA llama a telegram-send-album. Cada elemento lleva su propio uploadId-o-URL y una leyenda opcional. La leyenda del primer elemento aparece como leyenda del álbum en Telegram.

4

Establezca una nueva foto de perfil

Diga: «Pon esto como mi foto de perfil de Telegram» con un uploadId o una URL. La IA llama a telegram-set-profile-photo. Funcionan tanto imágenes como MP4 cortos. Use fallback:true si quiere que la foto se vea cuando su cuenta sea privada.

Pruebe estos prompts

"Envía el archivo en https://example.com/contract.pdf a @lawyer"

"Haz un álbum con las 4 fotos que he subido y publícalo en el chat de la familia con la leyenda 'Viaje de fin de semana'"

"Pon mi nueva foto de perfil desde el uploadId abc123"

Resolución de problemas

La descarga de la URL falló con «address not allowed»

La protección SSRF bloquea las URL que resuelven a direcciones IP privadas, link-local, loopback o de metadatos. Use una URL https:// pública, o suba primero el archivo a través de /my/upload y referencie el uploadId.

Archivo demasiado grande

Las subidas en la cloud están limitadas a unos 50 MB. Para archivos más grandes, hospédelos en un servidor público y pase la URL https:// — Telegram en sí admite hasta 2 GB; el límite de la cloud solo afecta al paso de subida.

uploadId expirado o no encontrado

Las subidas pendientes se conservan solo durante una ventana corta tras /my/upload. Si tardó demasiado en usarlo, vuelva a subirlo y use el nuevo uploadId.