WhatsApp 設定
逐步教學：將 Claw Buff Agent 連接到 WhatsApp
WhatsApp 整合目前為 Beta 版本。它使用 WhatsApp Web 協定（Baileys），並非官方 API。請參閱下方的重要注意事項。
將您的 Claw Buff AI Agent 連接到 WhatsApp，讓使用者可以像一般聯絡人一樣與它對話。設定大約需要 5 分鐘。
前置需求
- 一個 WhatsApp 帳號（強烈建議使用專用門號）
- 一支用於掃描 QR 碼的智慧型手機
- 已部署的 Claw Buff Agent（快速入門）
步驟 1：連接至 Claw Buff
- 開啟 Claw Buff 管理後台 → 頻道 頁面
- 找到 WhatsApp 卡片並點擊連接
- 點擊產生 QR 碼
畫面上會出現一個 QR 碼。
步驟 2：掃描 QR 碼
在手機上開啟 WhatsApp
點擊右上角的 ⋮ 選單 或設定，然後點擊已連結的裝置 → 連結裝置。部分版本請點擊個人資料名稱旁的 QR 圖示。
掃描 QR 碼
將手機鏡頭對準管理後台上顯示的 QR 碼。連線將自動建立。
確認連線
管理後台會將狀態顯示為已連接。您會看到已連結的電話號碼。
步驟 3：開始聊天
從其他 WhatsApp 帳號向已連結的號碼傳送訊息。您的 AI Agent 就會回應！
我們建議為 WhatsApp 機器人使用專用門號。這可以將您的個人 WhatsApp 與機器人分開，避免對個人帳號造成任何風險。
功能一覽
| 功能 | 支援狀態 |
|---|---|
| 私人訊息 | 是 |
| 群組聊天 | 是 |
| 豐富格式 | 是 |
| 檔案附件 | 是 |
| 語音訊息 | 規劃中 |
重要注意事項
Beta 狀態
WhatsApp 整合使用 Baileys 函式庫（WhatsApp Web 協定）。這並非官方 WhatsApp API，因此：
- 帳號風險 — WhatsApp 可能會限制使用非官方 API 的帳號。請使用專用門號，不要用個人號碼
- 工作階段過期 — 已連結的工作階段約在閒置 30 天後過期。届時需要重新掃描 QR 碼
- 無 SLA 保證 — WhatsApp 的協定變更可能暫時中斷連線
專用門號建議
我們強烈建議為 WhatsApp 機器人另外準備一個電話號碼。可選方案包括：
- 預付卡 SIM 卡
- Google Voice 號碼
- 可接收簡訊驗證的 VoIP 號碼
Cloud API 替代方案
如果是需要官方 API 的正式環境，WhatsApp Cloud API 支援已列入未來版本規劃。屆時將使用 Meta 官方的 Business API，提供正式的 SLA 保證且不會有帳號風險。
常見問題
1. QR 碼過期了？
QR 碼約在 60 秒後過期。在管理後台點擊產生 QR 碼即可取得新的。
2. 連線經常斷開？
- 確認手機保持網路連線
- 確認 WhatsApp 已更新至最新版本
- 如果手機離線過久，可能需要重新連結工作階段
3. 訊息無法送達？
- 確認收件人的號碼為 E.164 格式（例如 +15551234567）
- 群組訊息需要機器人號碼是群組成員
- 在管理後台的頻道頁面查看錯誤詳情