摘要
當您使用 Wati API 在有效的 WhatsApp 會話中發送檔案時，如果您未在請求中包含 caption 參數，附件名稱可能會顯示為 null 或 untitled。
要解決此問題，請將 caption 參數作為查詢參數包含在內，並將其設定為您想要顯示的檔案名稱。本文介紹如何使用舊版 v1 API 應用此修復程式，並提供建議使用的 v3 API 相關指引。
操作說明
1. 修復附件名稱
caption 參數指定了檔案附件所顯示的名稱。如果您省略此參數，附件名稱可能會顯示為 null 或 untitled。
若要顯示正確的檔案名稱，請在 API 請求中將 caption 作為查詢參數包含在內。
重要提示：請將 caption 放入查詢字串（Query String）中，而非請求主體（Request Body）中。請將檔案本身作為名為 file 的 multipart 表單欄位進行發送。
2. 使用舊版 v1 API 修復問題
您可以使用舊版 v1 端點在有效的 WhatsApp 會話中發送檔案。
端點：
POST https://live-mt-server.wati.io/{tenantId}/api/v1/sendSessionFile/{target}
API 參數
參數 | 類型 | 位置 | 說明 |
| 字串 | 路徑 | 您的 Wati 租戶 ID。 |
| 字串 | 路徑 | 收件人的電話號碼、聯絡人 ID 或商務範圍使用者 ID (BSUID)。 |
| 字串 | 查詢參數 | 附件要顯示的檔案名稱。 |
| 檔案 | Multipart 請求主體 | 您要發送的檔案。請使用 |
請求範例
以下範例發送了一個名為 Invoice_October.pdf 的檔案，並使用該名稱作為附件標題。
curl --location 'https://live-mt-server.wati.io/{tenantId}/api/v1/sendSessionFile/85264318722?caption=Invoice_October.pdf' \
--header 'Authorization: Bearer <Token>' \
--form 'file=@"/path/to/Invoice_October.pdf"'請將以下預留位置替換為您的實際值：
{tenantId}— 您的 Wati 租戶 ID。85264318722— 收件人的電話號碼。<Token>— 您的 Wati API 存取權杖。/path/to/Invoice_October.pdf— 您要上傳的檔案路徑。
您可以將 Invoice_October.pdf 更改為您想要顯示的附件名稱。
3. 使用建議的 v3 API
對於新的整合，建議在支援的情況下使用 v3 API。
端點：
POST https://live-mt-server.wati.io/api/ext/v3/conversations/messages/file
與舊版 v1 端點不同，v3 端點路徑不包含 /{tenantId}/。
請在您的 Wati 帳戶中，透過 Connector > API > Create API Token 建立範圍限定的 API 權杖。
target 欄位亦支援 Channel:PhoneNumber 格式。
請參閱 Wati 開發人員文件，以取得 v3 端點所需的參數與請求格式資訊。
4. 重要注意事項
包含標題：將
caption參數作為查詢參數傳遞，以指定附件名稱。使用正確的檔案欄位：將檔案作為名為
file的 multipart 表單欄位上傳。正確檢查 API 回應：HTTP
200回應僅表示請求已被接受；這並不代表檔案已成功送達收件人。追蹤送達狀態：使用
sentMessageDELIVERED_v2webhook 事件來確認訊息是否送達。
遵循這些準則有助於防止在透過 Wati API 發送檔案時，附件名稱顯示為 null 或 untitled。