參考
錯誤碼參考
請求失敗時，先查看 HTTP 狀態，再讀取 error.code 或五位數字 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工作區需要內測資格，才可使用通話介面及明確訂閱通話事件。
cors_forbidden11009CORS 來源、方法或請求標頭不被允許，請檢查呼叫環境。
404 Not Found
call_not_found38003目前帳戶及工作區沒有該通話。
not_found10001請檢查 API 路徑與 HTTP 方法。
conversation_not_found37002渠道未找到此對話，請核對識別碼與所屬帳戶。
contact_not_found35000此帳戶下未找到聯絡人，請核對識別碼。
group_not_found34004此帳戶下未找到群組，請核對群組 ID。
409 Conflict
call_already_active38000此帳戶已有系統管理的通話。查詢 call_id 後掛線，或等待結束。
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；重試寫入操作前先確認上次結果。
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
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
群組可能存在，但目前帳戶不是該群組成員。