Skip to main content

Connect Feishu or Lark to Frevana

Connect a Feishu or Lark app to Frevana using its App ID and App Secret. You can use the quick setup links below or configure the app manually.

Quick setup​

Choose the platform that matches your workspace and follow its setup flow:

Once you have your App ID and App Secret, continue to Connect the app in Frevana. You can also watch the video guide for help.

Set up an app step by step​

The following walkthrough uses the Feishu Developer Console. Labels may differ in Lark.

1. Create a custom app and find its credentials​

  1. Sign in to the Feishu Developer Console and create a custom app.
  2. Open Basic Info > Credential & Basic Info and copy the app’s App ID and App Secret.

Creating a custom app in the Feishu Developer Console

The App ID and App Secret on the Credential and Basic Info page

warning

Keep your App Secret private, just like a password. If it is exposed, replace it through your developer console and update the value in Frevana.

2. Add the bot capability​

In the Developer Console, go to Features > Add Features and add the Bot capability. This enables the app to send and receive messages.

Adding the Bot capability in the Feishu Developer Console

3. Enable app permissions​

Go to Development Configuration > Permissions & Scopes and enable these app identity permissions:

  • im:message.p2p_msg:readonly — receive private messages sent to the bot.
  • im:message:send_as_bot — send messages as the app.
  • im:message.group_at_msg:readonly — receive group messages that mention the bot.

You can review the Send Message, Reply Message, and Receive Message documentation for more details about the required permissions.

An example of API permission requirements

The Permissions and Scopes page in the Feishu Developer Console

4. Subscribe to message events​

  1. Go to Development Configuration > Event & Callback > Event Configuration and edit the Subscription Method.
  2. Choose Receive events through persistent connection, then select Save. Feishu requires a persistent connection to be established before you can save this method; follow its connection setup instructions first.
  3. Under Events added, select Add Events and add Message received (im.message.receive_v1).

The Event Configuration page and subscription method setting

Adding the Message received event

5. Publish the app​

Go to App Versions > Version Management & Release, select Create a version, and complete the version details. Publish the app so its permissions and settings can take effect. Your workspace may require an administrator to review the release.

Creating and publishing an app version in the Feishu Developer Console

For more information, see Feishu’s custom app publishing guide.

Connect the app in Frevana​

  1. In your Frevana Agent team, select Connect Chat Apps and choose Feishu / Lark.
  2. Select the region that matches your developer app.
  3. Enter the App ID and App Secret, then select Save.

The Feishu or Lark region, App ID, and App Secret fields in Frevana