KocoroLark / Feishu Integration Guide
Connect a Kocoro agent to Lark / Feishu through a Lark / Feishu agent bot app, so your team can talk to your agent directly in one-on-one or group chats. The whole flow takes about 3 minutes.
Before you begin
- A Lark / Feishu account allowed to create apps.
- Kocoro installed and initialized, with at least one agent created.
- A Mac kept running to host the long-lived connection (no public IP or domain required).
- 1
Create an agent app
Open the one-click app-creation page on the Lark / Feishu developer platform, pick an avatar, enter an app name, and click "Create". You can use the buttons at the bottom of this page to jump straight there.
- Lark: https://open.larksuite.com/page/launcher?from=backend_oneclick
- Feishu: https://open.feishu.cn/page/launcher?from=backend_oneclick
Fig. 1 — Create an agent app on the developer platform. - 2
Copy the App ID and App Secret
Once the app is created, its App ID and App Secret are shown. Copy and paste them into Kocoro.
Keep the App Secret safe — if it leaks, reset it on the app's Credentials & Basic Info page.Fig. 2 — Copy the App ID and App Secret. - 3
Register the bot in Kocoro
Open Kocoro, go to Capabilities → Connectors, and click "Add Bot" under "Lark" / "Feishu". Paste the App ID and App Secret, choose the agent that should answer incoming messages, optionally set a display name, then click "Register Bot".
- Once registered, the bot connects to Kocoro instantly over a long-lived connection — message it in Lark / Feishu and the selected agent replies.
- You can click Refresh on the Connectors page anytime to check the connection, or click the trash icon to remove the bot.
Fig. 3 — Paste the credentials and register the bot in Kocoro. - 4
Enable user basic info
After registration succeeds, Kocoro prompts you to enable user basic info — this lets usernames display correctly in conversation titles. Click "Open permissions page" to jump to the Lark / Feishu permission settings.
Fig. 4 — After registering, enable user basic info. - 5
Add the "Obtain user's basic information" scope
On the permissions page, search for and select "Obtain user's basic information (contact:user.base:readonly)", then click "Add Scopes".
contact:user.base:readonlyFig. 5 — Add the "Obtain user's basic information" scope. - 6
Publish the app to apply the changes
Go to "Version Management & Release", set the availability scope and click "Save" to create a version and publish. The scope change only takes effect after the app is published (and admin-approved).
If the banner says "The changes will take effect after the current version is published", this step is required.Fig. 6 — Save and publish the app under Version Management & Release.
Done — start using it in Lark / Feishu
After the app is published and connected, members within the visibility scope can message the bot in Lark / Feishu, or @mention it in a group, and the selected agent replies. To use it in a group, add the bot to that group.