本指南說明如何將你的 Quickchat AI Agent 與 WhatsApp 整合。流程分為 2 個簡單步驟：
- 步驟 0 - 先決條件
- 步驟 1 - 連接 WhatsApp
如果整合時遇到問題或需要協助，請前往 疑難排解與常見問題章節，或聯絡我們。
觀看影片
步驟 0 - 先決條件
A. 商務電話號碼
決定你要將哪個電話號碼用於 WhatsApp。你可以在 WhatsApp 文件中閱讀更多資訊，或參考下方常見問題：
WhatsApp Cloud API 可以使用哪種號碼？
- 你需要使用一個可接收 SMS 或語音通話以進行驗證的專用商務電話號碼。
- 號碼必須有效、由你擁有，且包含國碼和區碼。
我可以使用已在 WhatsApp Messenger 中使用的號碼嗎？
- 不可以。你可以繼續將此號碼用於通話和簡訊，但不能用於 WhatsApp Messenger。
- 如果該號碼已在 WhatsApp Messenger 中使用，請先刪除它。請不要忘記備份你的 WhatsApp 聊天記錄。
- 被封鎖的號碼必須先解除封鎖，才能註冊。
我可以使用已由 WhatsApp Business App 使用的號碼嗎？
- 可以，透過 Coexistence（測試版）。號碼會保留在你手機上的 WhatsApp Business App 中，你的 AI Agent 則在同一個號碼上回覆。你不需要刪除 App 帳號。步驟請見下方的 步驟 1。你也可以在 Meta 文件中閱讀 Coexistence 導入流程。
我可以使用新的電話號碼嗎？
- 可以，如果你不想使用目前的號碼，請取得一個新號碼（實體 SIM 卡或虛擬號碼）。你可以從 Hushed 等服務購買虛擬電話號碼。
B. 商務資訊
請先準備好這些資料（你會在 Meta 整合流程中輸入）：
- 商務名稱
- 商務網站
- 商務類別
- 商務說明
即使有些欄位看起來是選填，也請準確填寫。缺少資訊或資訊不正確，可能會延遲核准或造成帳號限制。
步驟 1 - 連接 WhatsApp
自從我們最近更新後，連接只需要按一下。現在不再有獨立的第二步：Meta 自己的 Embedded Signup 精靈會引導你建立新的 WhatsApp Business Account 和號碼，或選擇你現有的帳號與號碼，Quickchat AI 會完成其餘設定。
開啟 Quickchat AI App → External Apps → WhatsApp → 按一下 Connect WhatsApp 按鈕，並依照 Meta 彈出式視窗操作：
- 登入你的 Meta (Facebook) 帳號。
- 檢視你將分享給 Quickchat AI 的權限（WhatsApp Business 帳號存取權和 Business portfolio 存取權），然後繼續。
- 提供準確的商務詳細資料（Business Portfolio、Business Name、Business Website、Country 等）。
- 建立或選擇你的 WhatsApp Business Account。
- 選擇 WhatsApp Business 顯示名稱和類別。
- 新增你的商務電話號碼，並依照提示透過 SMS/語音進行驗證。
- 按一下 Confirm，授予 Quickchat AI 所需的存取權。
- 當 Meta 確認設定完成時，按一下 Finish。彈出式視窗會顯示 Quickchat AI 確認訊息，表示你的 WhatsApp 帳號已連接，並會自動關閉。
想在這個號碼上繼續使用 WhatsApp Business App（Coexistence，測試版）？ 請將 WhatsApp Business App 更新至 2.24.17 或更新版本。在 WhatsApp 面板中選擇 A number already used in the WhatsApp Business app，然後按一下 Connect WhatsApp。在 Meta 的視窗中，選擇連接你現有的 WhatsApp Business App（或輸入其號碼），而不是以驗證碼驗證號碼，然後在手機上的 App 中確認。之後：
- 你可以繼續在手機上使用 App，你的 AI Agent 會在同一個號碼上回覆客戶。
- 當你從 App 回覆客戶時，AI Agent 會在該對話中停止回覆。對話中 4 小時沒有訊息後，客戶的下一則訊息會開始新的一輪，AI Agent 會再次回答。你也可以在 Quickchat AI Inbox 中將對話交還給 AI Agent。
- 過去的對話會保留在 App 中。Quickchat AI Inbox 從你連接的那一刻開始記錄。
- Meta 對此模式有所限制：廣播清單會關閉、群組對話不會同步、不支援 WhatsApp for Windows，且若約 14 天未在手機上開啟 App，號碼會中斷連線。
回到 Quickchat AI App 後，WhatsApp 面板會顯示 Connecting your WhatsApp account，並在約 30 秒內更新為 Connected。如果沒有更新，請在面板中按一下 Refresh Status。否則，請重新查看上方的先決條件，確認你已正確提供商務電話號碼和資訊。
Connected 表示 Quickchat AI 可以連到你的 WhatsApp Business Account。其正下方，面板會顯示在客戶收到回覆前仍需完成的事項：
Connected 面板列出剩餘事項：此處為第一則訊息
- Waiting for your first message：從另一支手機向顯示的號碼傳送 WhatsApp 訊息，然後按一下 Refresh。收到訊息後，面板會在 Webhook Active 和 Admin Assigned 旁顯示 Messages Received。
- Display name：面板下方列出的每個號碼都會顯示來自 Meta 的顯示名稱狀態（Approved、Pending review、Declined、Expired 或 No display name）。進行中的審查不需要你採取任何動作，通常會在幾天內完成。若顯示名稱被拒絕、已過期或缺少，系統會要求你在 WhatsApp Manager 中提交一個顯示名稱。
- Meta test number：如果啟用中的號碼是 Meta 提供的 +1 555 號碼，面板會指出此情況。這些號碼用於測試，不能移至其他帳號。若要正式上線，請在 WhatsApp Manager 中新增你自己的號碼。
面板顯示 Messages Received 後，就已正式上線！ 🎉 客戶可以傳訊息到你的 WhatsApp 號碼，你的 AI Agent 會自動回覆。
作為整合的最後驗證，請傳送一則文字訊息到你剛連接的 WhatsApp 號碼，然後在面板中按一下 Refresh。Waiting for your first message 會變成 Messages Received，你應該會收到 AI Agent 的回覆，且對話應該會出現在 Quickchat AI App 的 Inbox 中。如果你尚未完成任何 Meta 設定步驟，Quickchat AI 也會透過電子郵件提醒帳號擁有者剩餘步驟。
疑難排解與常見問題
WhatsApp Business API 計費方式是什麼？
- 對使用者發起的（inbound）客戶詢問進行回覆，會被 WhatsApp 視為 Service messages。這些訊息讓企業可以管理傳入的客戶詢問，不論是透過真人客服，或由對話式 AI 驅動的 bot。
- 當使用者傳訊息給企業時，這會開啟一個 24 小時客戶服務時段，在此期間企業可以使用服務訊息回覆，不收費。此時段會隨每則使用者訊息重設。
- 24 小時後，你必須使用已核准的 Message Templates（Marketing、Utility、Authentication 等），並依照 WhatsApp Business Platform 訊息費率 按訊息付費。
- 對話由 Meta 分類並計費。請確保你的 WhatsApp Business Account 有有效的付款方式，用於企業發起訊息或範本訊息。
Connect WhatsApp 按鈕無法使用。我看不到 Meta 彈出式視窗。
- 如果你的瀏覽器封鎖彈出式視窗，App 會顯示訊息要求你允許彈出式視窗。請在瀏覽器中停用彈出式視窗和追蹤封鎖工具，重新整理網站後再試一次。如果仍無法解決，請嘗試使用其他瀏覽器。
號碼驗證失敗。
- 請確認該號碼可以接收 SMS/語音通話。如果該號碼仍在個人 WhatsApp Messenger 中使用，請先刪除該 WhatsApp 帳號，或改用其他號碼。如果該號碼用於 WhatsApp Business App，請重新連接，選擇 A number already used in the WhatsApp Business app，並在 Meta 的視窗中連接你現有的 App，而不是以驗證碼驗證號碼（Coexistence 導入）。App 必須為 2.24.17 或更新版本。
Meta 表示我的設定尚未完成，或面板顯示警告。
- 請先閱讀 Connected 下方的卡片：它會指出 AI Agent 回覆所使用的號碼，並說明 Meta 是否仍在審查其顯示名稱、它是否為 Meta 測試號碼，或第一則訊息是否尚未送達。每張卡片都會連到 WhatsApp Manager 中的正確位置。
- 如果警告與連線本身有關，請在面板中按一下 Reconnect WhatsApp。這可以解決多數情況。
- 如果仍無法解決，你的號碼可能已連接到其他供應商（Meta 一次只允許每個 WhatsApp 帳號有一個合作夥伴）。請依照畫面上的指示，在 Meta Business 設定中將 Quickchat AI 新增為合作夥伴，然後按一下 Refresh Status。
我連接了錯誤的帳號。
- Reconnect 會保留已連接的帳號。若要切換，請在 WhatsApp 面板中按一下 Disconnect，接著再次按一下 Connect WhatsApp，並在 Meta 視窗中選擇正確的 Meta Business 帳號和 WhatsApp Account。
訊息沒有出現在 Quickchat AI Inbox 中。
- 確認彈出式視窗已顯示最後確認，表示你的 WhatsApp 帳號已連接。
- 再次檢查你連結的是預期的 WhatsApp Account，且已選擇正確的 AI Agent。
- Waiting for your first message 卡片會指出 AI Agent 回覆所使用的號碼。請確認你傳訊息到該確切號碼，且該號碼已在面板中啟用，然後按一下 Refresh。
- 如果你在沒有使用者訊息的情況下，於 24 小時後傳送訊息，請使用已核准的範本，並確認已在 WhatsApp Manager 中設定付款方式。
我的 AI 的 WhatsApp 回覆傳送失敗。
- Quickchat AI 會在 WhatsApp 面板上顯示 “WhatsApp replies are failing” 警示，並在你的 dashboard 上顯示通知。常見修正方式：在 WhatsApp Manager 中完成 display-name approval；如果連線已過期或遭撤銷，請按一下 Reconnect；如果 Meta 因品質或政策問題限制你的號碼，請在 WhatsApp Manager 中檢查其狀態。再次成功傳送回覆後，警示會清除。
範本或企業發起訊息失敗。
- 確認你的 Message Templates 已核准，且你的付款方式已在 WhatsApp Manager 中啟用。
- 新寄件者會從訊息限制開始，限制會依據品質和驗證狀態調整。如果你遇到企業發起訊息的限制，請查看 Meta 的 Messaging Limits 指引。
- 如果傳遞受到節流，請在 WhatsApp Manager 中檢查 messaging limits 和 quality rating。
如何建立自己的 WhatsApp 連結和「Chat on WhatsApp」按鈕？
- 請依照這篇 WhatsApp 教學。
如何建立自己的 WhatsApp QR code？
- 前往 WhatsApp Manager → Phone numbers → 選擇你的商務電話號碼 → Message links → Create Message Link。
- 或者，你也可以在 WhatsApp Business 手機 App 中找到它。請依照這篇 WhatsApp 教學。
需要協助？
在 WhatsApp 上與 Quickchat 的 Support AI 聊天：
📱 +1 302-405-9992：開始聊天
或掃描 QR code：
