參考
錯誤碼參考
請求失敗時，優先讀取 error.code，並結合 HTTP 狀態和目前操作判斷原因。error.numeric_code 僅作輔助，不同操作可能重用相同數字碼。error.message 用於閱讀，不用於程式分支；排查時保留 request_id。
400 Bad Request
invalid_request10000檢查 JSON 請求本文與必填欄位。
invalid_provider30000檢查 URL 中的管道識別碼。
unsupported_action30005無法識別此帳號操作，請使用文件列出的操作。
invalid_conversation_type37000type 必須為 user、group 或 channel。
unsupported_conversation_type37001管道不支援此操作，請選擇能力表中支援的操作。
unsupported_message_type36000請使用此管道支援的 message.type。
unsupported_provider_auth_mode20018請使用此管道支援的 auth_mode。
auth_mode_phone_required20019此授權方式要求建立帳號時填寫 provider_data.phone。
invalid_reply_token36006無法讀取引用權杖，請原樣複製入站事件的 data.message.reply_token。
provider_invalid_request30001檢查管道專屬欄位及格式。
create_api_key_failed11101操作被拒絕，請檢查請求並保留 request_id 排查。
update_api_key_failed11102操作被拒絕，請檢查請求並保留 request_id 排查。
rotate_api_key_failed11103操作被拒絕，請檢查請求並保留 request_id 排查。
update_workspace_failed41001操作被拒絕，請檢查請求並保留 request_id 排查。
401 Unauthorized
missing_api_key11000請加入 X-Api-Key 請求標頭。
invalid_api_key11001檢查 API Key 是否正確且已啟用。
403 Forbidden
beta_feature_not_enabled41002工作區需開通內測資格，才能使用通話介面及明確訂閱通話事件。
post_inaccessible39005貼文與留言: 核對帳號及本介面實際要求的目標識別碼。post_not_found 表示已確認貼文不存在；comment_not_found 僅表示驗證後未找到目標第一層留言，不代表已搜尋全部回覆。post_inaccessible 表示無法存取，不證明不存在，也不指明原因。保留錯誤，查明後再選擇下一步。
cors_forbidden11009CORS 來源、方法或請求標頭不被允許，請檢查呼叫環境。
404 Not Found
call_not_found38003通話: 目前帳號與工作區下不存在該通話。
post_not_found39000貼文與留言: 核對帳號及本介面實際要求的目標識別碼。post_not_found 表示已確認貼文不存在；comment_not_found 僅表示驗證後未找到目標第一層留言，不代表已搜尋全部回覆。post_inaccessible 表示無法存取，不證明不存在，也不指明原因。保留錯誤，查明後再選擇下一步。
comment_not_found39001貼文與留言: 核對帳號及本介面實際要求的目標識別碼。post_not_found 表示已確認貼文不存在；comment_not_found 僅表示驗證後未找到目標第一層留言，不代表已搜尋全部回覆。post_inaccessible 表示無法存取，不證明不存在，也不指明原因。保留錯誤，查明後再選擇下一步。
account_not_found20020核對 account_id，並使用帳號所屬工作區的 X-Api-Key。此工作區下未找到的帳號無法使用目前 Key 存取。
not_found10001請檢查 API 路徑與 HTTP 方法。
conversation_not_found37002管道未找到此對話，請核對識別碼與所屬帳號。
contact_not_found35000此帳號下未找到聯絡人，請核對識別碼。
group_not_found34004此帳號下未找到群組，請核對群組 ID。
409 Conflict
call_already_active38000通話: 此帳號已有系統管理的通話。查詢 call_id 後掛斷，或等待結束。
account_webhook_already_exists40008Webhook 端點: 使用 account_id 列出此帳號的獨立端點，更新既有 active 端點。需要切換時，先停用舊 active 端點，再啟用其他端點；不要自動重試建立或重新啟用。
account_allocation_busy20011帳號正在分配，請稍後重試。
no_allocatable_server20013此區域暫無可分配資源，請查詢其他可分配區域。
workspace_account_quota_exceeded20014工作區訊息帳號額度已用滿，請檢查用量與額度。
duplicate_provider_account20015工作區內已有另一個帳號綁定相同管道身分。
account_already_authorized20016帳號已授權，請重複使用；確需重新授權時先取消目前授權。
account_binding_not_found30006帳號尚無有效的管道連線綁定，請檢查帳號狀態。
provider_account_mismatch20017請求中的管道身分與帳號綁定不一致。
provider_not_ready30009連線尚未就緒，請檢查授權及 runtime_status 後再決定是否重試。
422 Unprocessable Entity
contact_not_found35000GET /contacts/info 回傳 Conversation not found，請核對目標識別碼與本次查詢使用的帳號。
500 Internal Server Error
create_call_failed38002通話: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
call_control_failed38004通話: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
request_conversation_history_failed37016請求補拉對話歷史: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
create_account_failed20002建立帳號: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
update_account_failed20003更新帳號: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
delete_account_failed20004刪除帳號: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_account_failed20001取得帳號: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_accounts_failed20000列出帳號: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_session_failed20005取得認證狀態: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_auth_state_failed20006取得認證狀態: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
run_action_failed20007服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
run_runtime_action_failed20008服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
run_session_action_failed20009服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
run_auth_action_failed20010服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
send_message_failed36001傳送文字訊息: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
pin_message_failed36002置頂 / 取消置頂訊息: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
revoke_message_failed36003撤回訊息: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
react_message_failed36004訊息表情回應: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
edit_message_failed36005編輯訊息: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_conversations_failed37003列出會話: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_conversation_failed37004取得會話詳情: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_conversation_members_failed37005列出會話成員: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
mark_conversation_read_failed37006標記會話已讀: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
mark_conversation_unread_failed37007標記會話未讀: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
mute_conversation_failed37008靜音會話: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
unmute_conversation_failed37009取消靜音: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
pin_conversation_failed37010置頂會話: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
unpin_conversation_failed37011取消置頂會話: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_conversation_labels_failed37012列出會話標籤: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
upsert_label_failed37013新建或更新標籤: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
delete_label_failed37014刪除標籤: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
set_label_members_failed37015為會話增刪標籤: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_contacts_failed35001列出聯絡人: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_contact_failed35002取得聯絡人詳情: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
create_contact_failed35003新增聯絡人: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_contact_membership_failed35004查詢聯絡人狀態: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
block_contact_failed35005封鎖聯絡人: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
unblock_contact_failed35006解除封鎖聯絡人: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_blocklist_failed35007取得黑名單: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
set_contact_note_failed35008設定聯絡人備註: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_groups_failed34000列出群組: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_group_failed34001取得群組詳情: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
create_group_failed34002建立群組: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
leave_group_failed34003退出群組: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
update_group_members_failed34005管理群組成員: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
update_group_info_failed34006修改群組資訊: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_group_join_requests_failed34007列出入群申請: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
update_group_join_requests_failed34008核准 / 拒絕入群申請: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
set_group_join_approval_mode_failed34009設定入群審核模式: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_group_invite_code_failed34010取得群組邀請連結: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_webhook_endpoints_failed40000服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
create_webhook_endpoint_failed40001建立 Webhook 端點: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_webhook_endpoint_failed40002取得 Webhook 端點: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
update_webhook_endpoint_failed40003更新 Webhook 端點: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
deactivate_webhook_endpoint_failed40004停用 Webhook 端點: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
delete_webhook_endpoint_failed40005刪除 Webhook 端點: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
get_workspace_failed41000取得目前工作區: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_api_keys_failed11100列出 API Key: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
list_provider_regions_failed30011列出渠道區域: 服務或管道未能完成此操作。保留 request_id；重試寫入操作前先確認上次結果。
501 Not Implemented
unsupported_by_provider30003管道不支援此操作，請選擇能力表中支援的操作。
502 Bad Gateway
list_posts_failed39002貼文與留言: 管道服務暫時無法使用，請檢查狀態或稍後再試；重試寫入操作前先確認上次結果。
get_post_failed39006貼文與留言: 管道服務暫時無法使用，請檢查狀態或稍後再試；重試寫入操作前先確認上次結果。
list_post_comments_failed39003貼文與留言: 管道服務暫時無法使用，請檢查狀態或稍後再試；重試寫入操作前先確認上次結果。
reply_post_comment_failed39004貼文與留言: 核對貼文、已確認的第一層留言和錯誤分類。寫入結果未知時保留 request_id，查明後再決定是否重送；後續查詢缺少回覆不足以作為重試依據。
provider_adapter_not_found30004管道服務暫時無法使用，請檢查狀態或稍後再試；重試寫入操作前先確認上次結果。
provider_unavailable30002管道服務暫時無法使用，請檢查狀態或稍後再試；重試寫入操作前先確認上次結果。
503 Service Unavailable
call_service_unavailable38001通話: 通話服務無法使用，請檢查 Provider/Gateway 連線與設定。
allocation_service_unavailable20012帳號分配服務暫時無法使用，請稍後重試。
Provider 細分數字碼
這些數字碼可細分 Provider 原因，但不會變更原 HTTP 狀態或 legacy code。
provider_operation_failed30010Provider operation failed
管道未能完成操作，請保留 request_id 排查。
group_not_found34004Group not found
未找到群組；部分既有管道介面會保留原 HTTP 狀態與 error.code。
group_not_participant34011Account is not participating in this group
群組可能存在，但目前帳號不是該群組成員。