Feishu Integration Developer

Implements Feishu Open Platform integrations including bots, message cards, approvals, Bitable, and SSO.

2|Updated May 21, 2026
One-click install
npx skills add https://github.com/tcvdog/agency-agents-hermes --skill feishu-integration-developer-tcvdog
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Feishu Integration Developer
Source: https://github.com/tcvdog/agency-agents-hermes/tree/main/engineering/feishu-integration-developer
Command: npx skills add https://github.com/tcvdog/agency-agents-hermes --skill feishu-integration-developer-tcvdog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @larksuiteoapi/node-sdk, express.

What problem does it solve? Building enterprise integrations on the Feishu (Lark) Open Platform involves navigating token management, event subscription verification, message card JSON, approval APIs, and permission models — this Skill provides expert guidance and production-ready code patterns for all of them. ## Core Features & Use Cases - Bot & Message Card Development: Build interactive bots with command handlers, card callbacks, and validated card JSON using the official Lark SDK. - Approval & Bitable Integration: Create approval instances via API, subscribe to status change events, and sync records bidirectionally with Bitable spreadsheets. - SSO Authentication: Implement OAuth 2.0 authorization code flow and Feishu QR code login with secure state validation. - Use Case: You need to notify a Feishu group when an order is approved in your ERP. This Skill guides you through creating an approval event subscription, handling the callback idempotently, and pushing an interactive message card with approve/reject buttons. ## Quick Start Ask the agent to build a Feishu bot that sends an interactive approval notification card to a group chat and handles the button callbacks.

Frequently Asked Questions about Feishu Integration Developer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Feishu bot that sends interactive message cards?▼

Create an app on the Feishu Open Platform, then use the official Lark SDK's im.message.create API with msg_type 'interactive' and card JSON. Validate the card in Feishu's Card Builder tool before sending, and register a CardActionHandler to process button clicks.

What is the difference between tenant_access_token and user_access_token in Feishu?▼

tenant_access_token acts on behalf of the app for organization-level operations, while user_access_token acts on behalf of a specific user and is required for endpoints operating on personal data like a user's approval instances. User tokens are obtained through the OAuth authorization code flow.

How do I handle Feishu event subscription callbacks securely?▼

Verify requests using the verification token or decrypt payloads with the Encrypt Key via the SDK's EventDispatcher. Return HTTP 200 within 3 seconds and process events asynchronously, since Feishu retries on timeout and may deliver duplicate events, so handlers must be idempotent.

Does the Feishu Bitable API support batch record creation?▼

Yes, the appTableRecord.batchCreate endpoint creates multiple records in one request, limited to 500 records per call. Larger datasets must be split into batches, and adding a short delay between batches helps avoid rate limiting (HTTP 429).

Why does my Feishu API call fail with a non-zero code field?▼

Every Feishu API response includes a code field where anything other than 0 indicates an error, with details in the msg field. Common causes include expired tokens, missing permission scopes, or wrong token type, so always check the code and implement retries for transient failures.

Can I call Feishu APIs directly from browser frontend code?▼

No, because the app_secret must never appear in frontend code. Browser-based calls must be proxied through your own backend, which authenticates the user first and then calls the Feishu API on their behalf.