hermes-agent/website/docs/user-guide/messaging
Shuo d7785f4d5b feat(feishu): add scan-to-create onboarding for Feishu / Lark
Add a QR-based onboarding flow to `hermes gateway setup` for Feishu / Lark.
Users scan a QR code with their phone and the platform creates a fully
configured bot application automatically — matching the existing WeChat
QR login experience.

Setup flow:
- Choose between QR scan-to-create (new app) or manual credential input (existing app)
- Connection mode selection (WebSocket / Webhook)
- DM security policy (pairing / open / allowlist / disabled)
- Group chat policy (open with @mention / disabled)

Implementation:
- Onboard functions (init/begin/poll/QR/probe) in gateway/platforms/feishu.py
- _setup_feishu() in hermes_cli/gateway.py with manual fallback
- probe_bot uses lark_oapi SDK when available, raw HTTP fallback otherwise
- qr_register() catches expected errors (network/protocol), propagates bugs
- Poll handles HTTP 4xx JSON responses and feishu/lark domain auto-detection

Tests:
- 25 tests for onboard module (registration, QR, probe, contract, negative paths)
- 16 tests for setup flow (credentials, connection mode, DM policy, group policy,
  adapter integration verifying env vars produce valid FeishuAdapterSettings)

Change-Id: I720591ee84755f32dda95fbac4b26dc82cbcf823
2026-04-12 13:05:56 -07:00
..
_category_.json
…
bluebubbles.md
…
dingtalk.md
…
discord.md
…
email.md
…
feishu.md feat(feishu): add scan-to-create onboarding for Feishu / Lark 2026-04-12 13:05:56 -07:00
homeassistant.md
…
index.md docs: add platform adapter developer guide + WeCom Callback docs (#7969) 2026-04-11 15:50:54 -07:00
matrix.md fix: register MATRIX_RECOVERY_KEY env var + document migration path 2026-04-12 02:18:03 -07:00
mattermost.md
…
open-webui.md
…
signal.md
…
slack.md
…
sms.md update docks with changes made 2026-04-11 14:05:38 -07:00
telegram.md
…
webhooks.md
…
wecom-callback.md docs: add platform adapter developer guide + WeCom Callback docs (#7969) 2026-04-11 15:50:54 -07:00
wecom.md
…
weixin.md
…
whatsapp.md
…