Tham chiếu
Chặn / bỏ chặn người này
Chặn (hoặc bỏ chặn) người của một chat riêng cho tài khoản Telegram này: người bị chặn không nhắn được cho tài khoản nữa.
Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.
Chặn (hoặc bỏ chặn) người của một chat riêng cho tài khoản Telegram này: người bị chặn không nhắn được cho tài khoản nữa.
Thông tin
| Tên | Giá trị |
|---|---|
| Mã | people.block |
| Scope cần | contacts.write |
| 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.16 |
| Trong app | Hộp thư → thông tin khách → Chặn |
Trường vào
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
conversationId |
uuid |
Có | |
blocked |
đúng/sai |
Có |
Ví dụ gọi
curl -X POST https://tlg.builera.app/api/public/v2/ops/people.block \
-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","blocked":true}'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: "people.block". Tên tool khi được liệt kê: people_block.