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

# Invite Pengguna

Fitur **Invite Pengguna** digunakan untuk menambahkan pengguna baru ke dalam sistem melalui mekanisme undangan berbasis email.\
Pendekatan ini memastikan bahwa hanya pengguna yang memiliki akses valid yang dapat bergabung ke dalam instansi.

Secara sistem, proses invite akan:

* Mengirim undangan ke email pengguna
* Mengaitkan pengguna ke instansi terkait
* Memberikan role awal sesuai konfigurasi
* Pengguna menerima invitation
* Pengguna membuat atau mendapatkan password untuk login

<Card title="Konsep Invite">
  Invite berbasis email memastikan kontrol akses yang lebih aman, karena hanya pemilik email yang dapat mengaktifkan akun.
</Card>

***

## Tujuan dan Use Case

Fitur ini digunakan dalam skenario berikut:

* Menambahkan anggota tim baru ke dashboard
* Memberikan akses ke stakeholder eksternal
* Onboarding user baru secara terkontrol
* Mengelola akses tanpa perlu membuat akun manual

***

## Behavior Sistem

Saat proses invite dilakukan, sistem memiliki perilaku berikut:

* Jika email **belum terdaftar** → sistem akan membuat akun baru
* Jika email **sudah terdaftar** → pengguna langsung ditambahkan ke instansi
* Role akan **langsung terpasang** saat invite dibuat
* Pengguna harus menyelesaikan proses aktivasi melalui email
* Akses ke sistem baru aktif setelah proses invite selesai

<Callout type="info">
  Jika tidak ada role custom, sistem hanya menyediakan role <b>Admin</b> sebagai default.
</Callout>

***

## Prasyarat

Sebelum mengundang pengguna:

* Anda memiliki permission untuk mengelola pengguna
* Email pengguna valid dan aktif
* Role sudah tersedia dalam sistem
* Email belum terdaftar di platform Mertani

***

## Langkah Invite Pengguna

<Steps>
  <Step title="Access User Management Page" toc={false}>
    Buka **Instansi** → **Manajemen Pengguna**
  </Step>

  <Step title="Open User Invitation Form" toc={false}>
    Klik tombol `Invite Pengguna` untuk membuka form undangan
  </Step>

  <Step title="Enter User Email" toc={false}>
    Masukkan email pengguna yang akan diundang
  </Step>

  <Step title="Select User Role" toc={false}>
    Tentukan role yang akan diberikan kepada pengguna
  </Step>

  <Step title="Send Invitation" toc={false}>
    Klik tombol **Simpan** untuk mengirim undangan ke email pengguna

    <Frame>
      <video src="https://mintcdn.com/mertani/yrybY0Cd-4ZXOwAB/assets/dashboard-guides/access-control/invite-user.webm?fit=max&auto=format&n=yrybY0Cd-4ZXOwAB&q=85&s=34139b5410e76d372178bdf85eb72261" controls autoPlay loop playsInline muted data-path="assets/dashboard-guides/access-control/invite-user.webm" />
    </Frame>
  </Step>

  <Step title="Open Invitation Email" toc={false}>
    Pengguna akan menerima email undangan dari **Mertani**. Buka email tersebut untuk melanjutkan proses aktivasi akun.
  </Step>

  <Step title="Accept Invitation" toc={false}>
    Klik tombol **Terima Undangan** yang terdapat pada email.
  </Step>

  <Step title="Get Account Password" toc={false}>
    Setelah undangan diterima, sistem akan menampilkan atau mengirimkan password akun yang dapat digunakan untuk login.
  </Step>

  <Step title="Login to Dashboard" toc={false}>
    Buka halaman login dashboard, kemudian masuk menggunakan email yang diundang dan password yang telah diperoleh.

    <Frame>
      <video src="https://mintcdn.com/mertani/yrybY0Cd-4ZXOwAB/assets/dashboard-guides/access-control/email-invitation.webm?fit=max&auto=format&n=yrybY0Cd-4ZXOwAB&q=85&s=ce965e596bd135171b7fb4da24dc346f" controls autoPlay loop playsInline muted data-path="assets/dashboard-guides/access-control/email-invitation.webm" />
    </Frame>
  </Step>
</Steps>

***

## Alur Setelah Invite

Setelah undangan dikirim:

1. Pengguna menerima email undangan
2. Pengguna membuka link invitation
3. Pengguna menerima `password` melalui email
4. Pengguna dapat login ke dashboard
5. Role langsung aktif sesuai konfigurasi

***

## Dampak Sistem

Setelah pengguna berhasil di-invite:

* Pengguna langsung terhubung ke instansi
* Role menentukan akses awal pengguna
* Pengguna dapat langsung menggunakan fitur sesuai role

***

## Best Practice

Untuk memastikan proses berjalan optimal:

* Gunakan email yang valid dan aktif
* Pilih role yang sesuai sejak awal
* Hindari memberikan akses tinggi tanpa kebutuhan
* Verifikasi pengguna yang diundang