@agentxin-ai/plugin-lark
v0.0.19
Published
Lark (Feishu) integration plugin for AgentXin AI platform.
Readme
@agentxin-ai/plugin-lark
Lark (Feishu) integration plugin for AgentXin AI platform.
Features
- Bidirectional messaging with Lark (Feishu) platform
- Webhook event handling (messages, card actions)
- Send text, markdown, and interactive card messages
- @mention detection in group chats
- Message update support (streaming)
- Middleware built-in notify tools (
LarkNotifyMiddleware)
Installation
This plugin is loaded automatically when placed in the plugins directory.
Configuration
Configure the Lark integration in the AgentXin AI admin panel:
- App ID: Your Lark app ID
- App Secret: Your Lark app secret
- Verification Token: Token for webhook verification
- Encrypt Key: Key for message encryption (optional)
- Is Lark: Set to true for international Lark, false for Feishu (China)
Webhook URL
POST /api/lark/webhook/:integrationIdMigration
feishu_create_message(builtinfeishu_messagetoolset inserver-ai) is deprecated.- Use
LarkNotifyMiddlewaretools instead:lark_send_text_notificationlark_send_rich_notificationlark_update_messagelark_recall_messagelark_list_userslark_list_chats
integrationIdis resolved from middleware config (configSchema.integrationId).- Recipient resolution priority:
- Middleware configured
recipient_id(with optionalrecipient_type, defaults toopen_id) - Tool call parameter
recipient_id(defaults toopen_idtype)
- Middleware configured
- Both middleware config and tool call support:
- Literal ID values
- System variable paths (e.g.,
runtime.chatId) - Mustache templates (e.g.,
{{channel.foo}})
- Note: UI currently only exposes
open_idas recipient_type option. Backend supports all types (chat_id,open_id,user_id,union_id,email) via direct configuration.
License
AGPL-3.0
