| name | lark-im |
| version | 1.0.0 |
| description | 飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件（支持大文件分片下载）、管理表情回复、发送应用内/短信/电话加急。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据时使用。 |
| metadata | {"requires":{"bins":["lark-cli"]},"cliHelp":"lark-cli im --help"} |
im (v1)
Core Concepts
- Message: A single message in a chat, identified by
message_id (om_xxx). Supports types: text, post, image, file, audio, video, sticker, interactive (card), share_chat, share_user, merge_forward, etc.
- Chat: A group chat or P2P conversation, identified by
chat_id (oc_xxx).
- Thread: A reply thread under a message, identified by
thread_id (om_xxx or omt_xxx).
- Reaction: An emoji reaction on a message.
- Flag: A bookmark on a message or thread.
Resource Relationships
Chat (oc_xxx)
├── Message (om_xxx)
│ ├── Thread (reply thread)
│ ├── Reaction (emoji)
│ └── Resource (image / file / video / audio)
└── Member (user)
Important Notes
Identity and Token
All IM operations run as user identity with a user_access_token. Calls run as the authorized end user, so permissions depend on both the app scopes and that user's own access to the target chat/message/resource.
