Feishu / Lark
Anyy supports two Feishu/Lark connection profiles. Long connection is the default and avoids a public webhook. Webhook is available when your deployment requires HTTP event delivery.
Choose a Profile
| Profile | Required credentials | Public HTTPS |
|---|---|---|
Long connection (feishu.websocket.v1) | App ID, App Secret | No |
Webhook (feishu.webhook.v1) | App ID, App Secret, Verification Token, Encrypt Key | Yes |
Use the platform's official overview for the current app console.
Platform Prerequisites
For either profile:
- create an app and enable bot capability;
- grant the required bot messaging permissions; and
- subscribe to message events.
Then choose long-connection delivery or webhook delivery to match the Anyy profile.
Connect
Open Dashboard → Channel → Add account, choose Feishu / Lark, and enter the fields for the selected profile. Direct messages default to pairing; groups default to mention.
Creation and switching between connection profiles are handled by the CLI setup flow:
anyy setup channel feishu
Dashboard and the resident TUI can update an existing profile. Use the setup flow when you need to change between webhook and long connection.
For webhook mode, expose:
/channels/feishu/ACCOUNT_ID/webhook
The default account ID is work. Configure the same Verification Token and Encrypt Key in Feishu/Lark and Anyy.
Access Policies
Direct messages support pairing, open, allowlist, and disabled. Groups support mention, open, allowlist, and disabled.
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
Verify the Connection
anyy channel doctor feishu
anyy channel reload
Test a direct message first, then a group mention.
Troubleshooting
| Problem | Check |
|---|---|
| Long connection never becomes live | App credentials, bot capability, event subscription, outbound network |
| Webhook verification fails | Public HTTPS route, Verification Token, Encrypt Key |
| Events arrive but messages are ignored | DM/group policy, pairing, or mention requirement |
| Reply is unauthorized | Bot messaging permissions and app publication state |
| Wrong profile selected | Re-run anyy setup channel feishu to switch explicitly |