ข้ามไปยังเนื้อหา
เปิด Entergram

คีย์ 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) จะเพิกถอนคีย์เก่าทันทีที่ออกคีย์ใหม่ ดังนั้นควรวางแผนดังนี้:

  1. สร้างคีย์ที่สองด้วยขอบเขตสิทธิ์เดียวกัน
  2. นำคีย์ใหม่ไปใช้ในระบบที่เชื่อมต่อ
  3. ตรวจสอบว่ามีทราฟฟิกผ่านคีย์ใหม่จาก Last used / Usage
  4. 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) ค้างอยู่ ติดต่อฝ่ายสนับสนุน