# Kontak

Profil pelanggan dari WhatsApp ditambah data tim: label, PIC, field kustom, statistik, riwayat interaksi & tiket, linimasa, dan catatan.

## Dari mana kontak berasal

- **WhatsApp**: kontak dibuat otomatis saat pelanggan menulis. Nama WhatsApp, foto, info, dan profil WhatsApp Business diperbarui berkala. Nomor dan ID privasi WhatsApp (LID) disimpan sebagai identitas kontak yang sama.
- **Manual**: Kontak → **Tambah kontak**. Nomor `0812…` dibaca sebagai `62812…`; pesan WhatsApp dari nomor itu nantinya masuk ke kontak ini.
- **Impor CSV** dan **API** (lihat di bawah).

## Profil

- **Data**: nama (nama WhatsApp tetap tersimpan), nomor, email, perusahaan, jabatan, alamat, kota, bahasa, **PIC** (agen penanggung jawab), sumber, pertama & terakhir terlihat.
- **Statistik**: jumlah interaksi, pesan masuk & keluar, tiket dibuka & selesai, rata-rata respons pertama & penyelesaian, agen terakhir, dan aktivitas 12 bulan.
- **Tab**: Ringkasan · Interaksi · Tiket (dengan log status) · Leads (lead kontak yang boleh kamu lihat, butuh akses Pipeline) · Linimasa (perubahan profil, label, PIC, penugasan, catatan, tiket, lead) · Catatan.
- **Klien**: perusahaan/instansi kontak dari master **Kontak → Klien**, dipilih di form Ubah kontak. Lihat [Klien](https://onix.sassly.ai/id/docs/pipeline#klien).
- **Aksi**: Mulai chat, Buat tiket, Buat lead, Ubah, Gabungkan, Hapus.

## Label kontak & field kustom

- **Label Onix** (Kelola → Label & field kustom) berwarna, berlaku untuk semua channel, dan bisa diubah tim. Label tampil di daftar inbox dan bisa dipasang/dilepas langsung dari tab **Kontak** di panel detail percakapan. Inbox dan daftar kontak bisa difilter per label.
- Berbeda dengan **label WhatsApp Business** yang hanya dibaca dari HP — keduanya tampil di profil.

## Field kustom kontak, interaction, tiket, lead, dan klien

Field kustom menambah data khusus bisnismu. **Buat field-nya dulu** di **Kelola → Label & field kustom → Field kustom** (pilih Kontak, Interaction, Tiket, Lead, atau Klien), lalu isi nilainya di tempat masing-masing:

| Untuk | Contoh | Diisi di | Yang boleh mengisi |
| --- | --- | --- | --- |
| **Kontak** | Tanggal lahir, ukuran baju, tipe pelanggan | Form Ubah kontak, impor CSV, atau tab Kontak di panel detail Interaction | Pengelola kontak (`contacts.manage`) |
| **Interaction** | Nomor invoice, sumber pesanan, nilai pesanan | Tab Info di panel detail Interaction → **Ubah** | Yang boleh membalas percakapan |
| **Tiket** | Ekspedisi, nomor resi pengganti, biaya yang ditanggung toko | Dialog Buat tiket, atau panel Field kustom di halaman tiket | Pembuat tiket saat membuat; pengelola tiket setelahnya |
| **Lead** | Ukuran, jumlah pesanan, sumber info | Dialog Buat lead, detail lead, atau impor lead | Pengelola lead |
| **Klien** | NPWP, jumlah karyawan, tipe instansi | Form klien (Kontak → Klien) | Pengelola klien |

- Jenis field: **teks** (maks 500 karakter), **angka** (format `1.250.000` dikenali), **tanggal**, atau **pilihan**.
- Kunci field dibuat dari namanya (mis. "Nomor invoice" → `nomor_invoice`), dipakai di API dan impor/ekspor CSV kontak. Nama dan pilihan bisa diubah; jenis tidak.
- Maksimal 30 field per jenis data. Menghapus field menyembunyikan nilainya. Perubahan field tiket tercatat di log tiket.

## Mulai chat

Di profil kontak klik **Mulai chat**, pilih nomor WhatsApp, dan tulis pesan pertama. Percakapan terbuka dengan kontak itu di nomor yang sama dipakai lagi; selain itu dibuat nomor interaksi baru. Kuota balasan dan batas kirim per nomor tetap berlaku.

## Gabung kontak ganda

**Gabungkan** → cari kontak ganda → pilih. Nomor/identitas WhatsApp, percakapan, tiket, catatan, linimasa, dan label pindah ke kontak yang sedang dibuka; data yang masih kosong diisi dari kontak ganda; lalu kontak ganda dihapus.

## Impor & ekspor CSV

- **Impor**: baris pertama berisi judul kolom — `nama`, `nomor`, `email`, `perusahaan`, `jabatan`, `alamat`, `kota`, `bahasa`, `label` (pisahkan dengan `;` atau `|`), `pic` (email anggota), dan nama/kunci field kustom (judul bahasa Inggris juga dikenali). Pemisah koma atau titik koma (Excel) dikenali. Kontak dicocokkan lewat nomor lalu email: yang cocok diperbarui (sel kosong tidak menghapus data), sisanya dibuat. Label yang belum ada dibuat otomatis. Maksimal 5.000 baris / 2 MB per file; baris bermasalah dilaporkan dengan nomornya.
- **Ekspor** mengikuti filter daftar kontak. Sel yang diawali `=`, `+`, `-`, atau `@` diberi tanda kutip satu supaya tidak dijalankan sebagai rumus oleh Excel/Sheets.

## Segmen & broadcast

- **Kontak → Segmen** menyimpan filter kontak, mis. email berakhiran domain tertentu, label Reseller, pernah chat dengan nomor tertentu, atau ulang tahun bulan ini dari field kustom tanggal. Jumlahnya dihitung ulang setiap dipakai, bisa diunduh CSV, dan dipakai untuk [Broadcast](https://onix.sassly.ai/id/docs/broadcast) (Pro & Custom). Segmen tersedia di semua paket.
- Panel **Broadcast** di profil kontak menunjukkan apakah kontak menerima broadcast. Kontak yang membalas STOP/BERHENTI/UNSUBSCRIBE ke pesan broadcast otomatis berhenti berlangganan; statusnya bisa diubah manual (akses kelola kontak atau kelola broadcast). Kontak yang berhenti berlangganan selalu dilewati broadcast.
- Linimasa kontak mencatat broadcast yang diterima dan perubahan status berlangganan.

## Menghapus kontak

**Hapus** menghapus permanen kontak beserta semua percakapan, pesan, media, catatan, dan linimasanya — pakai untuk permintaan penghapusan data pelanggan (lihat [Penghapusan Data](https://onix.sassly.ai/id/legal/penghapusan-data)). Tiket tetap ada sebagai catatan kasus internal tanpa tautan ke kontak.

## Grup WhatsApp

Grup punya halaman sendiri (tombol **Halaman grup** di panel detail percakapan grup): nama, foto, deskripsi, anggota (dicocokkan dengan kontak lewat nomor), dan percakapan grup.

## Akses

- *Melihat kontak* membuka daftar & profil; *Mengubah … kontak* untuk menambah, mengubah, menggabung, impor/ekspor, menghapus, serta label & field. Catatan bisa ditulis semua yang bisa melihat kontak; hanya penulisnya yang bisa mengubah.
- Anggota dengan akses channel terbatas hanya melihat kontak dari channel yang boleh ia buka (ditambah kontak manual/impor), dan statistiknya hanya dari percakapan di nomor itu.

## Lewat API

`GET /contacts`, `POST /contacts`, `GET/PATCH /contacts/{id}`, catatan, linimasa, label, `POST /interactions` untuk mulai chat, dan `GET /segments` (baca segmen). Rincian di [dokumentasi API](https://onix.sassly.ai/id/docs/api).