Kredensial Massal

Kredensial massal memungkinkan Anda menerbitkan lencana kepada ratusan atau ribuan penerima sekaligus dengan mengunggah file CSV. Prosesnya terdiri dari empat langkah dengan pelacakan progres bawaan, jeda/lanjutkan, dan penanganan kesalahan.

Ikhtisar

Proses kredensial massal mengikuti empat langkah:

1. Konfigurasi — pilih lencana dan opsi
2. Unggah — siapkan dan unggah file CSV Anda
3. Proses — pantau progres saat kredensial dibuat
4. Hasil — tinjau hasil dan unduh laporan

Langkah 1: Konfigurasi

1. Buka halaman Kredensial Massal dari bilah sisi (rutenya tersendiri, terpisah dari halaman Kredensial).
2. Pilih lencana yang ingin Anda terbitkan menggunakan pemilih lencana.
3. Secara opsional, atur:
   • Diterbitkan Pada — tanggal yang digunakan untuk semua kredensial (default hari ini)
   • Kedaluwarsa — tanggal kedaluwarsa opsional untuk semua kredensial
   • Kirim Email — apakah setiap penerima otomatis dikirimi email setelah kredensialnya dibuat
4. Klik Berikutnya.

Langkah 2: Unggah CSV

Format CSV

File CSV harus memiliki kolom name dan kolom email, dengan baris header. Nama header tidak peka huruf besar/kecil, dan recipient_name / recipient_email diterima sebagai alias untuk name / email.

name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

Unduh Templat

Klik Unduh Templat untuk mendapatkan file CSV kosong dengan header yang benar. Isi dengan data penerima Anda lalu unggah.

Unggah

1. Klik Unggah CSV atau seret dan lepas file Anda.
2. File divalidasi sebelum pemrosesan dimulai.

Aturan Validasi

Setiap baris divalidasi segera setelah file diurai:

• Nama harus terdiri dari minimal 5 karakter
• Email harus berupa alamat email yang valid
• Baris kosong dilewati

Tabel pratinjau menampilkan setiap baris dengan tanda centang hijau atau alasan berwarna merah. Baris yang tidak valid bukan penghalang — baris tersebut hanya dilewati, dan penghitung menunjukkan berapa banyak penerima valid yang akan diproses (mis. "18 valid recipients, 2 invalid (will be skipped)"). Anda dapat melanjutkan selama setidaknya satu baris valid; tidak perlu memperbaiki dan mengunggah ulang terlebih dahulu.

3. Klik Berikutnya untuk memulai pemrosesan.

Langkah 3: Pemrosesan

Setelah pemrosesan dimulai, Anda akan melihat bilah progres dan penghitung langsung:

• Bilah progres — persentase baris yang telah diproses
• Dibuat — berapa banyak kredensial yang telah dibuat
• Gagal — berapa banyak baris yang gagal
• Tersisa — berapa banyak baris yang masih mengantre

Tabel Dibuat, Gagal, dan Tertunda langsung terisi di bawah bilah progres selama batch berjalan.

Jeda dan Lanjutkan

• Klik Jeda untuk menghentikan pemrosesan sementara. Tidak ada kredensial baru yang dibuat selama dijeda.
• Klik Lanjutkan untuk melanjutkan dari titik terakhir.

Batalkan

• Klik Batalkan untuk menghentikan pemrosesan sepenuhnya. Kredensial yang sudah dibuat tetap tersimpan.

Penanganan Kesalahan

Ketika sebuah baris gagal karena alasan khusus baris tersebut (mis. nilai tidak valid yang ditolak backend):

• Kesalahan dicatat pada baris tersebut
• Pemrosesan otomatis berlanjut ke baris berikutnya
• Baris yang gagal dikumpulkan untuk langkah hasil, dengan teks kesalahannya ditampilkan di tabel kegagalan pada layar

Baris yang terkena pembatasan laju dicoba ulang otomatis dengan jeda singkat. Kesalahan kredit atau kuota berbeda — alih-alih melompat ke baris berikutnya, batch dijeda agar Anda tidak menghabiskan sisa file. Pemberitahuan merah "Insufficient credits" akan muncul; isi ulang kredit atau tingkatkan paket, lalu klik Lanjutkan untuk melanjutkan dari titik berhenti.

Pemulihan Setelah Halaman Dimuat Ulang

Jika Anda tidak sengaja menutup browser atau memuat ulang halaman saat pemrosesan, sesi kredensial massal akan dipulihkan ketika Anda kembali. Progres dilanjutkan dari titik berhenti.

Langkah 4: Hasil

Setelah pemrosesan selesai (atau dibatalkan), layar hasil menampilkan empat kartu ringkasan:

• Total — jumlah penerima dalam batch
• Dibuat — jumlah kredensial yang dibuat
• Gagal — jumlah baris yang gagal
• Dilewati — penerima yang tidak diproses (mis. baris yang tersisa setelah pembatalan)

Di bawah kartu, tabel Dibuat mencantumkan setiap kredensial baru dengan tautan untuk melihatnya, dan tabel Gagal mencantumkan kegagalan beserta teks kesalahannya.

Unduh Laporan

• Unduh CSV Hasil — setiap baris dalam batch, dengan kolom row, name, email, status, award_url (URL kredensial diisi untuk baris yang berhasil dibuat).
• Unduh CSV Kegagalan — hanya baris yang gagal, dengan kolom name, email, error.

Coba Ulang Kegagalan

Jika ada baris yang gagal, klik Coba Ulang Kegagalan. Ini memulai proses baru hanya untuk penerima yang gagal — tidak perlu mengunggah ulang CSV. Fitur ini berguna setelah memperbaiki masalah sementara, misalnya mengisi ulang kredit setelah batch dijeda.