# Peringatan, webhook, Copilot, dan API Penyelidik

Source: https://help.didit.me/id/investigations/investigator-alerts-and-integrations
Updated: 2026-10-23

Kirim peringatan Penyelidik ke Slack atau Teams, terima event investigator di webhook, jalankan lewat Copilot atau MCP, dan kirim item luar lewat API.

Di **Penyelidik → Pengaturan → Peringatan Slack dan Teams**, tempel URL incoming webhook
dari kanal Slack atau Microsoft Teams dan tekan **Kirim tes**. Daftarkan
endpoint webhook Anda ke peristiwa `investigator` di **Webhook**. Minta Didit Copilot
untuk membuka atau menerima laporan: Copilot selalu meminta persetujuan Anda sebelum memutuskan
apa pun.

> **Note:** Fitur-fitur ini diluncurkan satu per satu dan mungkin belum diaktifkan untuk
> aplikasi Anda. Anda dapat menambahkan kanal Slack atau Teams sebelum peringatan
> diaktifkan: tidak ada yang diposting sampai peringatan diaktifkan.

## Notifikasi kumpulan siap

Ketika 5 atau lebih rekomendasi berkeyakinan tinggi menunggu untuk diterima, Penyelidik memberi tahu tim Anda melalui email dan di konsol, paling banyak sekali setiap 4 jam, dengan tautan yang membuka antrean pada kumpulan tersebut. Notifikasi dikirim ke orang yang ditampilkan di bawah **Siapa yang diberi tahu** pada langkah **Tinjau dan aktifkan** dalam penyiapan. Daftar itu hanya dapat dibaca di konsol: secara bawaan setiap anggota organisasi Anda diberi tahu, dan notifikasi tidak pernah dikirim kepada selain anggota. Preferensi notifikasi dan jam tenang setiap orang berlaku seperti biasa.

## Peringatan Slack dan Teams

Tambahkan satu kanal per aplikasi: tempel URL incoming webhook kanal tersebut, tekan **Tambah kanal**, lalu **Kirim tes** untuk memeriksa bahwa pesan sampai. URL harus berupa tautan https dari kanal Slack atau Microsoft Teams. URL disimpan terenkripsi dan tidak pernah ditampilkan lagi; tekan **Hapus** untuk berhenti memposting.

Kanal menerima pesan ketika:

| Peringatan | Kapan |
|---|---|
| **Kumpulan siap diterima** | 5 atau lebih rekomendasi berkeyakinan tinggi sedang menunggu, paling banyak setiap 4 jam |
| **Penurunan konsistensi** | Sebuah antrean mengulangi rekomendasinya di kurang dari 90% pengulangan |
| **Pergeseran** | Sebuah antrean bergeser dan tingkatnya diturunkan |

Peringatan hanya berisi jumlah dan tautan, tidak pernah data seseorang.

## Peristiwa webhook

Endpoint webhook Anda dapat menerima peristiwa Penyelidik, yang ditandatangani dan dicoba ulang seperti setiap webhook Didit lainnya. Daftarkan di **Webhook**:

| Peristiwa | Dikirim saat |
|---|---|
| `investigator.report.ready` | Sebuah laporan ditulis |
| `investigator.decision.automated` | Penyelidik memutuskan sebuah item sendiri |
| `investigator.decision.overridden` | Seseorang mengambil tindakan yang berbeda dari laporan, atau mengganti keputusan otomatis |
| `investigator.question.raised` | Penyelidik bertanya kepada tim Anda tentang kebijakannya |
| `investigator.automation.paused` | Otomatisasi dijeda, oleh seseorang atau karena mencapai batas pengeluaran bulanan |
| `investigator.rfi.answered` | Orang tersebut menjawab permintaan informasi |
| `investigator.rfi.overdue` | Sebuah permintaan informasi melewati tenggatnya tanpa jawaban |
| `investigator.decision.contested` | Orang tersebut menyanggah sebuah keputusan |
| `investigator.drift.detected` | Sebuah antrean bergeser dan turun satu tingkat |
| `investigator.sla.breached` | Sebuah laporan menunggu melewati tingkat layanan antreannya |
| `investigator.qa.failed` | Keputusan yang diambil seseorang gagal dalam peninjauan QA |
| `investigator.external.report.ready` | Laporan untuk item yang dikirim dari luar Didit sudah siap |

Peristiwa hanya berisi ID, antrean, rekomendasi, tindakan, dan asal-usul, tidak pernah nama seseorang, alasan peninjau, atau narasi. Peristiwa status verifikasi dan verifikasi bisnis juga menyebutkan siapa yang memutuskan, di `decided_by`: `investigator` jika Penyelidik memutuskan sendiri, `human` jika manusia yang memutuskan. Payload tersedia di [dokumentasi pengembang](https://docs.didit.me). Lihat juga [dasar-dasar webhook](https://help.didit.me/id/integration/webhooks-basics).

## Didit Copilot

Didit Copilot dapat menjalankan Penyelidik untuk Anda: menampilkan antrean, membuka laporan dan menjelaskannya, menjawab pertanyaan, memulai uji historis, atau membaca kinerja. Saat Anda memintanya untuk menerima, mengganti keputusan, atau menerima sekaligus, Copilot menampilkan kartu persetujuan dengan tindakan yang tepat, dan tidak ada yang diputuskan sampai Anda menyetujuinya. Keputusan yang dibuat dengan cara ini ditandai **melalui Copilot** di **Aktivitas**. Copilot juga dapat menambahkan catatan pada sebuah item dan, setelah Anda menyetujuinya pada kartu serupa, meminta Penyelidik meninjau item itu lagi. Copilot juga menjangkau tab lainnya: menjeda otomatisasi, otonomi, pengaturan, kebijakan dan SOP, serta pemeriksaan yang dimulainya, masing-masing pada kartu serupa. Lihat [menggunakan Didit Copilot di Penyelidik](https://help.didit.me/id/didit-copilot/copilot-in-the-investigator).

## MCP

Server MCP Didit memberikan alat Penyelidik yang sama kepada asisten AI Anda sendiri: antrean, laporan, pertanyaan, uji historis, dasbor, kinerja, dan Aktivitas, ditambah menambahkan catatan pada sebuah item dan meminta peninjauan ulang. Menerima, mengganti keputusan, dan menerima sekaligus ditandai sebagai tindakan destruktif dan menolak dijalankan sampai asisten Anda mengonfirmasi bahwa Anda menyetujui tindakan yang tepat tersebut. Keputusan yang dibuat dengan cara ini ditandai **melalui MCP** di **Aktivitas**. Alat-alat ini bertindak atas nama Anda, dengan izin peran Anda: memutuskan sebuah item memerlukan akses tulis ke item tersebut.

## Kirim item dari luar Didit

Jika sebagian peninjauan Anda terjadi di luar Didit, misalnya verifikasi dari penyedia lain atau peringatan dari pemantauan transaksi Anda sendiri, Anda dapat mengirim item tersebut ke Penyelidik melalui API. Penyelidik meninjau masing-masing terhadap aturan verifikasi atau transaksi Anda dan menulis laporan yang dapat Anda baca melalui API atau terima sebagai webhook `investigator.external.report.ready`. Item ini tidak pernah diputuskan oleh Didit dan tidak pernah ditagih. Dokumentasi pengembang menjelaskan formatnya.

Di konsol, setel filter **Sumber** antrean ke **Eksternal (API)** untuk melihatnya di **Item eksternal**. Setiap item menunjukkan apakah item tersebut berjenis **Identitas** atau **Transaksi**, statusnya (**Dalam antrean**, **Sedang ditinjau**, **Ditinjau**, atau **Gagal**) atau, setelah ditinjau, rekomendasinya, apa yang ditandai oleh sistem lain, dan apa yang dikatakan kebijakan Anda beserta aturan yang diterapkannya. Laporannya hanya rekomendasi, tidak pernah keputusan. **Cara mengirim item lewat API** membuka dokumentasi pengembang.

## API

Semua yang ada di halaman Penyelidik juga tersedia melalui API Penyelidik, dengan kunci API yang memiliki akses ke keputusan (untuk membaca dan memutuskan item) atau ke aplikasi (untuk mengubah penyiapan). Lihat [dokumentasi pengembang](https://docs.didit.me).