Feishu uses an application bot and a long connection for incoming events. You need application-management access and a CDelivery Admin account; no public event callback URL is required.
Create and publish
- Create a self-built application in the Feishu developer portal and enable its bot capability.
- Allow the bot to send messages and read users’ direct messages. Add group-mention reception if needed.
- Select long-connection event reception and subscribe to
im.message.receive_v1. - Publish the application and include its users in the availability scope. Complete required approval after permission changes.
- Save App ID and App Secret in CDelivery’s Feishu channel.
A webhook-only group bot is not the application bot required here. Lark credentials belong in the separate Lark channel. See official event configuration.
Bind your identity
Use your own open_id for this application, not user_id, union_id, a chat ID, or the bot’s ID. The same person can have different open_id values in different apps.
Use the official API explorer and email/phone user lookup, selecting open_id and granting the required contact scope covering yourself. Save that value in your CDelivery account. New bindings receive notifications by default; you can turn them off.
Entering another person’s identity can expose your account’s data and operations to them. Rebind after switching applications.
Verify and troubleshoot
Ask a read-only question in a direct chat; explicitly mention the bot in a group. AI replies also need a model.
Check publication, user availability, message permissions, event subscription, outbound connectivity, and identity binding. Profile lookup additionally needs contact:contact.base:readonly and contact:user.base:readonly, with the user in the app’s contact scope. Profile failures and delivery failures should be diagnosed separately.