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.
Membuat kunci
Bagian berjudul “Membuat kunci”Create key, terbitkan kunci yang terikat ke workspace dengan scope eksplisit dan tanggal kedaluwarsa tetap.
| Field | Catatan |
|---|---|
| Key name | Misalnya Zapier CRM bridge. Wajib |
| Scopes | Berikan hanya akses minimum yang dibutuhkan integrasi ini. Minimal satu |
| Expiry date | Semua kunci wajib kedaluwarsa. Rentang yang disarankan: 30 sampai 90 hari |
| IP allowlist | Opsional. Satu IP atau CIDR per baris, atau dipisahkan koma, misalnya 203.0.113.10, 198.51.100.0/24 |
Scope yang tersedia
Bagian berjudul “Scope yang tersedia”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.
Menyimpan kunci
Bagian berjudul “Menyimpan kunci”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”.
Mengelola kunci
Bagian berjudul “Mengelola kunci”Daftar menampilkan Active keys dan Total keys, dengan status Active, Expired, atau
Revoked. Show archived ({n}) menampilkan kunci yang sudah dipensiunkan.
Per kunci:
| Field | |
|---|---|
| Scopes | Apa yang bisa dilakukan kunci |
| Created / Created by | Asal-usul |
| Expires | Batas waktu mutlak |
| Last used | Never sampai pertama kali dipakai |
| Usage | Aktivitas permintaan |
| Source IP | Asal panggilan |
| User agent | No requests yet sampai pertama kali dipakai |
| IP allowlist | Atau No IP restrictions configured for this key |
Tindakan
Bagian berjudul “Tindakan”| Tindakan | Efek |
|---|---|
| Copy key | Hanya 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.” |
| Docs | Membuka referensi API |
Peristiwa siklus hidup kunci tercatat di audit. Public API key created / rotated / revoked muncul di Log history.
Rotasi tanpa downtime
Bagian berjudul “Rotasi tanpa downtime”Rotasi mencabut kunci lama tepat saat kunci baru diterbitkan, jadi rencanakan dengan baik:
- Buat kunci kedua dengan scope yang sama.
- Pasang kunci baru di integrasi Anda.
- Pastikan trafik sudah memakai kunci baru lewat Last used / Usage.
- Revoke kunci lama.
Memakai dua kunci lalu mencabut yang lama lebih aman daripada merotasi kunci aktif sambil berpacu dengan deploy.
Praktik yang baik
Bagian berjudul “Praktik yang baik”- 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.
Pemecahan masalah
Bagian berjudul “Pemecahan masalah”| Pesan | Artinya |
|---|---|
| PRO access required | Upgrade workspace |
| Admin access required | Anda bukan owner atau admin |
| Public API key management is temporarily unavailable | Gangguan sementara, coba lagi sebentar lagi |
| Public API hashing not configured | Masalah konfigurasi di sisi server, hubungi dukungan |
| Public API storage not ready | Migrasi database masih tertunda, hubungi dukungan |
Terkait
Bagian berjudul “Terkait”- MCP connectors, untuk klien AI
- Daftar periksa privasi
Preferensi cookie
Kami menghormati hak privasi Anda. Pilih cookie mana yang diizinkan, pilihan Anda berlaku di seluruh situs. Kebijakan Cookie
Dibutuhkan agar situs berfungsi, termasuk mengingat pilihan privasi Anda. Selalu aktif.
Membantu kami memahami penggunaan situs dan mengaitkan pendaftaran dengan mitra referal. Opsional.