docs(dingtalk): explain group subscriptions and card interaction events

2026-11-01 21:35:25 +08:00 · 2026-10-10 21:30:07 +08:00
parent f41981b356
commit 3bee9c19f9
3 changed files with 39 additions and 0 deletions
@@ -133,3 +133,16 @@ LangBot は DingTalk アプリのワンクリック作成とクレデンシャ
 ボットをクリックしてチャットします。

 グループに追加したい場合は、DingTalk グループの「グループ管理」、「ロボット」、「ロボットを追加」をクリックし、ボット名を検索してグループで使用します。
+
+## イベント購読
+
+DingTalk アプリ管理画面のイベント購読で Stream モードを選択し、必要なイベントを有効にしてください。ロボットのメッセージ受信設定とは別の設定です。
+
+- `chat_add_member` → `group.member_joined`（メンバーごとに通知）。
+- `chat_remove_member` / `chat_quit` → `group.member_left`（削除と自主退出を区別）。
+- `chat_update_title` / `chat_update_owner` → `group.info_updated`。
+- 通常のカード操作 → `dingtalk.card_action`。識別可能な評価は `feedback.received`、管理対象フォームは既存の対話処理に渡し、重複実行を防ぎます。
+- グループ解散などその他の購読イベントは `platform.specific` に渡し、`action` にイベント名、`data` に元のヘッダーとデータを保持します。
+
+グループイベントにはアプリ権限とグループ種別の制限があります。unionId のみを含むメンバー通知はプラットフォーム固有イベントとして保持します。メッセージ編集・撤回・リアクション、友達申請、ボットのミュートなど、対応するプッシュが未確認のイベントは対応済みと表示しません。
+