Feishu / Lark integrations

Surface area

Rendering diagram…

Capability table

Category	Coverage	Typical usage
IM	Channels + DMs send/receive, history lookup	Alerts, conversational agents
Docx Wiki	CRUD + partial updates	Authoring workflows
Base	Tables, schemas, workflows	Ticket boards/KPI trackers
Spreadsheets	Bulk read/write, exports	QA matrices
Slides	Create/update decks	Exec updates
Whiteboard	UML/Mermaid overlays	Diagramming
Calendar	Scheduling, conflicts, rooms	Automated meetings
Approvals	Instance + task orchestration	Process automation
Minutes / conferencing	Playback + AI artefacts	Digest generation
Directory	Personnel lookup	Identity mapping

Prerequisites

Administrators provision a custom app via open.feishu.cn and approve OAuth scopes aligned to workloads:

Scope bundle	Highlights
IM + Wiki	`im:`, `docx:`, `drive:drive:readonly`
Base workloads	`bitable:*`
Calendar/conferencing	`calendar:`, `vc:`

Setup checklist

Create credentials

Console → Integrations → Feishu → Create

Application ID / secret
self_hosted vs marketplace ISV
Encryption / verification tokens if subscribing to events

Optional CLI onboarding:

lark-cli config init
lark-cli auth login
lark-cli auth login --as bot

Event subscription (interactive flows)

Expose callback URL:

https://<combo-agent>/v1/webhook/lark

Select events (im.message.receive_v1, im.chat.member.user.added_v1, …).

Bind Agents

channels:
  - type: lark
    credential_id: <cred_id>
    bot_name: "combo-agent"
    chat_filter:
      mention_only: true
      chat_ids: ["oc_xxx", "oc_yyy"]

Identity modes: bot vs delegated user

Mode	Fits	Constraints
Bot application	Omnichannel responders	Scoped to chats/docs explicitly shared
User OAuth delegation	“My calendar/email” personalization	Requires per-user authorization

Most employee-assistant flows combine both.

Assets (images/files)

Upload → reuse Feishu image_key / file_key; download inbound attachments via get_message_resource.

Common pitfalls

Error	Guidance
`99991663` forbidden	Incomplete scopes / unpublished app revisions
Bot silent	Inspect Feishu event callback history—URL failing
User OAuth stale	Refresh `user_access_token`
Wiki ACL	Grant bot collaborator rights or share parent knowledge bases
Callback signature mismatch	Reconfirm encrypt + verification secrets

Office automation solution
Channel concepts
Skills (lark-im, lark-doc, lark-base, lark-sheets, lark-calendar, lark-approval, lark-minutes, lark-vc, lark-mail, lark-okr, lark-wiki, lark-slides, lark-whiteboard, lark-contact, lark-event, lark-drive, lark-shared)

Feishu / Lark integrations

On this page