通過 WhatsApp 與 Hermes Agent 對話。
配置通道 - WhatsApp
WhatsApp 通道採用掃碼接入方式，配置方式接近 WeChat，適合快速將 Hermes Agent 接入 WhatsApp 對話場景。
本頁覆蓋
-
使用手機 WhatsApp 掃碼授權
-
在 WhatsApp 中與 Hermes Agent 進行對話
操作步驟
1. 進入管理台
登錄 LightVela，點擊右上角「我的 Hermes」進入管理台，找到「通道」按鍵。
2. 選擇 WhatsApp 通道
找到 WhatsApp 模塊，點擊「+連接」。
3. 使用手機 WhatsApp 掃碼
-
打開手機 WhatsApp
-
點擊右上角"照相機"按鈕
-
對準電腦屏幕上的二維碼掃描
- 按手機提示完成連接
4. 在 WhatsApp 裏查詢你自己
與自我對話——這就是你的機器人。
進入該機器人的聊天界面，發送測試消息：
你好幾秒內收到 Hermes Agent 回覆。
成功狀態
-
管理台「已接入通道」列表中出現"WhatsApp"
-
WhatsApp 聯繫人中可查找到對應機器人
-
發送消息後能收到 Hermes Agent 回覆
支持的消息類型
接入成功後，WhatsApp 機器人除了能夠接收、回覆基礎文本信息外，還支持更多消息類型，詳情如下：
| WhatsApp 機器人支持的消息類型 | 是否支持 |
|---|---|
| 接收文本信息 | ✅ 已支持 |
| 接收圖片、視頻 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 回覆文本信息 | ✅ 已支持 |
| 回覆圖片、視頻 | ✅ 已支持 |
| 回覆文件 | ✅ 已支持 |
| 主動發送消息（如定時發送提醒） | ✅ 已支持 |
常見問題
| 現象 | 可能原因 | 處理方式 |
|---|---|---|
| 無法接入 WhatsApp | 手機號格式不正確，或 WhatsApp Business 配置未完成 | 確認使用完整國際區號格式，例如 +1、+86，並檢查 WhatsApp Business / Meta 配置是否完成 |
| 驗證碼收不到 | 手機號不可用、網絡延遲，或 WhatsApp 驗證受限 | 確認手機號可正常接收 WhatsApp 消息；等待幾分鐘後重試 |
| 驗證碼填寫後提示無效 | 驗證碼過期或輸入錯誤 | 重新獲取驗證碼，並確認沒有多餘空格 |
| 接入後管理台無響應 | 授權或配置尚未同步完成 | 刷新管理台頁面確認狀態；若未接入成功則重新操作 |
| WhatsApp 中找不到機器人聯繫人 | 機器人號碼未保存，或尚未開始對話 | 保存機器人號碼，或通過管理台提供的鏈接/二維碼打開對話 |
| 發送消息後無回覆 | 模型未配置、體驗積分耗盡，或 WhatsApp 通道尚未成功接入 | 檢查「1. 模型」卡片的「當前模型」狀態，並確認 WhatsApp 通道顯示為已接入 |
| 無法接收圖片、文件或語音消息 | 媒體權限、格式或通道能力限制 | 確認文件類型受支持；如語音無法識別，需檢查是否啓用語音轉文字/媒體處理能力 |
| 主動發送消息失敗 | WhatsApp 對主動消息有模板消息或會話窗口限制 | 確認用户已與機器人發起過對話；若超出會話窗口，需使用已審核的消息模板 |
| 如何解除綁定 | — | 在「已接入通道」列表中刪除該 WhatsApp 記錄 |
| 同一個 WhatsApp 號能否接入多個 Hermes Agent | 通常不建議，一個 WhatsApp 號碼應綁定一個 Hermes Agent | 如需多個 Hermes Agent，建議分別使用不同的 WhatsApp 號碼 |
通道説明
-
消息類型：支持文本、圖片、視頻、文件、語音等多種類型，詳見上方「支持的消息類型」
-
群聊支持：當前不支持群聊，僅支持 1 對 1 對話
-
連接中斷：長時間無響應可能為授權被撤銷，回管理台重新授權接入即可
下一步
-
配置通道 - Discord — 社群運營與開發者社區
-
配置通道 - QQ — 手動創建機器人，AppID/AppSecret 接入
-
配置通道 - 企業微信 — 企業內部協作與辦公場景
-
配置技能 — 擴展 Hermes Agent 能力