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

# Unggah Kontak

> Format CSV, aturan validasi, dan penetapan tag untuk mengunggah kontak

## Apa yang dapat Anda lakukan di halaman ini

Mengunggah file CSV kontak agar Anda dapat menjalankan kampanye. Anda akan mempelajari kolom yang diperlukan, aturan validasi, batas ukuran, dan cara menambahkan tag selama proses unggah.

## Sebelum memulai

* Memiliki akun Nudgen
* File CSV dengan setidaknya satu kolom `email`
* Jumlah kontak harus berada di bawah batas paket Anda (lihat [penagihan](/id/billing/overview))

## Langkah 1: Siapkan CSV Anda

CSV Anda harus menyertakan:

| Kolom   | Diperlukan | Deskripsi                            |
| ------- | ---------- | ------------------------------------ |
| `email` | Ya         | Alamat email yang valid. Harus unik. |
| `name`  | Tidak      | Nama tampilan untuk personalisasi.   |

Anda dapat menambahkan kolom lain (misalnya: `company`, `segment`). Kolom tersebut disimpan secara terenkripsi dan dapat digunakan dalam tag atau logika segmentasi.

## Langkah 2: Validasi Format

* **Pengkodean (Encoding):** Direkomendasikan UTF-8.
* **Pemisah (Delimiter):** Koma (`,`).
* **Baris Header:** Baris pertama harus berisi nama kolom. Kolom `email` dan `name` dikenali tanpa membedakan huruf besar-kecil (case-insensitive).
* **Email Duplikat:** Duplikat dalam file yang sama akan digabungkan. Kontak yang sudah ada dengan email yang sama akan diperbarui.

<Warning>
  Email yang tidak valid (salah format, tidak ada `@`, dll.) akan dilewati. Periksa ringkasan unggahan untuk melihat berapa banyak baris yang diimpor vs yang dilewati.
</Warning>

## Langkah 3: Unggah di Nudgen

1. Buka **Kontak** (Contacts) di bilah sisi.
2. Klik **Unggah CSV** (Upload CSV).
3. Pilih file Anda.
4. Pilih tag yang ingin diterapkan ke semua kontak yang diunggah (misalnya: `inactive`, `re-engage`).
5. Tinjau pratinjau dan lakukan konfirmasi.

## Batas Ukuran

* **Ukuran File:** Ikuti batas yang tertera di layar (biasanya beberapa MB). Daftar besar mungkin membutuhkan waktu lebih lama untuk diproses.
* **Kontak per Ruang Kerja:** Tergantung pada paket Anda. Aplikasi memberlakukan batas saat proses unggah; jika Anda melampauinya, unggahan akan ditolak. Lihat [Penagihan](/id/billing/overview) dan [halaman harga](https://nudgen.net/pricing) untuk batas saat ini.

## Langkah selanjutnya

* Kontak akan muncul dalam daftar dengan email yang disamarkan (`j***@g***.com`).
* Gunakan tag untuk mensegmentasi audiens dalam [kampanye](/id/campaigns/create).
* Anda dapat [mengungkapkan (reveal)](/id/contacts/overview) informasi kontak individual sebagai pemilik akun.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Beberapa baris dilewati">
    Pastikan setiap baris memiliki email yang valid di kolom `email`. Baris kosong atau alamat dengan format salah akan dilewati.
  </Accordion>

  <Accordion title="Unggah gagal: batas paket terlampaui">
    Jumlah kontak Anda akan melebihi batas paket. Tingkatkan paket Anda atau hapus kontak yang sudah ada.
  </Accordion>

  <Accordion title="Kolom tidak dikenali">
    Pastikan baris header menyertakan `email` (atau `Email`). Kolom lainnya bersifat opsional.
  </Accordion>
</AccordionGroup>

## Dokumen terkait

<CardGroup cols={2}>
  <Card title="Ikhtisar kontak" icon="users" href="/id/contacts/overview">
    Enkripsi, penyamaran, dan segmentasi.
  </Card>

  <Card title="Buat kampanye" icon="paper-plane" href="/id/campaigns/create">
    Pilih audiens dan luncurkan kampanye.
  </Card>
</CardGroup>