摘要
若要將您的應用程式或整合與 Wati 連接,您需要 API 金鑰及正確的 API 端點 URL。本指南說明如何產生新的 API 金鑰、設定其到期日與權限,並為 v1、v2 及 v3 API 找到正確的端點 URL。
操作說明
在 Wati 中產生 API 金鑰
請按照以下步驟產生新的 API 金鑰:
登入您的 Wati 帳戶。
前往 Connectors (連接器) > API Tokens (API 金鑰)。
點擊 Generate new token (產生新金鑰)。

若有提示,請輸入金鑰名稱。
根據您的需求設定金鑰的有效期限。
在 Scope (範圍) 下,選擇您的整合所需的權限。如果您的整合需要所有可用權限,請選擇 Select all (全選)。

點擊產生選項並複製金鑰。
重要提示
您的 API 金鑰在產生時僅會顯示一次。請在關閉視窗前複製並妥善保存。如果您遺失了金鑰,則必須產生新的金鑰並更新您的整合設定。
先前可在 API Docs (API 文件) 頁面取得的舊版 Bearer Token,會在關聯的使用者密碼變更時失效。此行為僅適用於舊版金鑰,不適用於新產生的 API 金鑰。新的 API 金鑰將維持有效,直至設定的到期日為止,或直到手動替換為止。
尋找您的 API 端點
您可以在與金鑰相同的頁面上找到您的 API 端點。
Wati 使用以下基礎 URL (主機) 進行 API 請求:
https://live-mt-server.wati.io端點 URL 格式取決於您使用的 API 版本。
適用於 v1 和 v2 API
在基礎 URL 之後直接加上您的 Wati 租戶 ID (tenant ID),接著是 API 路徑。
https://live-mt-server.wati.io/{tenantId}/api/v1/...請將 {tenantId} 取代為您的 Wati 租戶 ID。
適用於 v3 API
請勿在 URL 中包含您的租戶 ID。直接在基礎 URL 後使用 v3 API 路徑。
https://live-mt-server.wati.io/api/ext/v3/...重要:請勿將 /{tenantId}/ 加入 v3 API 端點 URL 中。這將導致端點 URL 錯誤。
關於 API 金鑰的重要注意事項
金鑰到期日:您的 API 金鑰會維持有效,直至設定的到期日為止,或直到手動替換為止。
金鑰安全性:請將您的 API 金鑰保密。請勿公開分享或在用戶端程式碼中暴露金鑰。
金鑰權限:產生金鑰時,請選擇您的整合所需的權限。
金鑰更換:如果您產生了新的替換金鑰,請務必更新您的整合設定以使用新金鑰。
舊版 Bearer Token:先前在 API Docs 中可用的舊版 Bearer Token 已不再提供。您必須在 Connectors > API Tokens 中產生新的 API 金鑰。
Wati 導入了全新的金鑰產生流程以提升安全性。它允許您設定金鑰的有效期限與權限,這些功能在舊版 Bearer Token 中皆無法使用。
如需更多關於可用 API 端點與操作的資訊,請參閱 Wati API 文件。
常見問題解答 (FAQs)
API 金鑰產生與驗證
1. 我可以在 Wati 的哪裡產生 API 金鑰?
您可以登入 Wati 帳戶並導航至 Connectors > API Tokens 來產生 API 金鑰。點擊 Generate new token,設定金鑰的有效期限與權限,即可產生金鑰。
2. API Docs 中的舊版 Bearer Token 還能用嗎?
不能。先前可在 API Docs 中取得的舊版 Bearer Token 已不再提供。您必須在 Connectors > API Tokens 中產生新的 API 金鑰以進行 API 請求驗證。
3. 為什麼 Wati 要求必須產生新的 API 金鑰?
Wati 導入了全新的 API 金鑰產生流程以提升安全性。這讓您可以設定金鑰的有效期限並選取賦予其的權限。
API 金鑰管理
4. 我可以找回先前產生的 API 金鑰或設定其有效期限嗎?
不能。您無法找回先前產生的 API 金鑰,因為 Wati 僅會在金鑰建立時顯示一次。
您可以在產生新 API 金鑰時設定其有效期限。金鑰會在過期或手動替換前保持有效。
如果您遺失了 API 金鑰,請在 Connectors > API Tokens 中產生一個新的金鑰,並更新您的整合設定以使用它。
API 端點 URL
5. 我什麼時候需要在 Wati API 端點 URL 中包含租戶 ID?
使用 Wati v1 和 v2 API 端點時,請在基礎 URL 之後直接加上您的租戶 ID。
請勿在 v3 API 端點 URL 中包含租戶 ID,這些 URL 會使用 /api/ext/v3/ 路徑。
Did this answer your question?