Your AI Connector Docs

Mengimpor Kontak dari File

Jika Anda memiliki daftar kontak dalam spreadsheet, Anda dapat mengunggah semuanya sekaligus alih-alih menambahkannya satu per satu. Aplikasi ini menggunakan wizard 3 langkah — Unggah → Petakan kolom → Tinjau — yang berfungsi dengan file CSV yang sudah Anda miliki, tanpa perlu mengunduh templat terlebih dahulu.

Cara Mengimpor Kontak

  1. Klik Contacts di bilah sisi kiri, lalu klik Import di bagian atas halaman.
  2. Upload. Seret file CSV Anda ke zona lepas (dropzone), atau klik untuk menelusuri. Tidak perlu mengunduh templat terlebih dahulu — gunakan file yang sudah Anda miliki.
  1. Petakan kolom. Wizard akan membaca baris header file Anda dan mencoba mencocokkan setiap kolom secara otomatis ke bidang target: Nama depan, Nama belakang, Telepon, Email, Tag, Catatan, salah satu bidang kustom Anda, atau Jangan impor. Periksa tebakan untuk setiap kolom dan perbaiki jika ada yang salah menggunakan pemilih di sebelahnya. Tabel pratinjau akan menampilkan beberapa baris pertama persis seperti saat diimpor nanti.
    • Kolom yang headernya merupakan nama salah satu bidang kustom Anda akan dicocokkan ke bidang tersebut secara otomatis. Huruf besar dan aksen tidak berpengaruh, jadi kolom CPF akan menemukan bidang bernama cpf. Anda juga dapat memilih bidang kustom apa pun untuk kolom mana pun secara manual.
    • Kolom yang belum menjadi salah satu bidang kustom Anda dapat dijadikan bidang kustom: pilih Bidang kustom baru: di pemilihnya dan bidang tersebut akan dibuat saat Anda melakukan impor.
    • Jika bidang kustom memiliki tipe (Angka, Kotak centang, Dropdown) dan beberapa nilai kolom tidak sesuai, wizard akan memperingatkan Anda berapa banyak baris yang terpengaruh sebelum Anda mengimpor. Baris-baris tersebut akan dilewati sepenuhnya, termasuk nama dan email. Klik Ubah ke Teks pada peringatan tersebut untuk mengubah tipe bidang dalam satu langkah, atau perbaiki nilainya, atau atur kolom ke Jangan impor.
    • Kolom nomor telepon wajib ada — Anda tidak dapat melanjutkan tanpa memetakan salah satu kolom.
    • Kolom yang dipetakan ke Tag akan menjadi tag nyata pada setiap kontak. Beberapa tag dalam satu sel tidak masalah — pisahkan dengan koma atau titik koma (vip; newsletter; hotmart). Tag yang belum ada akan dibuatkan untuk Anda; tag yang sudah ada akan digunakan kembali, dengan mengabaikan penggunaan huruf besar.
  1. Tinjau. Pilih:
    • Saluran default — WhatsApp Business, WhatsApp Web, atau SMS. Ini berlaku untuk setiap kontak yang diimpor yang belum menentukan saluran.
    • Daftar — pilih daftar yang sudah ada dari menu drop-down, atau ketik nama untuk membuat daftar baru secara langsung. Anda hanya dapat memilih salah satu, tidak bisa keduanya. Jika Anda membuka impor saat halaman Kontak menampilkan salah satu daftar Anda, daftar tersebut sudah dipilih untuk Anda; hapus jika Anda tidak menginginkannya.
    • Perbarui kontak yang ada — nonaktif secara default. Jika nonaktif, baris yang cocok dengan kontak yang sudah Anda miliki (nomor telepon yang sama) akan dilewati sebagai duplikat: tidak ada perubahan pada kontak tersebut, meskipun jika Anda memilih daftar, kontak yang sudah Anda miliki tetap akan bergabung ke daftar tersebut. Jika aktif, baris tersebut akan memperbarui kontak: nama, email, dan catatan di file Anda akan menimpa data yang ada (sel kosong akan membiarkan nilai saat ini tetap apa adanya), tag apa pun di baris tersebut akan ditambahkan, dan kontak akan ditambahkan ke daftar yang Anda pilih. Inilah cara Anda mengimpor ulang file untuk memperbaiki atau memperkaya kontak yang sudah Anda miliki.
  1. Klik Impor [count]. Anda akan diarahkan ke layar hasil yang menunjukkan berapa banyak kontak yang dibuat, berapa banyak kontak yang sudah ada yang diperbarui (bila opsi tersebut aktif), berapa banyak kontak yang sudah Anda miliki yang ditambahkan ke daftar yang Anda pilih, dan, jika ada baris yang dilewati, rincian alasannya (nomor telepon tidak valid, nomor telepon hilang, duplikat, batas kontak tercapai, dll.). Jika Perbarui kontak yang ada dalam posisi mati dan beberapa baris cocok dengan kontak yang sudah Anda miliki, layar hasil akan memberitahukannya dan menawarkan Perbarui kontak ini: satu klik akan mengirim ulang baris tersebut saja dengan sakelar aktif, sehingga Anda tidak perlu mengimpor file lagi.

Detail Pemetaan Kolom

  • Telepon adalah satu-satunya kolom yang wajib diisi. Baris tanpa nomor telepon sama sekali akan dibuang sebelum impor dan dihitung secara terpisah di layar hasil.
  • Nama depan / Nama belakang / Email dipetakan langsung ke kolom dasar kontak.
  • Catatan dipetakan ke kolom Catatan / Profil Prospek kontak.
  • Tag membuat (atau menggunakan kembali) tag asli dan menerapkannya ke kontak — tag yang sama yang Anda gunakan untuk memfilter, menargetkan siaran, dan memicu webhook. Masukkan beberapa tag dalam satu sel yang dipisahkan dengan koma atau titik koma. Sebelum 19 Agustus 2026, kolom ini disimpan sebagai kolom kustom bernama tags; jika Anda melakukan impor sebelum tanggal tersebut, impor ulang file yang sama dengan opsi Perbarui kontak yang ada aktif dan tag akan diterapkan dengan benar (kolom kustom tags yang tersisa tidak akan menimbulkan masalah; hubungi dukungan jika Anda ingin menghapusnya dari setiap kontak).
  • Kolom kustom — setiap kolom kustom Anda adalah targetnya sendiri. Header yang cocok dengan nama kolom akan dipilihkan untuk Anda; nilainya disimpan pada kontak persis seperti yang ada di file (kolom Angka, Tanggal, Kotak centang, atau Dropdown akan mengonversi bentuk yang dapat dikenali seperti 19,99, 01/02/1990, atau yes). Pilih Kolom kustom baru untuk membuat kolom dari sebuah kolom file. Dengan opsi Perbarui kontak yang ada aktif, nilai kolom kustom dalam file juga akan memperbarui kontak yang sudah Anda miliki; sel kosong akan membiarkan nilai saat ini tetap apa adanya.
  • Kolom yang berisi pengenal dengan titik, tanda hubung, atau angka nol di depan (seperti CPF, nomor pajak, kode pos) harus dimasukkan ke dalam kolom Teks. Dalam kolom Angka, nilai tersebut tidak sesuai dan baris akan dilewati.

Tips

  • Periksa kembali apakah nomor telepon menyertakan kode negara. Tanpanya, pesan tidak akan terkirim — dan baris tanpa nomor telepon yang dapat digunakan akan dilewati sepenuhnya.
  • Anda tidak perlu menghapus spasi, tanda hubung, atau tanda kurung dari nomor telepon — pengimpor dapat menoleransi pemformatan umum, tetapi tetap memerlukan kode negara.
  • File diurai sepenuhnya di browser Anda, jadi tidak ada batas ukuran unggahan tetap dari wizard itu sendiri — namun jumlah total kontak Anda tetap dibatasi oleh paket Anda. Jika impor melebihi batas paket Anda, baris tersebut akan ditolak dan muncul di layar hasil sebagai contact_limit_reached.
  • Jika kontak dengan nomor telepon yang sama sudah ada, baris tersebut akan dilewati secara default — baris tersebut muncul sebagai duplicate di layar hasil. Impor tidak akan pernah membuat salinan kedua dari seseorang. Memilih daftar tetap berfungsi pada baris tersebut: kontak yang sudah Anda miliki ditambahkan ke daftar dan dihitung secara terpisah di layar hasil, jadi mengimpor ulang file yang sama adalah cara Anda mengisi daftar dengan orang-orang yang sudah ada di akun Anda. Untuk juga menyegarkan kolom mereka (memperbaiki nama atau email, menambahkan tag), aktifkan Perbarui kontak yang ada pada langkah Tinjau dan impor ulang file tersebut.

Pertanyaan yang Sering Diajukan

CSV saya memiliki kolom custom_company dari ekspor lama — apakah akan dipetakan dengan benar? Tidak secara otomatis, karena headernya tidak persis company. Pilih Kolom kustom: company di pemilih kolom tersebut dan data akan diimpor ke kolom company. Mengubah nama header menjadi company sebelum mengunggah akan membuat wizard mencocokkannya untuk Anda.

Beberapa baris dilewati dengan pesan “Nilai bidang kustom tidak sesuai dengan tipe bidang tersebut” — mengapa? Kolom tersebut dipetakan ke bidang kustom bertipe (misalnya Angka) dan baris-baris tersebut berisi data lain, seperti 001.576.401-08 di bidang Angka. Klik Ubah ke Teks pada peringatan di langkah Petakan kolom (atau ubah tipenya di bawah Bidang kustom) dan impor kembali file tersebut dengan Perbarui kontak yang ada dalam posisi aktif.

Ke mana perginya tombol “Unduh Templat”? Tombol tersebut sudah tidak ada — wizard bekerja langsung dengan CSV apa pun yang sudah Anda miliki dan memungkinkan Anda memperbaiki kolom yang tidak cocok di langkah Petakan.

Saya sudah mengimpor kontak saya — bagaimana cara menambahkan tag atau memperbaiki bidang untuk semuanya sekaligus? Impor ulang file yang sama (atau file yang diperbarui) dengan Perbarui kontak yang ada diaktifkan pada langkah Tinjau. Baris yang cocok dengan nomor telepon yang ada akan memperbarui kontak tersebut — nama, email, catatan, tag, dan daftar — alih-alih dilewati. Hanya nomor telepon yang digunakan untuk mencocokkan, jadi pertahankan kolom tersebut persis seperti sebelumnya.

Bisakah saya mengimpor kontak Instagram atau Messenger dari sebuah file? Tidak. Impor hanya mendukung WhatsApp Business, WhatsApp Web, dan SMS, karena saluran tersebut menjangkau orang melalui nomor telepon. Sebaliknya, Instagram dan Messenger mengidentifikasi orang berdasarkan akun sosial mereka, sehingga kontak tersebut dibuat secara otomatis saat seseorang mengirim pesan kepada Anda di saluran tersebut.

Bisakah saya mengimpor kontak sebagai tidak aktif bot? Tidak ada kolom per baris untuk itu. Impor batch terlebih dahulu, lalu gunakan tindakan massal Bot mati pada kontak yang diimpor — lihat Mengecualikan Kontak dari Bot AI.

Langkah Selanjutnya