เอกสารอ้างอิง API

อ้างอิง

อ้างอิงรหัสข้อผิดพลาด

เมื่อคำขอล้มเหลว ให้ตรวจสถานะ HTTP แล้วใช้ error.code หรือ error.numeric_code ห้าหลักเพื่อระบุสาเหตุ error.message ใช้สำหรับอ่าน ไม่ใช้ตัดสินเงื่อนไขในโปรแกรม เก็บ request_id ไว้ตรวจสอบปัญหา

400 Bad Request

  • invalid_request10000

    ตรวจ JSON และฟิลด์ที่จำเป็น

  • invalid_provider30000

    ตรวจรหัสช่องทางใน URL

  • unsupported_action30005

    ไม่รู้จักการทำงานของบัญชีนี้ ให้ใช้การทำงานตามเอกสาร

  • invalid_conversation_type37000

    type ต้องเป็น 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

    เวิร์กสเปซต้องมีสิทธิ์ทดสอบแบบปิดเพื่อใช้ API การโทรและสมัครรับเหตุการณ์การโทรอย่างชัดเจน

  • cors_forbidden11009

    ไม่อนุญาตแหล่งที่มา วิธี หรือส่วนหัว CORS ให้ตรวจสภาพแวดล้อมที่เรียกใช้

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_found35000

    GET /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

    บริการจัดสรรบัญชีไม่พร้อมชั่วคราว โปรดลองภายหลัง

numeric code รายละเอียดของ Provider

รหัสเหล่านี้ระบุสาเหตุของ Provider ให้ละเอียดขึ้นโดยไม่เปลี่ยน HTTP status หรือ legacy code เดิม

  • provider_operation_failed30010

    Provider operation failed

    ช่องทางทำงานไม่สำเร็จ เก็บ request_id เพื่อตรวจสอบ

  • group_not_found34004

    Group not found

    ไม่พบกลุ่ม เส้นทางช่องทางเดิมบางส่วนยังใช้สถานะ HTTP และ error.code เดิม

  • group_not_participant34011

    Account is not participating in this group

    กลุ่มอาจมีอยู่ แต่บัญชีนี้ไม่ได้เป็นสมาชิก