Tài liệu

Tham chiếu

Gửi album ảnh / video

Gửi 2–10 ảnh / video (đã tải lên thư mục gửi đi của tài khoản) thành một album Telegram, chú thích ở tệp đầu. Cùng cửa gửi như tệp lẻ.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

Gửi 2–10 ảnh / video (đã tải lên thư mục gửi đi của tài khoản) thành một album Telegram, chú thích ở tệp đầu. Cùng cửa gửi như tệp lẻ.

Thông tin

Tên Giá trị
Mã messages.send_album
Scope cần messages.send
Mức Ghi
Có thể cần xác nhận Không
Kiểu chạy Xếp việc cho máy chạy
Cần Idempotency-Key Có
Vai trò thành viên được phép owner, manager, agent
Cần máy chạy từ bản 1.0.15
Trong app Hộp thư → ô soạn → chọn nhiều ảnh

Trường vào

Trường Kiểu Bắt buộc Mô tả
conversationId uuid Có
items đối tượng[] Có
caption chữ Không
topicId số nguyên Không
inReplyToEventId chữ Không
ifLastMessageId uuid Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/messages.send_album \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000","items":[]}'

Trường ra (data)

Trường Kiểu Bắt buộc
ok true Có
jobId chữ Có
messageIds chữ[] Có

Ví dụ trả về

{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000",
    "messageIds": [
      "text"
    ]
  }
}

Dùng qua MCP

Không có tên sẵn trong profile nào: gọi tools_describe rồi tools_run với code: "messages.send_album". Tên tool khi được liệt kê: messages_send_album.

Trang này có hữu ích không?

Kiểm lại lần cuối: 24/10/2026 · bản 2.0