MCP Telegram
← Quay lại Quickstart

Gửi file & voice sang Telegram

Tài liệu, ảnh, voice notes, video notes tròn, album, thậm chí stories và ảnh hồ sơ mới — bất cứ thứ gì có byte đính kèm. AI gửi chúng thay mặt bạn, từ một file bạn đã tải lên một lần, hoặc trực tiếp từ một URL https:// công khai.

1

Chọn cách đưa byte vào

Hai đường: (1) tải lên một file một lần tại mcp-telegram.com/my/upload, sao chép uploadId được trả về và tham chiếu trong các prompt; hoặc (2) đưa cho AI một URL https:// trỏ tới file — cloud sẽ fetch về (có bảo vệ SSRF, nên địa chỉ cục bộ/nội bộ bị chặn). Kích thước file tối đa khoảng 50 MB.

2

Gửi một file hoặc voice note đơn lẻ

Nói: "Gửi PDF này cho @friend" kèm uploadId hoặc URL. AI gọi telegram-send-file. Đối với tin nhắn thoại (ưu tiên OGG/Opus, M4A/MP3 cũng được) dùng telegram-send-voice. Đối với video tròn dùng telegram-send-video-note.

3

Gửi một album gồm 1-10 ảnh hoặc video

Nói: "Gửi 5 ảnh này vào chat gia đình dưới dạng album, kèm chú thích." AI gọi telegram-send-album. Mỗi mục có uploadId-hoặc-URL riêng và chú thích tùy chọn. Chú thích của mục đầu tiên xuất hiện làm chú thích album trong Telegram.

4

Đặt ảnh hồ sơ mới

Nói: "Đặt cái này làm ảnh hồ sơ Telegram của tôi" kèm uploadId hoặc URL. AI gọi telegram-set-profile-photo. Ảnh và MP4 ngắn đều hoạt động. Dùng fallback:true nếu bạn muốn ảnh được hiển thị khi tài khoản của bạn ở chế độ riêng tư.

Thử các prompt này

"Gửi file tại https://example.com/contract.pdf cho @lawyer"

"Tạo một album từ 4 ảnh tôi đã tải lên và đăng nó vào chat gia đình với chú thích 'Chuyến đi cuối tuần'"

"Đặt ảnh hồ sơ mới của tôi từ uploadId abc123"

Khắc phục sự cố

Fetch URL thất bại với "address not allowed"

Bộ chắn SSRF chặn các URL phân giải về địa chỉ IP riêng, link-local, loopback hoặc metadata. Hãy dùng URL https:// công khai, hoặc tải file lên trước qua /my/upload và tham chiếu uploadId.

File quá lớn

Mức tải lên trên cloud bị giới hạn khoảng 50 MB. Với file lớn hơn, hãy host trên máy chủ công khai và truyền URL https:// — bản thân Telegram hỗ trợ tới 2 GB, giới hạn cloud chỉ áp dụng cho bước upload.

uploadId hết hạn hoặc không tìm thấy

Các upload đang chờ chỉ được giữ trong một khoảng ngắn sau /my/upload. Nếu bạn dùng quá muộn, hãy tải lên lại và dùng uploadId mới.