會話
標記會話已讀
將會話標記為已讀。conversation_id 透過 JSON body 傳入（不走 path，因為渠道側 ID 可能含 @ / : 等字元）。Telegram 必須提供目前帳號在該會話收到的單一訊息的 up_to_message_id，將該訊息及先前訊息標記為已讀；不支援省略訊息 ID 或提供非空 up_to_message_sender_id。WhatsApp 訊息級已讀需要成對傳入非空 up_to_message_id 與 up_to_message_sender_id；群聊傳送者使用對應 webhook 的 data.sender.id。僅 WhatsApp 支援省略這兩個欄位，或兩者去除首尾空白後皆為空時，將整個會話標記為已讀；僅一個值非空時回傳 400 invalid_request。
https://api.unifyport.ai/v1/accounts/{account_id}/conversations/read支援渠道
呼叫前準備
在伺服器端使用資源所屬工作區的 X-Api-Key，執行範例前替換所有預留位置。
參數從哪裡取得
- account_id
- 從建立或查詢帳號的回應取得 data.id。帳號屬於 X-Api-Key 對應的工作區。 取得帳號
請求參數
請求標頭
X-Api-Key工作區 API Key，工作區會由此標頭解析得到。
Content-Type傳送 JSON 請求內容時請使用 application/json。
路徑參數
account_id用於該 conversations 路由的識別字。
請求內容
conversation_id目標對話識別字。
up_to_message_id依帳號所屬渠道驗證，欄位類型始終為字串。Telegram 必填：目前帳號在該對話收到的單一訊息 ID，例如 message.received 的 data.message.id，且 data.message.direction=inbound。去除首尾空白後只能包含 ASCII 十進位數字，數值範圍為 1–2147483647；將截至該訊息（含該訊息及先前訊息）標記為已讀。不可使用逗號清單、正負號、小數、指數、內部空白或非 ASCII 數字，也不可省略或使用 0 表示整個對話。WhatsApp 選填：一個訊息 ID，或屬於同一發送者的多個訊息 ID（以英文逗號分隔）；與 up_to_message_sender_id 成對提供非空值。省略兩者，或兩者去除首尾空白後皆為空時，將整個對話標記為已讀。
up_to_message_sender_idWhatsApp 訊息層級已讀的渠道端發送者識別字，與 up_to_message_id 成對提供非空值；群組對話應傳入 Webhook 事件中的 data.sender.id。多個訊息 ID 必須屬於同一發送者。Telegram 不支援此參數，提供非空值時回傳 invalid_request。
如何理解結果
依本介面的回應欄位與 HTTP 狀態判斷結果，再透過相關操作選擇下一步。
回應 200 OK
{
"request_id": "<REQUEST_ID>",
"data": {
"ok": true
}
}
回應內容
ok操作成功時恆為 true；失敗時則改回傳非 2xx 狀態碼。
回應
200200 OK
請求成功，回應內容範例如上。
400請求錯誤
請求內容、路徑或參數無效。
401未授權
X-Api-Key 請求標頭缺少或無效。
404找不到資源
找不到請求的資源；請結合 error.code 和目前操作核對。
409衝突
目前操作與既有的渠道帳號或資源衝突。
500伺服器錯誤
服務遇到了未預期的錯誤。
501渠道尚未實作
所選渠道尚未實作此操作。
502上游閘道錯誤
渠道轉接器或上游渠道未能完成此操作。
失敗後如何處理
檢查 HTTP 狀態和 error.code/numeric_code，保留 request_id。依原因修正參數、繼續授權或檢查狀態。重試傳送及寫入前確認上次結果，避免重複操作。 錯誤碼參考
- invalid_request · 10000 · 400
- 檢查必填欄位、格式與渠道條件，修正請求後再呼叫。
- missing_api_key · 11000 · 401
- 檢查 X-Api-Key 與工作區是否有效。
- invalid_api_key · 11001 · 401
- 檢查 X-Api-Key 與工作區是否有效。