Skip to main content

​
Feishu

Use Feishu when your team already works in Feishu or Lark and you want Fased to join those conversations through the platform’s bot APIs. Status: bundled channel extension for Feishu and Lark workspaces. It supports the common bot flow, account-aware config, pairing, and group controls.

​
Setup from Agent > Channels

Open Agents, select the Agent, then use Agent > Channels > Feishu. You need:
  • App ID
  • App Secret
  • domain: feishu or lark
  • event subscription enabled in the platform console
  • bot capability enabled and published/available to the workspace
Restart the gateway if the UI reports that the runtime still needs to load.

​
Quick setup

  1. Create an enterprise app in Feishu Open Platform or Lark Developer Console.
  2. Copy App ID and App Secret.
  3. Enable bot capability.
  4. Configure event subscription for message events.
  5. Publish or make the app available to the workspace.
  6. Save credentials in Agent > Channels > Feishu.
  7. Start or restart the gateway and send a test message.
Config shape: 
{
  channels: {
    feishu: {
      enabled: true,
      appId: "cli_xxx",
      appSecret: "secret",
      domain: "feishu",
      dmPolicy: "pairing",
      groupPolicy: "allowlist",
    },
  },
}
Lark tenants should use domain: "lark".

​
Permissions

Enable only the permissions your bot flow needs. Typical needs:
  • receive messages
  • send messages
  • bot menu or bot capability where required
  • user/chat id lookup if you want allowlist resolution
Keep app secrets private and rotate them if exposed.

​
Access model

AreaRecommended start
DMspairing or allowlist
Groupsallowlist plus mention gating
IDsuse stable user/chat ids where possible
Multi-accountconfigure distinct account names and credentials

​
Runtime behavior

  • The channel keeps a long-lived event connection.
  • Incoming messages route to the selected Agent/session.
  • Task commands create Agent-owned Tasks.
  • Delivery returns through the Feishu/Lark bot API.

​
Troubleshooting

SymptomCheck
Bot receives nothingEvent subscription, app publish state, bot capability.
Send failsApp secret, app id, permissions, target id.
Group messages ignoredGroup policy, mention requirement, chat allowlist.
Lark tenant failsdomain: "lark" and correct developer console.