wechat-binding

📱 WeChat 連携

ユーザーの WeChat アカウントを接続 / 再接続 / 切断し、エージェントが send_to_wechat 経由でメッセージを送信できるようにします。

wechat ツールは組み込みのままです。この SKILL.md はリファレンスドキュメントです。

関連項目

• config/context/references/messaging-channels.md — 連携後に実際にメッセージを送信する方法
• skills/tg-bot-binding/SKILL.md — 類似の Telegram フロー

---

典型的な連携フロー

qrcode → user scans → qrcode_status(qrcode=...) → connect(bot_token=...)

1. QR を生成: wechat(action="qrcode") — 画像をワークスペースに保存し、qrcode (id) + file_path を返します。
2. ユーザーに QR を表示します。 Web チャネルの場合: file_path を含めて、フロントエンドが画像をレンダリングできるようにします。TG / WeChat チャネルの場合: send_to_telegram で file_path を指定して画像を送信します。
3. ユーザーが WeChat でスキャン + 確認するのを待ちます。 自動ポーリングしないでください — まずユーザーに「スキャンした」/「完了した」と言ってもらいましょう。
4. 完了をポーリング: wechat(action="qrcode_status", qrcode=<ステップ 1 の id>)。スキャン + 確認が完了すると bot_token を返します。
5. 接続: wechat(action="connect", bot_token=<ステップ 4 の値>)。任意: ユーザーが複数の WeChat アカウントを持っている場合は ilink_bot_id、ilink_user_id。
6. ユーザーに確認: 「WeChat を接続しました。send_to_wechat でメッセージを送信できるようになりました。」

---

アクション

action	必須	目的
status	—	現在の WeChat 接続状態。再接続の前に、連携を確認するために使用します。
qrcode	—	QR コード画像を生成します (ワークスペースに保存)。qrcode id + file_path を返します。
qrcode_status	qrcode	ユーザーがスキャン + 確認したかどうかをポーリングします。成功すると bot_token を返します。
connect	bot_token	新規の WeChat 接続を完了します (初回の QR スキャン後)。任意: ilink_bot_id、ilink_user_id。
disconnect	—	現在の WeChat セッションを終了します (リンク解除)。
reconnect	bot_token	以前に連携した WeChat を再確立します (新しい QR スキャンで取得したトークン)。

---

connect と reconnect の違い

• connect — 初回の連携。ユーザーがこの WeChat をこれまで一度も連携したことがない場合。
• reconnect — ユーザーが以前に接続していて、接続が切断され (例: ilink セッションの期限切れ)、新しい QR をスキャンしただけの場合。

迷ったときは、まず status を呼び出してください:

• connected: false + 過去の履歴なし → connect
• connected: false + 過去の履歴あり → reconnect

---

チャネルに応じた QR の表示

ユーザーのチャネル	QR の表示方法
Web	返信に file_path を含めます — フロントエンドがインラインでレンダリングします
Telegram	send_to_telegram(file_path=<qr_path>, message_type="photo")
WeChat	(できません — そもそも WeChat を連携しようとしているのです。Web アプリを開くように伝えてください。)

---

重要なルール

• qrcode の後に qrcode_status を自動ポーリングしないでください。 ユーザーが WeChat でスキャン + 確認したという確認を待ちます。自動ポーリングは上流 API にスパムを送信します。
• qrcode を呼び出すたびに新しい画像が生成されます。 古い qrcode id を新しい画像で再利用しないでください — 上流のセッションは id に紐づいています。
• bot_token をチャットに貼り付けないでください。 これは認証情報です。qrcode_status から取得したら、すぐに connect / reconnect に渡し、ユーザーにエコーバックしないでください。
• disconnect は破壊的です — 呼び出す前にユーザーに確認してください。