For the complete documentation index, see llms.txt. This page is also available as Markdown.

การยืนยันตัวตน

คีย์ API คือข้อมูลรับรองลับที่อนุญาตให้สิ่งที่อยู่นอก Zaapi ดำเนินการบนเวิร์กสเปซได้ เช่น Zaapi Open API หรือ MCP.

สร้างคีย์ API

ไปที่ การตั้งค่า → นักพัฒนา → คีย์ API ในแอป Zaapi

  1. คลิก เพิ่มคีย์ API.

  2. ตั้งชื่อให้ชัดเจน — ใช้ชื่อที่บอกได้ว่ามีไว้สำหรับอะไร เช่น Claude Desktop หรือ การทำงานอัตโนมัติสำหรับซัพพอร์ต.

  3. เลือกขอบเขตสิทธิ์ที่คีย์ควรมี สิทธิ์เหล่านี้กำหนดว่าผู้ช่วยจะเข้าถึงอะไรได้บ้าง: สิทธิ์อ่านช่วยให้ค้นหาข้อมูลได้ ส่วนสิทธิ์เขียนช่วยให้เปลี่ยนแปลงข้อมูลได้ ให้เฉพาะสิทธิ์ที่จำเป็น — คีย์แบบอ่านอย่างเดียวจะส่งข้อความหาลูกค้าหรือปิดทิกเก็ตโดยไม่ตั้งใจไม่ได้

  4. คลิกสร้าง แล้ว คัดลอกคีย์ทันที.

คีย์จะแสดงเพียงครั้งเดียว จะดูคีย์อีกไม่ได้หลังปิดกล่องโต้ตอบ จึงควรวางไว้ในที่ปลอดภัยก่อนดำเนินการต่อ หากคีย์หาย ให้หมุนคีย์เพื่อรับคีย์ใหม่

คีย์จะหมดอายุหลัง 6 เดือน จึงต้องหมุนคีย์และอัปเดตการตั้งค่าก่อนถึงกำหนด

การจัดการคีย์

  • หมุนคีย์ ออกคีย์ลับใหม่ โดยคงชื่อและสิทธิ์ของคีย์เดิมไว้ คีย์ลับเดิมยังใช้งานได้อีกสองชั่วโมง จึงมีเวลาติดตั้งคีย์ใหม่ การหมดอายุ 6 เดือนจะนับใหม่จากวันที่หมุนคีย์

  • แก้ไข เปลี่ยนชื่อคีย์หรือปรับขอบเขตสิทธิ์ ค่าคีย์ลับไม่เปลี่ยน ดังนั้นระบบที่ใช้งานคีย์นี้ไม่ต้องอัปเดต

  • ลบ มีผลทันทีและไม่สามารถย้อนกลับได้ — คำขอใดก็ตามที่ใช้คีย์นั้นจะเริ่มล้มเหลวทันที

ความปลอดภัย

  • ให้ดูแลคีย์ API เหมือนรหัสผ่าน ผู้ที่มีคีย์นี้จะได้รับสิทธิ์ตามที่กำหนดไว้บนเวิร์กสเปซจริง

  • ห้าม commit คีย์นี้ เก็บคีย์ให้อยู่ภายนอก git — หากใช้ไฟล์คอนฟิกระดับโปรเจกต์ เช่น .cursor/mcp.jsonให้เพิ่มลงใน .gitignore.

  • ให้สิทธิ์ขั้นต่ำที่จำเป็น เริ่มจากอ่านอย่างเดียว แล้วค่อยเพิ่มสิทธิ์เขียนเมื่อจำเป็น

  • หนึ่งคีย์ต่อหนึ่งคนหรือหนึ่งบริการ วิธีนี้ช่วยให้หมุนหรือลบคีย์หนึ่งรายการได้โดยไม่กระทบคนอื่น

  • ลบคีย์ที่ไม่ได้ใช้งานแล้วรวมถึงกรณีที่สมาชิกออกจากทีม

อัปเดตล่าสุด