/feishu-chat

Feishu Chat Tool

Feishu chat operations including group announcement reading/writing and group chat management.

Actions

Get Announcement Info

{ "action": "get_announcement_info", "chat_id": "oc_abc123def" }

Returns basic announcement information including type (doc or docx) and metadata.

Get Full Announcement

{ "action": "get_announcement", "chat_id": "oc_abc123def" }

Returns complete announcement content. Supports both old (doc) and new (docx) announcement formats.

List Announcement Blocks

{ "action": "list_announcement_blocks", "chat_id": "oc_abc123def" }

Returns all blocks for a docx-format announcement.

Get Single Announcement Block

{ "action": "get_announcement_block", "chat_id": "oc_abc123def", "block_id": "block_123" }

Returns a single block from the announcement.

Write Announcement

{ "action": "write_announcement", "chat_id": "oc_abc123def", "content": "New announcement content" }

For `doc` format: replaces the entire announcement content. For `docx` format: appends a new text block under the page root (full replacement is not supported via API; use `update_announcement_block` to edit existing blocks).

Append Announcement

{ "action": "append_announcement", "chat_id": "oc_abc123def", "content": "Additional content" }

Appends content to the announcement.

Update Announcement Block

{ "action": "update_announcement_block", "chat_id": "oc_abc123def", "block_id": "block_123", "content": "New text content" }

Updates a single block's text content in a docx-format announcement.

---

Group Chat Management

Create Group Chat

{ "action": "create_chat", "name": "My Group", "user_ids": ["ou_123", "ou_456"], "description": "Group description" }

Creates a new group chat with optional initial members and description.

Add Members to Group

{ "action": "add_members", "chat_id": "oc_abc123def", "user_ids": ["ou_123", "ou_456"] }

Adds specified users to an existing group chat.

Check Bot in Chat

{ "action": "check_bot_in_chat", "chat_id": "oc_abc123def" }

Checks if the bot is a member of the specified chat.

Delete Chat

{ "action": "delete_chat", "chat_id": "oc_abc123def" }

Deletes/disbands a group chat. The bot must have appropriate permissions (typically needs to be the group owner or have admin privileges).

**Note**: Deleting a chat will remove all members and the chat history will no longer be accessible. Use with caution.

Create Session Chat (One-Step)

{ 
  "action": "create_session_chat", 
  "name": "Project Discussion", 
  "user_ids": ["ou_123", "ou_456"],
  "greeting": "Hi everyone! Let's discuss the project here.",
  "description": "Group for project collaboration"
}

One-step operation that creates a group chat, adds users, and sends a greeting message.

---

Configuration

channels:
  feishu:
    tools:
      chat: true  # default: true

Permissions

Required for announcements:

• `im:chat.announcement:read` - View group announcement information
• `im:chat.announcement` - Edit group announcement information (for write operations)

Required for group management:

• `im:chat:readonly` - Get chat info, check bot membership (`check_bot_in_chat`)
• `im:chat` - Create and delete group chats (`create_chat`, `delete_chat`)
• `im:chat.members` - Add members to group chats (`add_members`)
• `im:message:send_as_bot` - Send messages as bot (for `create_session_chat` greeting)

**Note for delete_chat**: Requires the bot to be the group owner or have admin privileges to disband the chat.