> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Contoh Didit MCP: Prompt & Percakapan Agen

> Contoh prompt dan percakapan agen dengan Didit MCP: alur kerja KYC dan sesi, pencarian registri KYB, antrean peninjauan, back-test aturan, webhook.

Beberapa pola yang menunjukkan kemampuan Didit MCP. Sampaikan permintaan dalam bahasa sehari-hari, dan agenlah yang akan memilih alatnya. Setiap alat yang disebut di bawah ini tersedia di [referensi alat](https://docs.didit.me/id/integration/mcp/tools.md).

***

## Prompt cepat

**Operasi & pemantauan (lintas aplikasi)**

* *"Tampilkan 5 sesi terakhir yang dalam peninjauan di semua aplikasi saya."* → `didit_session_search` dengan `status: "In Review"`, `limit: 5`
* *"Berapa banyak orang yang mencoba verifikasi telepon tetapi meninggalkan proses dalam 15 hari terakhir?"* → `didit_analytics` dengan `last_n_days: 15` (satu panggilan; membaca corong fitur)
* *"Temukan pelanggan dengan vendor\_data `user_8842` dan beri tahu saya aplikasi dan statusnya."* → `didit_vendor_user_search`
* *"Berapa saldo kredit saya dan tingkat konversi bulan ini?"* → `didit_org_get_balance` + `didit_analytics`

**Konfigurasi**

* *"Buat alur kerja KYC dengan pemindaian ID + Deteksi Liveness dan beri saya tautan verifikasi."* → `didit_workflow_create` → `didit_session_create`
* *"Buat alur kerja verifikasi ID yang hanya menerima paspor, lalu Deteksi Liveness dengan swafoto."* → `didit_workflow_create` — cukup tulis `documents_allowed: ["PASSPORT"]`; MCP akan memperluasnya menjadi hanya paspor untuk setiap negara (lihat [Lanjutan → konfigurasi fitur](https://docs.didit.me/id/integration/mcp/advanced.md#konfigurasi-fitur-dan-daftar-izin)).
* *"Alur kerja baru: pindai paspor; jika ID ditolak, tolak sesi; jika profesi yang dinyatakan ≈ 'Software Engineer' (≥60%), jalankan Deteksi Liveness; jika tidak, minta Bukti Alamat dalam bahasa Spanyol; lalu buat keputusan otomatis."* → `didit_workflow_get_field_definitions` → `didit_workflow_validate_graph` → `didit_workflow_set_graph`
* *"Di alur kerja `26d33c04…`, setelah verifikasi ID: jika ditolak, tolak sesi; jika profesi memiliki kemiripan ≥80% dengan 'Software Engineer', tambahkan langkah Document AI untuk bukti dana; lalu lanjutkan."* → `didit_workflow_search` → `didit_workflow_get_graph` → `didit_workflow_edit_graph` (perubahan kecil, disimpan sebagai draf yang dapat ditinjau)
* *"Di negara-negara mana saya dapat menawarkan login BankID atau MitID sebagai ganti pemindaian dokumen?"* → `didit_workflow_get_id_verification_methods_catalog`
* *"Daftarkan tujuan webhook untuk pembaruan status di `https://myapp.com/webhooks/didit`."* → `didit_webhook_create`

**Kepatuhan**

* *"Skrining AML pada dompet ini dan tambahkan ke daftar blokir jika cocok."* → `didit_transaction_screen_wallet` → `didit_blocklist_add`
* *"Buka kasus untuk sesi `…` dan tugaskan ke saya."* → `didit_case_create` → `didit_case_manage`
* *"Apakah Acme Ltd perusahaan terdaftar di Inggris, dan siapa saja pemegang sahamnya?"* → `didit_verify_kyb_search` → `didit_verify_kyb_select`

***

## 1. Siapkan verifikasi

> **Anda:** "Siapkan verifikasi identitas Didit untuk aplikasi saya dengan pemindaian ID dan liveness, dan beri saya tautan yang bisa saya coba."
>
> **Agen:** Saya akan membuat alur kerjanya terlebih dahulu. *(memanggil `didit_workflow_create` dengan `workflow_label: "Standard KYC"`, `features: [{ "feature": "OCR" }, { "feature": "LIVENESS" }]`)* — Dipublikasikan **"Standard KYC"**, `workflow_id = 6f2c…`. Sekarang sesi untuk mencobanya. *(memanggil `didit_session_create` dengan `workflow_id: "6f2c…"`, `vendor_data: "test-user-1"`)* — Ini tautan Anda: `https://verify.didit.me/session/…`. Buka di ponsel Anda untuk menjalankan alurnya. Di produksi, backend Anda membuat sesi dengan REST API:
>
> ```bash theme={null}
> curl -X POST https://verification.didit.me/v3/session/ \
>   -H "x-api-key: $DIDIT_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "workflow_id": "6f2c...", "vendor_data": "internal-user-id", "callback": "https://myapp.com/done" }'
> ```
>
> `x-api-key` tersebut adalah **kunci API REST** aplikasi Anda untuk backend; kunci ini terpisah dari cara Anda masuk ke MCP ini, yang menggunakan *Log in with Didit*. Apakah saya juga perlu mendaftarkan tujuan webhook?
>
> **Anda:** "Ya — endpoint saya adalah `https://myapp.com/webhooks/didit`."
>
> **Agen:** *(memanggil `didit_webhook_create` dengan `label: "Production"`, `url: "https://myapp.com/webhooks/didit"`, `webhook_version: "v3"`, `subscribed_events: ["status.updated"]`)* — Selesai. Rahasia penandatanganan disamarkan dalam data yang saya terima, jadi salin dari **Webhook** di konsol dan simpan sebagai `DIDIT_WEBHOOK_SECRET`. Verifikasi header `X-Signature-V2` pada setiap pengiriman sebelum mempercayainya.

***

## 2. KYB: periksa perusahaan di registri

> **Anda:** "Apakah Acme Trading Ltd perusahaan Inggris yang sah? Nomor registrasinya 12345678."
>
> **Agen:** *(memanggil `didit_verify_kyb_search` dengan `country_code: "GB"`, `name: "Acme Trading Ltd"`, `registration_number: "12345678"`)* — Ada satu kandidat: **ACME TRADING LTD**, didirikan 2019, status *aktif*, kantor terdaftar di Manchester. Apakah Anda ingin catatan lengkap beserta pengurus dan pemegang saham?
>
> **Anda:** "Ya, dan beri tahu saya siapa pemilik manfaatnya."
>
> **Agen:** *(memanggil `didit_verify_kyb_select` dengan `kyb_response_id` kandidat)* — Catatan lengkap berhasil diambil: dua direktur, dan satu orang dengan kendali signifikan yang memegang 75%+ saham dan hak suara. Catatan ini mencakup riwayat pengajuan dan alamat terdaftar. Ini adalah pencarian registri yang dikenai biaya (dua panggilan yang menggunakan kredit). Jika Anda ingin ini berjalan otomatis untuk setiap pelanggan bisnis, saya dapat menambahkan `KYB_REGISTRY` ke alur kerja KYB dengan `didit_workflow_create`; `didit_workflow_get_kyb_registry_catalog` memberi tahu kami tingkat data apa saja yang dijual registri Inggris.

***

## 3. Mengerjakan antrean peninjauan

> **Anda:** "Apa yang menunggu peninjauan saya, dan apa masalah di setiap sesi?"
>
> **Agen:** *(memanggil `didit_session_search` dengan `status: "In Review"`, `limit: 10`)* Empat sesi di dua aplikasi sedang dalam peninjauan. Membaca keputusan untuk setiap sesi. *(memanggil `didit_session_get_decision` untuk setiap `session_id`)*
>
> | Sesi | Aplikasi | Alasan berhenti |
> | - | - | - |
> | `a1f3…` | Onboarding | Skor kecocokan wajah 71 (ambang batas 80), deteksi liveness berhasil |
> | `b7c2…` | Onboarding | Dokumen kedaluwarsa 2 bulan lalu |
> | `c904…` | Marketplace | AML: satu kecocokan PEP, kecocokan nama 92%, tanggal lahir berbeda |
> | `d215…` | Marketplace | Bukti alamat berusia lebih dari 90 hari |
>
> **Anda:** "Setujui `a1f3`, saya sudah melihat swafotonya dan itu orang yang sama. Tolak `b7c2`, dokumennya kedaluwarsa."
>
> **Agen:** *(memanggil `didit_session_update_status` dengan `session_id: "a1f3…"`, `new_status: "Approved"`, lalu dengan `session_id: "b7c2…"`, `new_status: "Declined"`, `comment: "Expired document"`)* Keduanya sudah diperbarui. *(memanggil `didit_session_add_review` pada `a1f3…` dengan catatan "Peninjauan swafoto manual: orang yang sama")* Catatan peninjauan sudah ditambahkan agar log audit mencatat alasan skor ditimpa. Dua kasus AML dan bukti alamat masih terbuka. Beri tahu saya jika ingin membuka kasus untuk hit PEP dengan `didit_case_create`.

***

## 4. Uji balik aturan transaksi sebelum diaktifkan

> **Anda:** "Saya ingin menandai siapa pun yang melakukan lebih dari 3 transfer di atas \$1,000 dalam satu jam. Seberapa banyak positif palsu yang akan dihasilkan?"
>
> **Agen:** *(memanggil `didit_transaction_rule_backtest` dengan `conditions` pada `amount > 1000`, `aggregation` berupa count ≥ 3 dalam jendela 1 jam, `period_days: 90`)* Selama 90 hari terakhir, aturan ini akan terpicu pada 14 transaksi dari 6 subjek. 2 dari subjek tersebut sudah ditandai. Mau saya buat dalam mode `TEST` agar hanya mencatat kecocokan tanpa menjalankan tindakan apa pun?
>
> **Anda:** "Ya, mode TEST."
>
> **Agen:** *(memanggil `didit_transaction_rule_create` dengan `title: "Velocity: 3+ transfers over $1,000 per hour"`, `category: "aml_ctf"`, `mode: "TEST"`, `conditions` dan `aggregation` yang sama, serta daftar `actions` yang menandai subjek)* Sudah dibuat. Pantau dengan `didit_transaction_rule_get` setelah beberapa hari. Jika sudah puas, `didit_transaction_rule_update` akan mengubah `mode` menjadi `ACTIVE`. `didit_transaction_rule_library_list` juga memuat aturan kecepatan transaksi bawaan Didit jika Anda ingin memasang salah satunya.

***

## Hasil sesi bersifat asinkron

`didit_session_create` mengembalikan `session_id`, `session_token`, dan `url` yang di-hosting, tetapi verifikasinya belum dilakukan. Pengguna membuka `url` dan menyelesaikan alurnya. Keputusan akhir diterima melalui:

1. Webhook `status.updated` **(direkomendasikan)**, atau
2. `didit_session_get_decision` (polling, sebagai cadangan).

Keduanya memiliki bentuk yang sama, yaitu **selalu berupa array jamak** dengan `node_id` untuk setiap entri:

```json theme={null}
{
  "session_id": "uuid",
  "status": "Approved",
  "session_kind": "user",
  "id_verifications":  [ { "node_id": "first_id", "status": "Approved", "first_name": "Jane" } ],
  "liveness_checks":   [ { "node_id": "first_liveness", "status": "Approved", "score": 95.4 } ],
  "face_matches":      [ { "node_id": "first_face_match", "status": "Approved", "score": 96.1 } ],
  "aml_screenings":    [ { "node_id": "first_aml", "status": "Approved", "total_hits": 0, "hits": [] } ],
  "reviews": []
}
```

Jangan pernah membaca kunci V2 tunggal (`id_verification`, `liveness`). Kunci tersebut hanya dikirim ketika tujuan secara eksplisit ditetapkan ke `webhook_version: "V2"`. Lihat [Model data](https://docs.didit.me/id/reference/data-models.md) untuk referensi kolom per fitur, dan [Lanjutan → Webhook](https://docs.didit.me/id/integration/mcp/advanced.md#menangani-webhook) untuk aturan verifikasi dan coba lagi.

***

## Gabungkan dengan integrasi satu prompt

MCP sangat cocok untuk *menjalankan* Didit. Agar agen *menulis* integrasi lengkap (rute backend + SDK frontend + handler webhook + skema DB), berikan kepadanya [Prompt Integrasi](https://docs.didit.me/id/integration/integration-prompt.md). Prompt tersebut memandu ketujuh langkah dan memanggil tool MCP untuk membuat alur kerja, sesi, dan webhook secara langsung.

***

> [card] [Referensi alat](https://docs.didit.me/id/integration/mcp/tools.md)
>
> Semua yang dapat dipanggil agen.

> [card] [Lanjutan & pemecahan masalah](https://docs.didit.me/id/integration/mcp/advanced.md)
>
> Peran, perilaku lintas aplikasi, webhook, hosting mandiri.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.