Bỏ qua để đến nội dung
Mở Entergram

Khóa Public API

Settings → Developers → API, tạo và quản lý các khóa API gắn với không gian làm việc cho tích hợp bên ngoài.

Hãy dùng khóa API khi tích hợp không phải là MCP client: một cầu nối Zapier, một dịch vụ nội bộ, một tác vụ báo cáo.

PRO access required (cần gói Pro): hãy nâng cấp không gian làm việc này lên Pro trước khi cấp khóa Public API. Admin access required (cần quyền quản trị): chỉ chủ sở hữu và quản trị viên mới có thể tạo hoặc quản lý khóa.


Create key, cấp một khóa gắn với không gian làm việc, có scope rõ ràng và ngày hết hạn cố định.

TrườngGhi chú
Key nameVí dụ Zapier CRM bridge. Bắt buộc
ScopesChỉ cấp mức truy cập tối thiểu mà tích hợp này cần. Ít nhất một scope
Expiry dateMọi khóa đều phải hết hạn. Khoảng thời gian khuyến nghị: 30 đến 90 ngày
IP allowlistTùy chọn. Mỗi dòng một IP hoặc CIDR, hoặc phân cách bằng dấu phẩy, ví dụ 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 gửi tin nhắn Telegram dưới danh nghĩa các tài khoản của bạn. Chỉ cấp scope này khi tích hợp thực sự cần gửi tin.


Khóa dạng văn bản thuần chỉ được hiển thị một lần:

Store this API key now (hãy lưu khóa API này ngay): khóa dạng văn bản thuần chỉ hiển thị một lần. Sau khi đóng hộp thoại này, bạn chỉ còn thấy phần tiền tố. Hãy lưu khóa vào trình quản lý mật khẩu hoặc trình quản lý secret trước khi đóng hộp thoại.

Entergram chỉ lưu hash của khóa. Không có tùy chọn “hiển thị lại khóa”.


Danh sách hiển thị Active keys (khóa đang hoạt động) và Total keys (tổng số khóa), với trạng thái Active, Expired hoặc Revoked. Show archived ({n}) hiển thị các khóa đã ngừng dùng.

Với mỗi khóa:

Trường
ScopesKhóa được làm gì
Created / Created byNguồn gốc
ExpiresHạn chót cứng
Last usedHiển thị Never cho đến lần dùng đầu tiên
UsageHoạt động gửi request
Source IPNơi phát ra các lệnh gọi
User agentHiển thị No requests yet cho đến lần dùng đầu tiên
IP allowlistHoặc No IP restrictions configured for this key
Thao tácTác dụng
Copy keyChỉ khả dụng khi hộp thoại hiển thị một lần còn mở
Rotate”The current key will be revoked and replaced with a newly generated key.” (Khóa hiện tại sẽ bị thu hồi và thay bằng một khóa mới được tạo.)
Revoke”This key will stop working immediately for all clients using it.” (Khóa này sẽ ngừng hoạt động ngay lập tức với mọi client đang dùng nó.)
DocsMở tài liệu tham chiếu API

Các sự kiện trong vòng đời khóa đều được ghi nhật ký kiểm toán: Public API key created / rotated / revoked xuất hiện trong Log history.


Xoay vòng sẽ thu hồi khóa cũ ngay lúc khóa mới được cấp, vì vậy hãy lên kế hoạch trước:

  1. Tạo một khóa thứ hai với cùng các scope.
  2. Triển khai khóa mới vào tích hợp của bạn.
  3. Kiểm tra lưu lượng trên khóa mới qua Last used / Usage.
  4. Revoke khóa cũ.

Dùng hai khóa rồi thu hồi khóa cũ tốt hơn nhiều so với xoay vòng một khóa đang chạy rồi chạy đua với việc triển khai.


  • Mỗi tích hợp một khóa. Khóa dùng chung nghĩa là bạn không thể thu hồi một thứ mà không làm hỏng ba thứ khác.
  • Hết hạn sau 30-90 ngày, đúng như ứng dụng khuyến nghị. Việc buộc phải xoay vòng chính là mục đích.
  • Luôn đặt IP allowlist khi bên gọi có IP cố định. Nhờ vậy một khóa bị lộ chỉ còn là chuyện phiền toái, không phải thảm họa.
  • Đặt tên khóa theo hệ thống, không theo người.
  • Kiểm tra Last used trước khi gia hạn. Một khóa không ai dùng chỉ toàn là rủi ro.

Thông báoÝ nghĩa
PRO access requiredNâng cấp không gian làm việc
Admin access requiredBạn không phải chủ sở hữu hoặc quản trị viên
Public API key management is temporarily unavailableLỗi tạm thời, hãy thử lại sau ít phút
Public API hashing not configuredLỗi cấu hình phía máy chủ, hãy liên hệ bộ phận hỗ trợ
Public API storage not readyĐang chờ một bản migration cơ sở dữ liệu, hãy liên hệ bộ phận hỗ trợ