Feishu Group Manager

Quick Reference

When a write operation returns {"error": "payment_required", ...}: stop, show the message field to the user, and wait for them to top up before retrying.

First Use: Credential Check + Permission Verification

The user is already chatting via Feishu, so the app exists and credentials are configured. No need to ask them to set anything up.

Credentials are resolved automatically in this order:

1. 1. Environment variables FEISHU_APP_ID / INLINECODE14
2. INLINECODE15 → INLINECODE16

On the first request of a session, run:

CODEBLOCK0

If all_ok: true — proceed directly.

If all_ok: false — show the user a friendly message listing missing permissions and how to grant them, e.g.:

"Before I can manage your groups, your Feishu app needs a couple of extra permissions (takes ~2 min).
Missing:

• - im:chat.member — add/remove group members
• INLINECODE20 — search members by name

Steps:

1. 1. Open https://open.feishu.cn/app and find your app
2. Go to Permission Management → search and enable the permissions above
3. Go to Version Management → create a new version → submit for review
4. Once approved (usually a few minutes), let me know and I'll continue."

Re-run check_permissions after the user confirms. Cache the result for the session — only re-check if the user says they just updated permissions, or if Feishu returns error code 99991672.

Execution Flow

Step 1 — Understand intent

Step 2 — Gather info

python3 {baseDir}/scripts/feishu.py get_token
python3 {baseDir}/scripts/feishu.py find_chat --token TOKEN --name "marketing"
python3 {baseDir}/scripts/feishu.py find_user --token TOKEN --name "Zhang San"

Step 3 — Confirm before any write

"I'm about to add Zhang San (Marketing dept.) to Marketing Group. Confirm?"

Wait for confirmation before executing.

Step 4 — Execute and report

Command Reference

CODEBLOCK2

INLINECODE23 is the caller's Feishu open_id — used for billing. Retrieve it from conversation context or from find_user results.

Error Handling