Tài liệu

Tham chiếu

Sửa hồ sơ bot

Đặt tên hiển thị, giới thiệu (≤ 120), mô tả hiện trong chat trống (≤ 512) và menu lệnh (tối đa 100 `{command, description}`) của bot. Do chính bot gọi Bot API; chỉ các trường được truyền mới đổi.

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

Đặt tên hiển thị, giới thiệu (≤ 120), mô tả hiện trong chat trống (≤ 512) và menu lệnh (tối đa 100 {command, description}) của bot. Do chính bot gọi Bot API; chỉ các trường được truyền mới đổi.

Thông tin

Tên Giá trị
Mã bots.update_profile
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
Trong app Bot → Sửa

Trường vào

Trường Kiểu Bắt buộc Mô tả
botId uuid Có
accountId uuid Có
name chữ Không
about chữ Không
description chữ Không
commands đối tượng[] Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/bots.update_profile \
  -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"}'

Trường ra (data)

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

Ví dụ trả về

{
  "data": {
    "ok": true
  }
}

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

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

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