Tài liệu

Tham chiếu

Đổi ảnh bot

Đặt ảnh đại diện của bot từ một ảnh đã tải lên thư mục gửi đi của tài khoản (`storagePath`), qua @BotFather /setuserpic.

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

Đặt ảnh đại diện của bot từ một ảnh đã tải lên thư mục gửi đi của tài khoản (storagePath), qua @BotFather /setuserpic.

Thông tin

Tên Giá trị
Mã bots.set_photo
Scope cần bots.manage
Mức Ghi
Có thể cần xác nhận Không
Kiểu chạy Trả kết quả ngay
Cần Idempotency-Key Không
Vai trò thành viên được phép owner, manager, agent
Cần máy chạy từ bản 1.0.37
Trong app Bot → Đổi ảnh

Trường vào

Trường Kiểu Bắt buộc Mô tả
botId uuid Có
accountId uuid Có
storagePath chữ Có

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/bots.set_photo \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"botId":"00000000-0000-0000-0000-000000000000","accountId":"00000000-0000-0000-0000-000000000000","storagePath":"…"}'

Trường ra (data)

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

Ví dụ trả về

{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000"
  }
}

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: "bots.set_photo". Tên tool khi được liệt kê: bots_set_photo.

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

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