跳到內容
Quickchat AI Documentation
EnglishDeutschEspañolFrançais日本語PolskiPortuguêsSvenskaالعربيةBahasa IndonesiaРусскийTiếng Việt繁體中文ไทยItalianoNederlandsУкраїнськаעברית한국어Türkçe

WhatsApp

將 Quickchat AI Agent 連接到 WhatsApp Business。本指南說明先決條件、設定步驟，以及如何正式啟用 WhatsApp 訊息服務。

本指南說明如何將 Quickchat AI Agent 與 WhatsApp 整合。流程分成 2 個簡單步驟：

  • 步驟 0 - 先決條件
  • 步驟 1 - 連接 WhatsApp

若整合時遇到問題或需要協助，請參閱 疑難排解與常見問題，或 聯絡我們。

選用設定工具

Section titled “選用設定工具”

  • 檢查 WhatsApp 設定先決條件。將您提供的號碼與服務商資訊，對照文件中的設定要求。此工具不會存取或連接 WhatsApp 帳戶。

  • 檢查 WhatsApp 服務時段。根據提供的收訊與回覆時間戳記（含時區偏移量），檢查 24 小時服務時段。此工具不會驗證範本、同意或帳戶權限，也不會傳送訊息。

  • 估算使用成本。計算 Quickchat AI 模型信用額度，並另外加總提供的費用項目。此工具不會查詢服務商費率、將信用額度與金額合併，或檢查您的帳戶。

觀看影片

Section titled “觀看影片”
Play

步驟 0 - 先決條件

Section titled “步驟 0 - 先決條件”

A. 商用電話號碼

Section titled “A. 商用電話號碼”

決定要用於 WhatsApp 的電話號碼。您可以 閱讀 WhatsApp 文件，或參考下列常見問題：

WhatsApp Cloud API 可以使用哪些號碼？

  • 必須使用能接收簡訊或語音電話以完成驗證的專用商用號碼。
  • 號碼必須有效、由您擁有，且包含國碼與區碼。

可以使用已用於 WhatsApp Messenger 的號碼嗎？

  • 不可以。您仍可用該號碼通話及收發簡訊，但不能同時用於 WhatsApp Messenger。
  • 如果號碼已用於 WhatsApp Messenger，請 先刪除。別忘了 備份 WhatsApp 聊天紀錄。
  • 遭封鎖的號碼必須先解除封鎖才能註冊。

可以使用已用於 WhatsApp Business App 的號碼嗎？

  • Quickchat AI 目前的連接流程，尚未提供經驗證、適用於既有 WhatsApp Business App 號碼的 Coexistence 共存途徑。Meta 在 Business App 初始設定指南 說明支援的整合如何使用共存功能。
  • 如果需要保留既有號碼、Business App 帳戶及聊天紀錄，請先寄信至 support@quickchat.ai 再繼續。請勿將刪除或解除 Business App 帳戶連接，或遷移號碼，當作疑難排解步驟。

可以使用新的電話號碼嗎？

  • 可以。若不想使用現有號碼，可取得新號碼（實體 SIM 卡或虛擬號碼）。您可向 Hushed 等服務購買虛擬電話號碼。

B. 商家資訊

Section titled “B. 商家資訊”

請備妥以下資訊（會在 Meta 整合流程中輸入）：

  • 商家名稱
  • 商家網站
  • 商家類別
  • 商家說明

即使部分欄位看似選填，也請正確填寫。資訊缺漏或不正確可能延誤核准，或造成帳戶受限。

步驟 1 - 連接 WhatsApp

Section titled “步驟 1 - 連接 WhatsApp”

開啟 Quickchat AI 應用程式 → External Apps → WhatsApp → 按一下 Connect WhatsApp，並依 Meta 彈出視窗操作：

您也可以從 ChatGPT、Claude 或其他已連接的 AI 應用程式 開始：請它提供將這個 Agent 連接到 WhatsApp 的連結。連結有效期限為 10 分鐘，只能使用一次，且限提出要求的 Quickchat 帳戶使用。在已登入該帳戶的瀏覽器開啟，完成 Meta 設定，並在 Quickchat 重新開啟時完成帳戶或號碼選擇。接著請 AI 應用程式檢查設定，並傳送真實 WhatsApp 訊息確認收到 AI 回覆。若連接多個號碼，請逐一測試所有啟用號碼。Meta 存取權由您在瀏覽器核准，無需在聊天中分享權杖。

  1. 登入 Meta（Facebook）帳戶。
  2. 檢視將分享給 Quickchat AI 的權限（WhatsApp Business 帳戶存取權與商業資產組合存取權），再繼續。
  3. 提供正確商家資訊（Business Portfolio、Business Name、Business Website、Country 等）。
  4. 建立或選擇 WhatsApp Business Account。
  5. 選擇 WhatsApp Business 顯示名稱與類別。
  6. 新增商用電話號碼，並依提示透過簡訊或語音電話驗證。
  7. 按一下 Confirm，授予 Quickchat AI 所需存取權。
  8. Meta 確認設定完成後，按一下 Finish。彈出視窗會顯示 Quickchat AI 的 WhatsApp 帳戶連接成功確認，然後自動關閉。

若 Meta 授予 Quickchat AI 多個帳戶的存取權，WhatsApp 面板會顯示 Choose your WhatsApp Business Account，而非立即連接。選擇 AI Agent 應回覆的帳戶，再按 Use this account。若您正在重新連接，確認前現有 WhatsApp 設定會保持不變。

返回 Quickchat AI 應用程式後，WhatsApp 面板會顯示 Finish setup，直到您自己的商用號碼完成成功的訊息往返驗證。若約 30 秒後面板仍未更新，請按重新整理圖示。

連接 Meta 和收到訊息只是設定的一部分。面板會顯示每個啟用號碼的下一步：

  • Waiting for your first message：從另一支手機向顯示的號碼傳送 WhatsApp 訊息，再按 Refresh。請確認傳送到客戶實際會使用的商用號碼。
  • Waiting for the AI reply to be delivered：Quickchat 已收到訊息，但 WhatsApp 尚未確認 AI 回覆送達。檢查另一支手機是否收到回覆。如果沒有，請檢查 AI 信用額度及面板警告，再傳送一則測試訊息。
  • AI reply delivered：WhatsApp 已確認，此商用號碼針對收到的訊息所產生的 AI 回覆已送達。
  • Verification needs attention：處理連線警告、保持目標號碼啟用，再傳送新的測試訊息。
  • Display name：面板下方每個號碼都會顯示 Meta 的顯示名稱狀態（Approved、Pending review、Declined、Expired 或 No display name）。審查中不需採取行動，通常數天內完成。若遭拒、到期或沒有名稱，系統會要求您到 WhatsApp Manager 提交。
  • Meta test number：Meta 提供的 +1 555 號碼與沙箱號碼，無法驗證商用號碼已啟用。請在 WhatsApp Manager 新增自己的號碼，在 Quickchat 啟用，再測試該號碼。

所有啟用的商用號碼都完成訊息往返驗證，且連線檢查正常後，面板才會顯示 Live。若啟用多個商用號碼，請逐一測試。測試號碼的成功往返、已送出的範本，或訊息額度通知，都不能完成此檢查。

測試時請保持整合啟用。從另一支手機向每個目標商用號碼傳訊息，確認 AI 回覆已到達，再按 Refresh。對話也應出現在 Quickchat AI 應用程式 的 Inbox。既有連線可能要求新的測試往返以驗證送達；完成此步驟期間，仍可繼續接收與回覆訊息。

若 Meta 仍有未完成的初始設定步驟，請前往 Setup guidance，完成 WhatsApp Manager 中的待辦設定。Meta 設定尚未完成時，Quickchat AI 也會寄送提醒給帳戶擁有者。

疑難排解與常見問題

Section titled “疑難排解與常見問題”

WhatsApp Business API 如何計費？

  • WhatsApp 將回覆使用者主動發起的傳入客戶詢問視為服務訊息。商家可以透過真人客服或對話式 AI Bot 處理這些詢問。
  • 使用者傳訊息給商家時，會開啟 24 小時客戶服務時段。商家在此期間可免費使用服務訊息回覆。每次使用者傳訊息都會重新計算此時段。
  • 超過 24 小時後，必須使用已核准的 Message Templates（Marketing、Utility、Authentication 等），並依 WhatsApp Business Platform 訊息費率 按則付費。
  • 對話由 Meta 分類與計費。請確保 WhatsApp Business Account 有有效付款方式，以傳送商家主動發起或範本訊息。

Connect WhatsApp 按鈕無法使用，看不到 Meta 彈出視窗。

  • 若瀏覽器封鎖彈出視窗，請允許 Quickchat AI 應用程式的彈出視窗，再按 Try again。也可以按 Continue on Meta in this tab，在不使用彈出視窗的情況下完成相同設定。

Quickchat couldn’t confirm the WhatsApp connection

Meta 視窗未傳回結果，而 Quickchat 仍無法驗證連線時，會顯示此復原訊息。這不代表 Meta 沒有做出任何變更。

  1. 確認您是擁有該 WhatsApp Business Account 的 Meta Business 管理員。若不是，請管理員透過自己的 Facebook 登入來連接。
  2. 按 Try again。若阻擋程式影響 Meta 視窗，請使用暫停擴充功能的無痕視窗，或按 Continue on Meta in this tab。
  3. 若號碼目前用於 WhatsApp Messenger，請先從該處移除，或使用其他號碼。若用於 WhatsApp Business App，請在此停止，寄信至 support@quickchat.ai 後再繼續。Quickchat AI 目前的連接流程尚無經驗證的 Coexistence 途徑。請勿為排除此訊息而刪除或解除 Business App 帳戶連接，或遷移號碼。
  4. 如果 WhatsApp Business Account 使用 Aircall、Twilio、360dialog、MessageBird 或其他服務商，請在 Meta Business Settings 將 Quickchat AI 加為合作夥伴：
    1. 開啟 Meta Business Settings，前往 Accounts → WhatsApp Accounts。
    2. 選擇 WhatsApp Business Account，開啟 Partners，再按 Add Partners。
    3. 輸入 Quickchat AI 的 Business ID：270696274483463。
    4. 授予 Manage WhatsApp accounts，返回 Quickchat AI 並重新整理狀態。

只有 Meta 不允許同一帳戶同時使用兩個合作夥伴時，才解除其他服務商連接。若不確定，請在解除使用中的訊息服務商之前 聯絡支援。

號碼驗證失敗。

  • 確認號碼可接收簡訊或語音電話。
  • 一般的 Ineligible 訊息或 This number can’t be shared with this app 提示，無法判定原因，也無法確認是否符合 Meta 共存要求。請將完整訊息及出現步驟寄至 support@quickchat.ai。
  • 若號碼用於 WhatsApp Business App，且需要保留該帳戶與紀錄，請先聯絡支援再繼續。不要嘗試刪除或解除帳戶連接，或遷移號碼來清除錯誤。

我連接了錯誤的帳戶。

  • Reconnect 會保留已連接的帳戶。若要將 AI Agent 移至另一個 WhatsApp Business Account，請在 WhatsApp 面板按 Disconnect，再按 Connect WhatsApp，並在 Meta 視窗選擇正確的 Meta Business 帳戶與 WhatsApp Account。

We could not tell which WhatsApp Business Account to connect

  • 您的 Meta 登入有多個包含電話號碼的 WhatsApp Business Account，Quickchat 無法判斷您要使用哪一個。請將想連接的號碼寄至 support@quickchat.ai，我們會協助完成設定。

訊息沒有出現在 Quickchat AI Inbox。

  • 確認彈出視窗已顯示最後確認訊息：“WhatsApp account connected!”。
  • 再次確認已連結目標 WhatsApp Account，並選擇正確的 AI Agent。
  • Waiting for your first message 卡片會顯示 AI Agent 回覆的號碼。確認您傳訊息到該號碼、面板中已啟用該號碼，再按 Refresh。
  • 若沒有新的使用者訊息，且已超過 24 小時，請使用已核准範本，並確認已在 WhatsApp Manager 設定付款方式。

AI 的 WhatsApp 回覆無法傳送。

若 AI 回覆無法送達，Quickchat AI 會在 External Apps 的 WhatsApp 面板顯示 “WhatsApp replies are failing” 警示，並在控制台顯示通知。常見原因與解法如下：

  • Meta 測試號碼的顯示名稱尚未核准： Meta 會暫停其提供的 +1 555 號碼回覆，直到顯示名稱核准。面板的名稱警示會變紅並指出號碼。請等待審查完成（通常數天），若遭拒則在 WhatsApp Manager 提交新名稱，再傳送測試訊息。您自己的號碼若名稱仍在審查，這件事本身不會阻擋回覆；面板會以備註顯示。
  • 連線到期或遭撤銷： WhatsApp 連線已失效。開啟 WhatsApp 面板並按 Reconnect，恢復回覆傳送。
  • 號碼受限： Meta 因品質評等或政策問題限制號碼。請在 WhatsApp Manager 檢查狀態，恢復傳送。
  • Business Account 遭鎖定（錯誤 131031）： Meta 已封鎖 WhatsApp Business Account 的回覆。Inbox 傳送錯誤與 WhatsApp 面板會說明限制。開啟 Business Support Home，選擇 WhatsApp 帳戶及違規項目，再按 Request Review。Meta 僅透過此審查解除帳戶鎖定；重新連接 Quickchat 不會解除限制。

其他警示會在再次成功傳送回覆後自動清除。帳戶鎖定警示則會保留，直到新的真實訪客訊息獲得完全送達的 AI 回覆，因為 Meta 可能先接受回覆，之後仍傳送失敗。若只有 Meta 測試號碼（+1 555）啟用，下一則成功傳送的 AI 回覆就會清除警示。Support AI 也能解釋最近儲存的帳戶鎖定失敗紀錄，但歷史證據不代表帳戶現在仍鎖定。

範本或商家主動發起的訊息失敗。

  • 確認 Message Templates 已核准，並在 WhatsApp Manager 啟用付款方式。
  • 新傳送者有初始訊息傳送限制，會隨品質與驗證狀況調整。如果商家主動發送達到限制，請參閱 Meta 的 Messaging Limits 指南。
  • 若傳送受到節流限制，請在 WhatsApp Manager 檢查訊息傳送限制與品質評等。

如何建立自己的 WhatsApp 連結與 “Chat on WhatsApp” 按鈕？

<!-- WhatsApp inline button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

或

<!-- WhatsApp floating button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

如何建立自己的 WhatsApp QR code？

  • 開啟 WhatsApp Manager → Phone numbers → 選擇商用電話號碼 → Message links → Create Message Link。
  • 也可以在 WhatsApp Business 行動應用程式找到。請參考 這份 WhatsApp 教學。

應該解除 WhatsApp Business App 帳戶連接來修復設定嗎？

  • 不應該。 請勿將刪除或解除 Business App 帳戶連接，或遷移號碼，作為疑難排解步驟。Quickchat AI 目前的連接流程尚無經驗證、可保留既有應用程式設定與歷史紀錄的 Coexistence 途徑。
  • 變更使用中的 Business App 帳戶前，請先寄信至 support@quickchat.ai。Meta 的 Business App 初始設定指南 說明支援整合的共存功能，但不代表您的 Quickchat AI 設定可使用。

Quickchat AI 取得我們 WhatsApp Business Account 的哪些存取權？

  • 限定範圍的 API 存取權，而非帳戶所有權。 WhatsApp Business Account（WABA）位於您自己的 Meta Business Manager。依 Meta 的 WABA Sharing 模型，資產仍由您擁有，Quickchat AI 只是新增的合作夥伴，您隨時可在 Business Manager 撤銷其存取權。
  • 整合啟用期間，我們可透過 Cloud API 收發訊息，並透過 webhook 接收訊息事件。
  • 我們無法關閉、移轉或更改您帳戶的品牌識別，也無法變更帳務或移除管理員。

需要協助？

Section titled “需要協助？”

透過 WhatsApp 與 Quickchat 的 Support AI 聊天：
📱 +1 302-405-9992：開始聊天

或掃描 QR code：

WhatsApp QR code

最後更新於：

開始使用

簡介快速入門透過 AI 管理

AI Agent

身分設定Knowledge Base

Actions

ActionsEnglishHuman HandoffEnglishSmart Data GatheringEnglishMCP ActionsEnglishGoogle SheetsEnglishAI Action VariablesEnglishJira ticket searchEnglish
Images & filesEnglishDuplicate an AI AgentEnglish

對話

InboxEnglish
Insights
測試

Channels

您的網站

網站WordPressEnglishShopifyEnglishDrupalEnglish

Helpdesk 與 CRM

IntercomEnglishHubSpotEnglishEmailEnglishZendeskEnglish

通訊應用程式

DiscordWhatsAppTelegramSlackEnglishFacebook MessengerEnglishInstagramEnglish
MCPEnglish

帳戶與帳務

Account access and password recoveryEnglishTeam & rolesEnglishPlans & limitsEnglishUnderstanding AI creditsEnglishQuickchat Support AIEnglishDelete an AI AgentEnglish
GitHubXDiscordYouTube