คีย์ Public API
Settings → Developers → API สร้างและจัดการ API key ระดับเวิร์กสเปซสำหรับการเชื่อมต่อภายนอก
ใช้ API key เมื่อระบบที่เชื่อมต่อไม่ใช่ MCP client เช่น บริดจ์ Zapier บริการภายในองค์กร หรืองานสร้างรายงาน
PRO access required (ต้องใช้แพ็กเกจ Pro) อัปเกรดเวิร์กสเปซนี้เป็น Pro ก่อนออก Public API key Admin access required (ต้องมีสิทธิ์ผู้ดูแล) เฉพาะ owner และ admin ของเวิร์กสเปซเท่านั้นที่สร้างหรือจัดการคีย์ได้
การสร้างคีย์
ส่วนหัวข้อ “การสร้างคีย์”Create key ออกคีย์ที่ผูกกับเวิร์กสเปซ พร้อมขอบเขตสิทธิ์ที่ชัดเจนและวันหมดอายุที่แน่นอน
| ฟิลด์ | หมายเหตุ |
|---|---|
| Key name | เช่น Zapier CRM bridge จำเป็นต้องกรอก |
| Scopes | ให้สิทธิ์เพียงเท่าที่การเชื่อมต่อนี้จำเป็นต้องใช้ อย่างน้อยหนึ่งรายการ |
| Expiry date | ทุกคีย์ต้องมีวันหมดอายุ ระยะเวลาที่แนะนำ: 30 ถึง 90 วัน |
| IP allowlist | ไม่บังคับ ใส่ IP หรือ CIDR บรรทัดละหนึ่งรายการ หรือคั่นด้วยจุลภาค เช่น 203.0.113.10, 198.51.100.0/24 |
ขอบเขตสิทธิ์ที่มีให้เลือก
ส่วนหัวข้อ “ขอบเขตสิทธิ์ที่มีให้เลือก”Workspace access · Members access · Accounts access · Contacts access · Chats access / Chats write · Custom fields read / write · Messages read / Messages write · Tickets read / Tickets write
Messages write จะส่งข้อความ Telegram ในนามบัญชีของคุณ ให้สิทธิ์นี้เฉพาะเมื่อระบบที่เชื่อมต่อจำเป็นต้องส่งข้อความจริงๆ
การเก็บรักษาคีย์
ส่วนหัวข้อ “การเก็บรักษาคีย์”คีย์แบบข้อความเต็ม (plaintext) จะแสดงเพียงครั้งเดียว:
Store this API key now (เก็บ API key นี้ไว้ทันที) คีย์แบบข้อความเต็มจะแสดงเพียงครั้งเดียว หลังจากปิดหน้าต่างนี้ คุณจะเห็นเพียงส่วนนำหน้า (prefix) ของคีย์ เก็บคีย์นี้ไว้ในโปรแกรมจัดการรหัสผ่านหรือระบบจัดการ secret ก่อนปิดหน้าต่าง
Entergram เก็บเพียงค่าแฮชของคีย์ ไม่มีปุ่ม “แสดงคีย์อีกครั้ง”
การจัดการคีย์
ส่วนหัวข้อ “การจัดการคีย์”รายการคีย์แสดง Active keys (คีย์ที่ใช้งานอยู่) และ Total keys (คีย์ทั้งหมด) พร้อมสถานะ Active, Expired หรือ Revoked ส่วน Show archived ({n}) จะแสดงคีย์ที่เลิกใช้แล้ว
ข้อมูลของแต่ละคีย์:
| ฟิลด์ | |
|---|---|
| Scopes | สิ่งที่คีย์ทำได้ |
| Created / Created by | ที่มาของคีย์ |
| Expires | กำหนดหมดอายุที่ตายตัว |
| Last used | แสดง Never จนกว่าจะใช้งานครั้งแรก |
| Usage | กิจกรรมของคำขอ |
| Source IP | ที่มาของการเรียกใช้ |
| User agent | แสดง No requests yet จนกว่าจะใช้งานครั้งแรก |
| IP allowlist | หรือแสดง No IP restrictions configured for this key |
การดำเนินการ
ส่วนหัวข้อ “การดำเนินการ”| การดำเนินการ | ผลลัพธ์ |
|---|---|
| Copy key | ทำได้เฉพาะขณะที่หน้าต่างแสดงคีย์ครั้งเดียวยังเปิดอยู่ |
| Rotate | ”คีย์ปัจจุบันจะถูกเพิกถอนและแทนที่ด้วยคีย์ที่สร้างขึ้นใหม่” |
| Revoke | ”คีย์นี้จะหยุดทำงานทันทีสำหรับทุกระบบที่ใช้อยู่” |
| Docs | เปิดเอกสารอ้างอิง API |
เหตุการณ์ในวงจรชีวิตของคีย์จะถูกบันทึกไว้ตรวจสอบ โดย Public API key created / rotated / revoked จะปรากฏใน Log history
การหมุนเวียนคีย์โดยไม่มีช่วงหยุดทำงาน
ส่วนหัวข้อ “การหมุนเวียนคีย์โดยไม่มีช่วงหยุดทำงาน”การหมุนเวียนคีย์ (Rotate) จะเพิกถอนคีย์เก่าทันทีที่ออกคีย์ใหม่ ดังนั้นควรวางแผนดังนี้:
- สร้างคีย์ที่สองด้วยขอบเขตสิทธิ์เดียวกัน
- นำคีย์ใหม่ไปใช้ในระบบที่เชื่อมต่อ
- ตรวจสอบว่ามีทราฟฟิกผ่านคีย์ใหม่จาก Last used / Usage
- Revoke คีย์เก่า
การใช้สองคีย์แล้วเพิกถอนคีย์เก่า ดีกว่าการหมุนเวียนคีย์ที่กำลังใช้งานอยู่แล้วต้องรีบ deploy ให้ทัน
แนวทางปฏิบัติที่ดี
ส่วนหัวข้อ “แนวทางปฏิบัติที่ดี”- หนึ่งคีย์ต่อหนึ่งระบบ ถ้าใช้คีย์ร่วมกัน คุณจะเพิกถอนคีย์สำหรับระบบหนึ่งไม่ได้โดยไม่ทำให้อีกสามระบบพัง
- ตั้งวันหมดอายุ 30-90 วัน ตามที่แอปแนะนำ การบังคับหมุนเวียนคีย์คือจุดประสงค์หลัก
- ตั้ง IP allowlist เสมอ เมื่อระบบที่เรียกใช้มี IP คงที่ วิธีนี้เปลี่ยนคีย์ที่รั่วไหลจากหายนะให้เหลือเพียงเรื่องน่ารำคาญ
- ตั้งชื่อคีย์ตามระบบ ไม่ใช่ตามชื่อคน
- ตรวจดู Last used ก่อนต่ออายุ คีย์ที่ไม่มีใครใช้มีแต่ความเสี่ยง
การแก้ไขปัญหา
ส่วนหัวข้อ “การแก้ไขปัญหา”| ข้อความ | ความหมาย |
|---|---|
| PRO access required | อัปเกรดเวิร์กสเปซ |
| Admin access required | คุณไม่ใช่ owner หรือ admin |
| Public API key management is temporarily unavailable | ปัญหาชั่วคราว ลองใหม่อีกครั้งในไม่ช้า |
| Public API hashing not configured | ปัญหาการตั้งค่าฝั่งเซิร์ฟเวอร์ ติดต่อฝ่ายสนับสนุน |
| Public API storage not ready | มีการย้ายข้อมูลฐานข้อมูล (migration) ค้างอยู่ ติดต่อฝ่ายสนับสนุน |
ที่เกี่ยวข้อง
ส่วนหัวข้อ “ที่เกี่ยวข้อง”- คอนเนกเตอร์ MCP สำหรับไคลเอนต์ AI
- เช็กลิสต์ความเป็นส่วนตัว
การตั้งค่าคุกกี้
เราเคารพสิทธิความเป็นส่วนตัวของคุณ เลือกคุกกี้ที่ต้องการอนุญาต ตัวเลือกของคุณจะมีผลทั่วทั้งเว็บไซต์ นโยบายคุกกี้
จำเป็นต่อการทำงานของเว็บไซต์ รวมถึงการจดจำตัวเลือกความเป็นส่วนตัวของคุณ เปิดใช้งานเสมอ
ช่วยให้เราเข้าใจการใช้งานเว็บไซต์และระบุการสมัครให้กับพันธมิตรผู้แนะนำ ไม่บังคับ