Gửi tệp qua trợ lý

#Mục tiêu

Bạn đưa một tệp vào Telegram-Auto để một tài khoản gửi đi, đăng story, đặt ảnh đại diện hoặc dùng trong bước "gửi tệp" của chiến dịch. Ứng dụng tự kiểm tra tệp (kích thước thật, loại tệp theo byte đầu, SHA-256) trước khi cho dùng.

#Quyền cần

• messages.send cho cả bốn thao tác tệp và cho việc gửi.
• Tài khoản dùng tệp phải nằm trong phạm vi kết nối.
• Với chiến dịch: quyền sửa chiến dịch đó.

#Hỏi người trước khi

Hỏi người muốn gửi tệp nào, cho ai, từ tài khoản nào. Không tải lên tệp người chưa đưa cho bạn, và không lấy tệp từ máy hay thư mục riêng của người khác.

#Kiểm trước

Gọi whoami. Chọn purpose đúng việc:

Mỗi kết nối giữ tối đa 20 tệp đang chờ tải và 50 tệp sẵn sàng chưa dùng.

#Các bước

Có hai cách đưa byte vào. Cả hai kết thúc ở cùng một bước kiểm.

Cách A — tải lên trực tiếp (bạn có byte của tệp):

1. Gọi files.create_upload với purpose, accountId (hoặc campaignId), fileName, mime, size.
2. Gửi PUT nguyên byte tới uploadUrl, kèm đúng headers trong câu trả lời, trước completeBefore (2 giờ).
3. Gọi files.complete_upload với uploadId. Gọi lại an toàn nếu mạng chập chờn.

Cách B — liên kết công khai (tệp đã có trên mạng):

1. Gọi files.import_url với url HTTPS công khai (cổng 443, không có tên/mật khẩu trong liên kết, không chuyển hướng, tải xong trong 20 giây). Ứng dụng ChatGPT có thể truyền thẳng tham số tệp file: { download_url, file_name, mime_type }.

Sau đó:

4. Khi trạng thái là ready, lấy storagePath. Có thể xem lại bằng files.status.
5. Đặt storagePath vào thao tác cần dùng, ví dụ messages.send_media (kèm Idempotency-Key).
6. Theo dõi việc gửi bằng operations_get.

#Kiểm sau

Một tệp dùng một lần: sau khi gửi, trạng thái thành used và không gửi lại được bằng cùng storagePath. Muốn gửi lại, tải tệp lên lần nữa. Tệp sẵn sàng mà không dùng sẽ bị xoá sau 24 giờ.

#Khi lỗi

Không đổi đuôi tệp để lách bước kiểm.

#Điều kiện dừng

Dừng khi tệp đã gửi xong, khi tệp bị từ chối mà người chưa đưa tệp khác, hoặc khi người chưa xác nhận việc gửi.