Connector — Multi-Platform IM Integration
Connector is the channel through which Digital Employees connect to external instant messaging (IM) platforms. Through Connectors, a Digital Employee can receive and reply to messages on platforms such as Feishu and WeCom, extending its capabilities into everyday office IM.
Overview
A Connector is bound to a Digital Employee: messages received by the published platform account are routed to the bound Digital Employee for processing.
Currently supported platforms:
| Platform | Type | Description |
|---|---|---|
| Feishu | feishu | Self-built app on the Feishu Open Platform (WebSocket long connection) |
| WeCom | wecom | WeCom group bot |
More platforms (DingTalk, WeChat, Email) are planned.
Creating a Connector
Connectors are created under the Connector menu item in the Digital Employee detail page (the Digital Employee must be published first).
Click New Connector, select the platform type, and fill in the corresponding configuration:
Feishu
First create a self-built app on the Feishu Open Platform and obtain:
- App ID: application credential (format
cli_xxxxx) - App Secret: application secret
- Verification Token (optional): verification token for event subscription
After creation, configure the callback URL in the Feishu Open Platform event subscription (for verification) or enable long-connection mode. The platform receives Feishu message events via WebSocket long connection.
WeCom
First create a WeCom group bot and obtain:
- Bot ID: bot ID
- Secret: bot secret
Default Workstation (dynamic mode)
If the Digital Employee is in dynamic mode, you can select a Default Workstation: tool calls for messages received by this Connector are executed on the specified workstation.
Managing Connectors
The Connector list shows name, type, bound Digital Employee, enabled status, running status, and creator.
For each Connector you can:
- Start / Stop: control the running state (stopped Connectors no longer receive messages)
- Enable / Disable: control whether the configuration takes effect (disabling automatically stops first)
- Delete: remove the Connector (attempts to stop first)
Administrator View
Tenant administrators can view all Connectors in the tenant and perform the same management actions on the Connectors page in the admin panel.
Message Capabilities
Connectors support the following message types:
- Text messages: regular conversation
- Image messages: images are downloaded automatically for the Digital Employee to understand (Feishu downloads via the message resource endpoint)
- File messages: files are downloaded automatically (Feishu downloads via the message resource endpoint)
- Quoted messages: WeCom supports quoted message context
Group Chat
Multiple bots can be configured in the same group chat (multiple Connectors of the same Digital Employee or multiple Digital Employees). The system maintains an independent session context for each bot to avoid message cross-talk.
Scheduled Task Notifications
Scheduled task results of a Digital Employee can be pushed to the IM platform through a Connector (select the notification channel when configuring the scheduled task).