Tinjau akses untuk setiap tindakan: pembacaan memerlukan izin yang sesuai, perubahan catatan memerlukan pratinjau dan kunci percobaan ulang, serta pengiriman juga memerlukan kebijakan aktif yang ditinjau penanggung jawab. Sertakan pemeriksaan persetujuan, larangan kontak, lisensi, dan yurisdiksi.
Apa saja tingkat risikonya?
| Tingkat | Tindakan | Kontrol |
|---|---|---|
| R0 | workspace.context, workspace.capabilities | Cakupan workspace:read. Selalu dicantumkan ketika cakupan diberikan. |
| R1 | companies.*, trade.*, contacts.*, leads.list, campaigns.list | Izin baca yang sesuai dan akses ruang kerja. |
| R2 | leads.create, campaigns.draft | Izin pembuatan, pratinjau dry_run, idempotency_key wajib untuk penulisan nyata. |
| R3 | email.send, sms.send | Izin pengiriman, policy_id aktif yang ditinjau penanggung jawab, pratinjau dry_run, idempotency_key wajib untuk pengiriman nyata. |
Gunakan tools/list untuk melihat alat yang tersedia bagi koneksi Anda. Ketersediaan bergantung pada izin yang diberikan dan akses ruang kerja. Mulai dengan izin baca; minta administrator meninjau akses yang belum tersedia alih-alih meminta izin luas.
Bagaimana cara kerja kebijakan permanen dan tinjauan?
Sebelum mengaktifkan pengiriman, minta penanggung jawab meninjau audiens, pengirim, klaim pesan, persetujuan, daftar larangan kontak, yurisdiksi yang berlaku, lisensi, dan batas anggaran. Gunakan policy_id kebijakan tetap yang aktif untuk pengiriman yang diizinkan dan pratinjau dengan dry_run: true. Satu kebijakan dapat mengizinkan beberapa pengiriman; ini tidak berarti setiap pesan disetujui seseorang secara terpisah. Hentikan pekerjaan jika kelayakan atau otorisasi belum jelas.
Bagaimana dry-run dan kunci idempotensi sebaiknya digunakan?
- Kirim
dry_run: trueterlebih dahulu untuk setiap tindakan R2/R3. Server memvalidasi cakupan, kebijakan, dan argumen tanpa menulis catatan atau mengirim pesan. - Buat satu UUID
idempotency_keyper penulisan yang dimaksud dan gunakan kembali pada pengulangan. Kunci yang dipakai ulang mengembalikan hasil asli dan bukan duplikat prospek, draf, atau pengiriman. - Jangan pernah membuat kunci baru saat mengulangi penulisan yang kehabisan waktu. Simpan kunci di samping
request_iddalam log Anda sendiri. - Wajib untuk penulisan atau pengiriman nyata; gunakan UUID yang sama saat mencoba tindakan yang sama dengan argumen tetap.
Kuota apa yang berlaku?
Batas permintaan dan penggunaan bergantung pada akses ruang kerja dan tindakan. Periksa penggunaan saat ini bersama administrator. Untuk quota_exceeded, patuhi Retry-After dan waktu reset yang diberikan, lalu coba lagi dengan jeda bertahap dan jumlah percobaan terbatas. Jangan menghindari batas dengan percobaan paralel, klien tambahan, atau kebijakan baru.
quota_exceeded menyertakan reset_at dan retry_after. Patuhi Retry-After dan ulangi dengan backoff terbatas. Jangan melakukan pengulangan paralel terhadap respons 429.
Bagaimana cara mencabut akses dan meninjau aktivitas?
- Cabut di
POST /oauth/revokeatau hapus klien OAuth di Settings → Integrations. Pencabutan menghentikan panggilan MCP dan REST agent untuk token tersebut. - Tinjau peristiwa audit ruang kerja untuk tinjauan kebijakan, pengiriman, dan perubahan kebijakan.
- Periksa penggunaan harian dan jendela sebelum menaikkan batas atau menambahkan klien baru.
- Lakukan rotasi atas setiap token yang muncul dalam log, tangkapan layar, atau tiket. Jangan pernah mengirim token ke dukungan; kirim
request_idyang telah disunting, stempel waktu, nama tool, dan kode kesalahan.