From a1e733080d1c2602d9555dfe32ccf6b3dcdc22f3 Mon Sep 17 00:00:00 2001 From: 6vision Date: Wed, 17 Jun 2026 20:37:51 +0800 Subject: [PATCH] docs(wecom_bot): mention webhook (callback) mode in channel docs --- docs/channels/wecom-bot.mdx | 14 ++++++++++++++ docs/ja/channels/wecom-bot.mdx | 14 ++++++++++++++ docs/zh/channels/wecom-bot.mdx | 14 ++++++++++++++ 3 files changed, 42 insertions(+) diff --git a/docs/channels/wecom-bot.mdx b/docs/channels/wecom-bot.mdx index 2cb51fff..93da5156 100644 --- a/docs/channels/wecom-bot.mdx +++ b/docs/channels/wecom-bot.mdx @@ -69,6 +69,20 @@ Create the AI Bot in WeCom and obtain the Bot ID and Secret, then connect via th The log line `[WecomBot] Subscribe success` confirms the connection is established. + + A **webhook (HTTP callback) mode** is also supported: when creating the bot, choose **Use URL callback**, set the receive-message URL to `http(s)://:9892/wecombot`, and copy the Token and EncodingAESKey from that page. This mode needs a publicly reachable address and does not support file sending or scheduled push, so the long connection is generally recommended. The corresponding `config.json`: + +```json +{ + "channel_type": "wecom_bot", + "wecom_bot_mode": "webhook", + "wecom_bot_token": "YOUR_TOKEN", + "wecom_bot_encoding_aes_key": "YOUR_ENCODING_AES_KEY", + "wecom_bot_port": 9892 +} +``` + + ## 2. Supported features | Feature | Status | diff --git a/docs/ja/channels/wecom-bot.mdx b/docs/ja/channels/wecom-bot.mdx index 9a5d1958..4e463e28 100644 --- a/docs/ja/channels/wecom-bot.mdx +++ b/docs/ja/channels/wecom-bot.mdx @@ -52,6 +52,20 @@ WeCom AI Bot を介して CowAgent を接続し、ダイレクトメッセージ 設定後、プログラムを起動します。ログに `[WecomBot] Subscribe success` と表示されれば接続成功です。 + + ロングコネクションのほかに、**Webhook（HTTP コールバック）モード**にも対応しています。Bot 作成時に **URL コールバックを使用**を選択し、受信メッセージ URL を `http(s)://<ドメインまたはIP>:9892/wecombot` に設定して、その画面の Token と EncodingAESKey をコピーします。このモードは外部からアクセス可能なアドレスが必要で、ファイル送信とスケジュール配信には対応していないため、通常はロングコネクションを推奨します。対応する `config.json`： + +```json +{ + "channel_type": "wecom_bot", + "wecom_bot_mode": "webhook", + "wecom_bot_token": "YOUR_TOKEN", + "wecom_bot_encoding_aes_key": "YOUR_ENCODING_AES_KEY", + "wecom_bot_port": 9892 +} +``` + + ## 3. 対応機能 | 機能 | 状態 | diff --git a/docs/zh/channels/wecom-bot.mdx b/docs/zh/channels/wecom-bot.mdx index 7275639f..5d4f7536 100644 --- a/docs/zh/channels/wecom-bot.mdx +++ b/docs/zh/channels/wecom-bot.mdx @@ -69,6 +69,20 @@ description: 将 CowAgent 接入企业微信智能机器人（长连接模式） 日志显示 `[WecomBot] Subscribe success` 即表示连接成功。 + + 除长连接外，也支持**回调（HTTP 回调）模式**：创建机器人时选择「使用 URL 回调」，将接收消息 URL 设为 `http(s)://<域名或IP>:9892/wecombot`，并复制该页面的 Token 和 EncodingAESKey。该模式需公网可达，且不支持文件发送与定时推送，一般推荐使用长连接。对应 `config.json` 配置如下： + +```json +{ + "channel_type": "wecom_bot", + "wecom_bot_mode": "webhook", + "wecom_bot_token": "YOUR_TOKEN", + "wecom_bot_encoding_aes_key": "YOUR_ENCODING_AES_KEY", + "wecom_bot_port": 9892 +} +``` + + ## 二、功能说明 | 功能 | 支持情况 |