API keys
สร้าง API key พร้อมสิทธิ์แยกตามข้อมูล เก็บ secret ที่แสดงครั้งเดียว ออก secret ใหม่โดยไม่สะดุด และดูการใช้งานของแต่ละ key
ในหน้านี้
API key ใช้ให้ระบบอื่น เช่น ERP, สคริปต์ของคุณ หรือ AI assistant ผ่าน MCP เข้าถึงข้อมูลใน workspace ผ่าน Open API หน้านี้ใช้ได้เฉพาะเจ้าของและแอดมิน
ภาพรวม #
- เปิดที่ ตั้งค่า → Developer แท็บ API keys
- 1 key ใช้ได้กับ 1 workspace เท่านั้น ไม่ต้องส่ง workspace id
- Key ขึ้นต้นด้วย
khv_live_และมีอายุ 6 เดือน - Key คือรหัสผ่าน ใช้ 1 key ต่อคนหรือต่อบริการ ให้สิทธิ์น้อยที่สุด และลบ key ที่ไม่ใช้แล้ว
แท็บ API keys ในหน้า Developer
สร้าง API key #
- 1
เปิด ตั้งค่า → Developer แล้วเลือกแท็บ API keys
- 2
กด สร้าง API key
- 3
ใส่ ชื่อ key (1–80 ตัวอักษร) เช่น "ERP sync" เพื่อให้รู้ว่าใช้กับระบบไหน
- 4
ที่ สิทธิ์ต่อข้อมูล เลือกให้แต่ละข้อมูลเป็น ไม่ให้สิทธิ์, อ่าน หรือ อ่านและเขียน
- 5
บันทึก แล้วคัดลอก key จากหน้าต่าง คัดลอกเก็บไว้ตอนนี้
- 6
เก็บ key ในที่ปลอดภัย แล้วกด คัดลอกเก็บแล้ว
Key ใหม่เริ่มต้นเป็นอ่านอย่างเดียวทุกข้อมูล ใช้ปุ่ม อ่านทั้งหมด, เขียนทั้งหมด หรือ ไม่ให้ทั้งหมด เพื่อตั้งทีเดียว ถ้าให้สิทธิ์เขียน จะมีคำเตือนว่า key นี้แก้ไขข้อมูลได้ เช่น ส่งข้อความหรือปิด ticket
สิทธิ์ (scopes) #
สิทธิ์แต่ละอย่างอยู่ในรูป <ข้อมูล>:read หรือ <ข้อมูล>:write และสิทธิ์เขียนรวมสิทธิ์อ่านแล้ว
| ข้อมูลในหน้าจอ | Scope | ใช้ทำอะไร |
|---|---|---|
| Ticket | tickets | ดู ค้นหา แก้ มอบหมาย ปิด และเปิด ticket อีกครั้ง |
| บทสนทนา | conversations | ดูบทสนทนา ติดหรือถอด label ทำเครื่องหมายว่าอ่านแล้ว |
| รายชื่อลูกค้า | contacts | ดู ค้นหา สร้าง แก้ และรวมลูกค้า |
| ข้อความ | messages | อ่านข้อความและโน้ต ส่งข้อความตอบลูกค้า เขียนโน้ตภายใน |
| บัญชีช่องทาง | accounts | ดูช่องทางที่เชื่อมไว้ |
| ผู้ใช้ | users | ดูรายชื่อสมาชิก |
| ทีม | teams | ดูรายชื่อทีม |
| Label | labels | ดูรายการ label |
| Analytics | analytics | ดึงสรุปรายงานและ event |
ในรายการยังมี Broadcast และ ฐานความรู้ AI แต่ Open API ไม่มี endpoint ของสองข้อมูลนี้ จึงตั้งเป็น ไม่ให้สิทธิ์ ได้เลย
Secret แสดงครั้งเดียว #
Khuivo เก็บไว้เฉพาะค่า hash ของ key จึงแสดง key เต็มได้ครั้งเดียวตอนสร้าง ในรายการจะเห็นแค่ส่วนต้นของ key ถ้าทำหาย ให้ ออก secret ใหม่ หรือสร้าง key ใหม่
อายุของ key #
- Key หมดอายุ 6 เดือนหลังสร้าง หรือหลังออก secret ใหม่ครั้งล่าสุด
- ช่วง 14 วันสุดท้าย รายการจะแสดง ใกล้หมดอายุ และผู้สร้าง key จะได้อีเมลเตือนก่อนหมดอายุ 14, 7 และ 1 วัน
- Key ที่ หมดอายุแล้ว เรียก API ไม่ได้ ให้ออก secret ใหม่หรือสร้าง key ใหม่
ออก secret ใหม่ (rotate) #
ใช้เมื่อ key ใกล้หมดอายุ สงสัยว่า key รั่ว หรือมีคนที่รู้ key ออกจากทีม
- 1
ในแท็บ API keys หา key ที่ต้องการ แล้วกด ออก secret ใหม่
- 2
ยืนยัน แล้วคัดลอก secret ใหม่ที่แสดงครั้งเดียว
- 3
เปลี่ยน key ในระบบที่ใช้อยู่ภายใน 2 ชั่วโมง
secret เดิมยังใช้ได้อีก 2 ชั่วโมงเพื่อให้คุณเปลี่ยนได้โดยระบบไม่สะดุด รายการจะแสดง secret เดิมใช้ได้ถึง พร้อมเวลา ถ้า key รั่ว ให้ลบ key ทิ้งแทน เพราะการลบมีผลทันที
ดูการใช้งาน #
ในรายการ key แต่ละอันแสดง:
- ใช้ล่าสุด — ครั้งล่าสุดที่ key ถูกใช้ (หรือ ยังไม่เคย)
- IP ล่าสุด — ที่อยู่ IP ของคำขอล่าสุด
- จำนวน request — จำนวนครั้งที่เรียก API
- วันที่ หมดอายุ และจำนวนข้อมูลที่ อ่าน / เขียน ได้
ทุกการเรียก API ถูกบันทึกใน audit log ด้วย
แก้ไขหรือลบ key #
- แก้ชื่อหรือสิทธิ์ของ key ได้จากรายการ โดยไม่ต้องออก key ใหม่
- ลบ key แล้ว ระบบที่ใช้ key นั้นจะเรียก API ไม่ได้ทันที
เคล็ดลับ #
- แยก key ตามระบบ เช่น ERP หนึ่ง key และ AI assistant อีก key เวลาต้องยกเลิกจะไม่กระทบระบบอื่น
- เริ่มจากสิทธิ์อ่านอย่างเดียว แล้วเพิ่มสิทธิ์เขียนเฉพาะข้อมูลที่จำเป็น
- ดู ใช้ล่าสุด เป็นระยะ key ที่ไม่ได้ใช้นานแล้วควรลบ
ปัญหาที่พบบ่อย #
- ได้ HTTP 401 — key ผิด ถูกลบ หรือหมดอายุ (
API_KEY_EXPIRED) ตรวจว่าส่ง key ครบทั้งค่า แล้วออก secret ใหม่หรือสร้าง key ใหม่ - ได้ HTTP 403
API_SCOPE_DENIED— key ไม่มีสิทธิ์กับข้อมูลนั้น แก้ สิทธิ์ต่อข้อมูล ของ key - ทำ key หาย — ดูย้อนหลังไม่ได้ ให้ออก secret ใหม่
- ไม่เห็นเมนู Developer — หน้านี้มีเฉพาะเจ้าของและแอดมิน
หน้านี้มีประโยชน์ไหม?