Skip to main content
Connect your AI Expert to Feishu (Lark), allowing team members to chat with your Expert directly in their everyday Feishu messages. The Feishu channel supports full conversation capabilities and additionally offers user-level OAuth authorization, enabling your Expert to access users’ personal documents and spreadsheets.

​
Integration Methods

Feishu offers two integration methods:
Choose manual configuration when you need more granular permission control:
  1. Log in to the Feishu Open Platform and create an enterprise custom app
  2. Enable the bot under the “Bot” capability
  3. Configure the event subscription callback URL (available in the Profy integration panel)
  4. Add required permissions (message sending/receiving, contacts read access, etc.)
  5. Enter the App ID and App Secret in the Profy integration panel
  6. Publish the app version and pass the review
Manual configuration is suited for scenarios where you need to limit specific permission scopes, or want to reuse an existing Feishu app.

​
Message Format

The Feishu channel uses a “multi-bubble” message style:
  • Expert text replies are sent as individual message bubbles
  • Status notifications are sent during tool calls (e.g., ”🔍 Searching…”)
  • The final reply is sent after tool completion
  • Markdown formatting is supported
Feishu messages have a length limit. Overly long replies are automatically split into multiple messages.

​
Chat Scenarios

​
One-on-One Chat

Send a message directly to the bot to start a private conversation. Ideal for personal use cases.

​
Group Chat

@mention the bot in a group to send a message — the Expert will reply within the group. Suitable for team collaboration where other members can follow the conversation.
In group chat, the Expert only responds to messages that @mention it. It won’t reply to every message in the group.

​
User OAuth Authorization

A unique feature of the Feishu channel — after completing user-level OAuth authorization via the /auth command, your Expert can access your personal Feishu resources.

​
Authorization Flow

1

Send the Auth Command

Send /auth in your Feishu conversation with the Expert.
2

Click the Authorization Link

The Expert will reply with a message containing an authorization link. Click it.
3

Confirm Authorization

On the Feishu OAuth page, review the authorization scopes (document read access, spreadsheet access, etc.) and click approve.
4

Authorization Activated

Once authorized, the Expert can access Feishu documents and spreadsheets on your behalf.

​
Capabilities After Authorization

After completing OAuth, the Expert gains the following additional capabilities:
OAuth tokens have an expiration period. When expired, the Expert will prompt you to run the /auth command again. If token refresh fails, the Expert automatically falls back to basic capabilities (without accessing your personal resources), and normal conversation continues unaffected.

​
FAQ

Check the following:
  • Verify the app has been published and approved
  • Verify the event callback URL is correctly configured
  • Verify the Expert’s Profy service is running normally
  • In group chat, make sure you @mentioned the bot
IM channel response speed depends on AI model inference time and tool call duration. Response time increases when tools like search or file processing are used. This is consistent with the web experience.
Verify that the Expert you’re using has Feishu OAuth capability configured by its creator. Not all Experts support this feature.

Channels Overview

Learn about all supported IM platforms

DingTalk Integration

DingTalk channel setup guide