Lark Skills cần một số quyền truy cập để tương tác với các tính năng của LarkSuite. Bạn phải thêm các OAuth scopes này vào ứng dụng vừa tạo.
Cách thêm scopes
Mở trang Permission & Scope
Trong Developer Console, vào ứng dụng của bạn → tab “Permission & Scope” (hoặc “API Scopes”)
Tìm kiếm và thêm từng scope
Dùng ô tìm kiếm, gõ tên scope và bấm “Add” (Thêm). Lặp lại cho từng scope trong danh sách bên dưới.
Lưu và publish lại
Sau khi thêm xong tất cả scopes, bấm “Save”. Nếu app đã publish, tạo version mới và publish lại để scopes có hiệu lực.
Danh sách scopes theo nhóm
Lịch (Calendar)
Công việc (Task)
Tin nhắn (Messenger)
Liên hệ (Contacts)
Tài liệu & Drive
Bảng tính & Base
| Scope | Mô tả |
|---|
calendar:calendar | Đọc và ghi lịch |
calendar:calendar:readonly | Chỉ đọc lịch |
| Scope | Mô tả |
|---|
task:task | Tạo, sửa, xoá task |
task:task:readonly | Chỉ đọc task |
| Scope | Mô tả |
|---|
im:message | Đọc và gửi tin nhắn |
im:message:send_as_bot | Gửi tin nhắn dưới dạng bot |
im:chat | Quản lý nhóm chat |
im:chat:readonly | Chỉ đọc nhóm chat |
| Scope | Mô tả |
|---|
contact:user.base:readonly | Đọc thông tin cơ bản người dùng |
contact:department.base:readonly | Đọc thông tin phòng ban |
contact:user.employee_id:readonly | Đọc mã nhân viên |
| Scope | Mô tả |
|---|
docx:document | Tạo và chỉnh sửa Lark Docs |
docx:document:readonly | Chỉ đọc Lark Docs |
drive:drive | Quản lý Lark Drive |
drive:drive:readonly | Chỉ đọc Lark Drive |
drive:file | Tải lên và tải xuống file |
wiki:wiki | Tạo và chỉnh sửa Wiki |
wiki:wiki:readonly | Chỉ đọc Wiki |
| Scope | Mô tả |
|---|
sheets:spreadsheet | Đọc và ghi Lark Sheets |
bitable:app | Quản lý Lark Base |
bitable:app:readonly | Chỉ đọc Lark Base |
Danh sách đầy đủ (copy-paste)
Dùng danh sách này để kiểm tra nhanh:
calendar:calendar
calendar:calendar:readonly
task:task
task:task:readonly
im:message
im:message:send_as_bot
im:chat
im:chat:readonly
contact:user.base:readonly
contact:department.base:readonly
contact:user.employee_id:readonly
docx:document
docx:document:readonly
drive:drive
drive:drive:readonly
drive:file
wiki:wiki
wiki:wiki:readonly
sheets:spreadsheet
bitable:app
bitable:app:readonly
Một số scope có thể cần Admin của tổ chức phê duyệt trước khi có hiệu lực. Nếu gặp lỗi permission denied sau khi cài xong, hãy kiểm tra trạng thái phê duyệt trong Developer Console.
Bạn không cần thêm tất cả scopes nếu chỉ dùng một số tính năng nhất định. Tuy nhiên, khuyến nghị thêm đủ để tránh phải cập nhật lại sau.
