總結
Wati 提供了一組 API，可幫助您以程式設計方式與 WhatsApp 互動。您可以使用這些 API 來傳送和接收訊息、管理聯絡人、處理媒體，以及將 Wati 與您現有的系統整合。本指南清楚概述了可用的 API 以及每個 API 的功能，以便您快速入門。
操作說明
可用的 API
透過 Wati，您可以存取按功能分組的多個 API。
訊息傳送 API
使用這些 API 在 WhatsApp 上傳送和接收訊息。
從 WhatsApp 號碼取得訊息 - 擷取在您的 WhatsApp 號碼上收到的訊息。
傳送會話訊息 - 在活躍的 WhatsApp 會話中傳送訊息。
傳送會話檔案 - 在活躍的會話中傳送檔案附件。
傳送範本訊息 - 傳送預先核准的 WhatsApp 範本訊息。
傳送範本訊息 (批量) - 一次傳送多個範本訊息。
使用 CSV 傳送範本訊息 - 上傳 CSV 檔案以批量傳送範本訊息。
傳送互動式按鈕訊息 - 傳送帶有可點擊按鈕的訊息，以便快速回覆。
傳送互動式清單訊息 - 傳送帶有可選選項清單的訊息。
聯絡人管理 API
使用這些 API 來管理您的聯絡人資料庫。
取得聯絡人清單 - 擷取儲存在 Wati 中的所有聯絡人。
新增聯絡人 - 建立新聯絡人。
更新聯絡人屬性 - 修改現有聯絡人的詳細資料。
媒體與驗證 API
使用這些 API 管理檔案並保護存取安全。
依檔案名稱取得媒體 - 使用檔案名稱擷取媒體檔案。
輪換權杖 - 重新整理您的驗證權杖以維持安全的 API 存取。
操作員和分配 API
使用這些 API 管理聊天擁有權和路由。
分配操作員 - 將 WhatsApp 對話分配給特定的操作員。
我在哪裡可以找到 API 端點和存取權杖？
若要在 Wati 中存取您的 API 詳細資料：
1. 登入您的 Wati 帳戶。
2. 在導覽選單中，按一下API，或前往：Connector → API → Create API Token
3. 在API Tokens頁面上，按一下Generate new token。
4. 輸入權杖名稱，並選取所需的範圍 (權限)，例如：
contacts:readcontacts:writemessagetemplate:read
5. (選用) 設定權杖的到期日。為了安全起見，建議每 6 個月輪換一次權杖。
6. 複製並安全地儲存產生的權杖。
注意：
新的 建立新權杖 選項會移除使用者層級的相依性，並會一直保持有效，直到手動更新或達到其到期日。
當您使用 建立新權杖 選項時，權杖只會在生成時顯示一次，因此請務必複製並妥善保存。
其他資源
Wati API 文件 – 所有可用 API 的詳細參考
Webhook 文件 – 瞭解如何設定和處理 Webhook
Postman 集合 – 用於測試 Wati API 的現成集合
這些 API 可協助您自動執行 WhatsApp 通訊、簡化訊息傳送工作流程，以及更有效率地管理客戶互動。如需實作詳細資料和最佳做法，請參閱文件。
常見問題解答 (FAQ)
訊息傳送 API
1. Wati 訊息傳送 API 用於什麼用途？
Wati 訊息傳送 API 可讓您以程式設計方式傳送和接收 WhatsApp 訊息。 這些 API 啟用諸如擷取在您的 WhatsApp 號碼上收到的訊息、在活躍的 WhatsApp 會話中傳送訊息或檔案、傳送預先核准的範本訊息、傳送批量範本訊息，以及傳送具有按鈕或可選清單的互動式訊息等動作。
2. 如何使用 Wati API 擷取在您的 WhatsApp 號碼上收到的訊息？
您可以使用從 WhatsApp 號碼取得訊息 API 擷取在您的 WhatsApp 號碼上收到的訊息。 此 API 會傳回已在 Wati 中連線的 WhatsApp 號碼上收到的訊息。
3. 可以使用 Wati 訊息傳送 API 傳送哪些類型的訊息？
Wati 訊息傳送 API 可讓您傳送多種類型的訊息，包括在活躍的 WhatsApp 會話期間傳送會話訊息、在活躍的會話中傳送檔案附件、傳送預先核准的 WhatsApp 範本訊息、傳送批量範本訊息、傳送互動式按鈕訊息，以及傳送互動式清單訊息。
聯絡人管理 API
4. Wati 聯絡人管理 API 用於什麼用途？
Wati 聯絡人管理 API 可讓您管理儲存在 Wati 中的聯絡人資料庫。 這些 API 可讓您擷取聯絡人清單、建立新聯絡人，以及更新現有聯絡人的屬性。
5. 如何使用 Wati API 擷取或更新聯絡人？
您可以使用取得聯絡人清單 API 擷取聯絡人、使用新增聯絡人 API 建立新聯絡人，以及使用更新聯絡人屬性 API 修改聯絡人詳細資料。
媒體、驗證和對話管理
6. Wati 中的媒體與驗證 API 用於什麼用途？
媒體和驗證 API 可讓您擷取儲存在 Wati 中的媒體檔案，並維持安全的 API 存取。 例如，依檔案名稱取得媒體 API 會擷取儲存的媒體檔案，輪換權杖 API 會重新整理用於存取 Wati API 的驗證權杖。
7. 如何使用 Wati API 將 WhatsApp 對話分配給操作員？
您可以使用分配操作員 API 將 WhatsApp 對話分配給特定的操作員。 此 API 會將對話傳送到選定的操作員，以便他們可以管理聊天。
API 存取與設定
8. 在哪裡可以找到 Wati 中的 API 端點和存取權杖？
您可以登入您的 Wati 帳戶，然後在導覽選單中導覽至 API，或前往 Connector → API → Create API Token，即可找到 API 端點和存取權杖。
9. 如何在 Wati 中產生新的 API 權杖？
若要產生新的 API 權杖，請開啟 Wati 中的 API Tokens 頁面，按一下 Generate new token，輸入權杖名稱，選取所需的範圍，例如 contacts:read、contacts:write 或 messagetemplate:read，選擇性地設定到期日，然後複製並安全地儲存產生的權杖。 建議每六個月輪換一次權杖，以確保安全。