feishu-bot-card

Send Feishu schema 2.0 interactive cards with markdown tables via webhook.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/taptap/agents-plugins --skill feishu-bot-card
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-bot-card
Source: https://github.com/taptap/agents-plugins/tree/main/plugins/sync/skills/feishu-bot-card
Command: npx skills add https://github.com/taptap/agents-plugins --skill feishu-bot-card

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simplifies building and sending Feishu interactive card notifications via webhook while avoiding common pitfalls like using v1 schema, wrong markdown components, signature mismatches, and private OSS download errors.

Core Features & Use Cases

  • Schema 2.0 guidance: Use the markdown element to render rich text and tables that v1/lark_md cannot display.
  • Webhook signing: Explain timestamp + HMAC-SHA256 signing and how to include timestamp and sign fields to validate requests.
  • Attachment handling: Recommend generating SDK-based signed OSS URLs for private buckets and best practices for CSV generation including UTF-8 BOM.
  • Use Case: Send an interactive card with a downloadable CSV report link that renders a summary table and avoids 403 errors.

Quick Start

Create and send a schema 2.0 Feishu interactive card with a markdown table and a signed OSS download link via the webhook.

Frequently Asked Questions about feishu-bot-card

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

FAQPage Schema
How do I render markdown tables in Feishu bot cards via webhook?

To render markdown tables in Feishu bot cards, you must use schema 2.0 and the markdown element, as v1 or lark_md components cannot display rich text tables properly.

Why does my Feishu webhook return a signature mismatch error?

Feishu webhook signature mismatches occur when the request lacks proper timestamp and HMAC-SHA256 sign fields. You must compute HMAC-SHA256 signing with a timestamp to validate requests successfully.

How do I generate private OSS download links for Feishu cards without 403 errors?

To prevent 403 access errors with private OSS buckets in Feishu cards, generate SDK-based signed OSS URLs instead of direct links to ensure authorized access to the downloadable files.

What is the best way to attach a CSV report in a Feishu interactive card?

The best way to attach a CSV report is to generate it with UTF-8 BOM encoding for compatibility, upload it to OSS, and include the SDK-based signed download link in the schema 2.0 Feishu interactive card.

Does the Feishu bot webhook schema 2.0 support rich text and interactive elements?

Feishu bot webhook schema 2.0 supports rich text rendering and interactive elements, allowing developers to construct cards with markdown summaries and downloadable report links reliably.

Why are my CSV exports displaying incorrectly when downloaded from Feishu?

CSV exports downloaded from Feishu may display incorrectly without UTF-8 BOM generation, which ensures proper character encoding recognition across different spreadsheet applications when users open the attached files.