Lewati ke konten
Buka Entergram

Kunci Public API

Settings → Developers → API, buat dan kelola kunci API yang terikat ke workspace untuk integrasi eksternal.

Gunakan kunci API jika integrasinya bukan klien MCP: jembatan Zapier, layanan internal, atau tugas pelaporan.

PRO access required (perlu akses Pro): upgrade workspace ini ke Pro sebelum menerbitkan kunci Public API. Admin access required (perlu akses admin): hanya owner dan admin workspace yang bisa membuat atau mengelola kunci.


Create key, terbitkan kunci yang terikat ke workspace dengan scope eksplisit dan tanggal kedaluwarsa tetap.

FieldCatatan
Key nameMisalnya Zapier CRM bridge. Wajib
ScopesBerikan hanya akses minimum yang dibutuhkan integrasi ini. Minimal satu
Expiry dateSemua kunci wajib kedaluwarsa. Rentang yang disarankan: 30 sampai 90 hari
IP allowlistOpsional. Satu IP atau CIDR per baris, atau dipisahkan koma, misalnya 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 mengirim pesan Telegram atas nama akun Anda. Berikan hanya jika integrasinya memang perlu mengirim pesan.


Kunci dalam bentuk teks biasa hanya ditampilkan sekali:

Store this API key now (simpan kunci API ini sekarang): kunci teks biasa hanya ditampilkan sekali. Setelah dialog ini ditutup, hanya prefiksnya yang tetap terlihat. Simpan kunci ini di password manager atau secret manager Anda sebelum menutup dialog.

Entergram hanya menyimpan hash dari kunci tersebut. Tidak ada opsi “tampilkan kunci lagi”.


Daftar menampilkan Active keys dan Total keys, dengan status Active, Expired, atau Revoked. Show archived ({n}) menampilkan kunci yang sudah dipensiunkan.

Per kunci:

Field
ScopesApa yang bisa dilakukan kunci
Created / Created byAsal-usul
ExpiresBatas waktu mutlak
Last usedNever sampai pertama kali dipakai
UsageAktivitas permintaan
Source IPAsal panggilan
User agentNo requests yet sampai pertama kali dipakai
IP allowlistAtau No IP restrictions configured for this key
TindakanEfek
Copy keyHanya selama dialog sekali tampil masih terbuka
Rotate”Kunci saat ini akan dicabut dan diganti dengan kunci baru.”
Revoke”Kunci ini akan langsung berhenti bekerja untuk semua klien yang memakainya.”
DocsMembuka referensi API

Peristiwa siklus hidup kunci tercatat di audit. Public API key created / rotated / revoked muncul di Log history.


Rotasi mencabut kunci lama tepat saat kunci baru diterbitkan, jadi rencanakan dengan baik:

  1. Buat kunci kedua dengan scope yang sama.
  2. Pasang kunci baru di integrasi Anda.
  3. Pastikan trafik sudah memakai kunci baru lewat Last used / Usage.
  4. Revoke kunci lama.

Memakai dua kunci lalu mencabut yang lama lebih aman daripada merotasi kunci aktif sambil berpacu dengan deploy.


  • Satu kunci per integrasi. Dengan kunci bersama, Anda tidak bisa mencabut satu hal tanpa merusak tiga lainnya.
  • Masa berlaku 30-90 hari, sesuai rekomendasi aplikasi. Rotasi paksa memang tujuannya.
  • Selalu atur IP allowlist jika pemanggil memiliki IP tetap. Kunci yang bocor pun berubah dari bencana menjadi sekadar gangguan.
  • Beri nama kunci sesuai sistem, bukan nama orang.
  • Periksa Last used sebelum memperpanjang. Kunci yang tidak dipakai siapa pun hanyalah risiko.

PesanArtinya
PRO access requiredUpgrade workspace
Admin access requiredAnda bukan owner atau admin
Public API key management is temporarily unavailableGangguan sementara, coba lagi sebentar lagi
Public API hashing not configuredMasalah konfigurasi di sisi server, hubungi dukungan
Public API storage not readyMigrasi database masih tertunda, hubungi dukungan