Cara mengarsipkan percakapan dan kontak secara massal via API

Untuk mengarsipkan percakapan dan kontak secara massal secara programatik, gunakan API REST dari Papo. Dengan endpoint pembaruan kontak dan penerapan label pada percakapan, Anda dapat menandai catatan sebagai diarsipkan, menjaga basis tetap bersih tanpa intervensi manual — ideal untuk operasi dengan volume data besar atau untuk reseller white label yang mengelola banyak klien.

Papo tidak mewajibkan endpoint khusus “arsip”. Sebagai gantinya, Anda menggunakan operasi yang sudah tersedia di API untuk mengubah status catatan: memperbarui kontak (menambahkan label arsip atau atribut khusus) dan menerapkan label ke percakapan. Dengan begitu, skrip atau otomatisasi dapat memproses ribuan item secara batch dan mengatur basis sesuai aturan bisnis Anda.

Ringkasan proses pengarsipan massal via API

Cara kerjanya – langkah demi langkah

1. Autentikasi dan kunci

Setiap panggilan yang mengubah data memerlukan kunci rahasia akun. Kunci ini harus dikirim sebagai token Bearer di header Authorization (atau di header X-Papo-Secret-Key). Kunci publik (tetap per akun) dapat menyertai permintaan di header X-Papo-Public-Key — penggunaannya opsional, tetapi jika dikirim harus sesuai dengan akun yang sama dengan kunci rahasia.

Buat kunci di dasbor Papo, di area pengembang. URL dasar API adalah https://app.papo.global/api/v1. Lihat dokumentasi resmi untuk melihat endpoint, parameter, dan contoh payload yang tepat.

2. Mengidentifikasi catatan yang akan diarsipkan

Sebelum menjalankan pembaruan, Anda perlu mengetahui kontak atau percakapan mana yang harus diarsipkan. API menyediakan endpoint daftar yang mengembalikan data yang diperlukan. Misalnya, Anda dapat:

• Mendaftar kontak (pencarian berdasarkan nama, email, telepon, atau filter tanggal) untuk memilih kontak yang tidak berinteraksi selama X hari.
• Mendaftar percakapan dan mencocokkannya dengan kriteria seperti status atau tanggal pesan terakhir.

Dengan daftar tersebut, skrip Python, Node.js, atau otomatisasi di n8n dapat menelusuri setiap catatan dan menjalankan tindakan pengarsipan.

3. Mengarsipkan kontak secara massal

API Papo memungkinkan Anda memperbarui kontak yang sudah ada. Untuk mengarsipkannya, Anda dapat:

• Menambahkan label (misalnya “diarsipkan”) ke kontak. Endpoint pembaruan menerima penyertaan tag.
• Atau memperbarui atribut khusus (jika Anda telah membuat bidang seperti “status” atau “diarsipkan”) dengan nilai yang diinginkan.

Yang penting adalah setelah pembaruan, kontak membawa penanda yang membedakannya dari yang aktif. Karena API memproses satu kontak per permintaan, operasi massal dilakukan dengan menjalankan beberapa panggilan secara berurutan. Contoh kode dalam JavaScript dan Python tersedia di dokumentasi API dan dapat disesuaikan untuk endpoint pembaruan.

4. Mengarsipkan percakapan secara massal

Untuk percakapan, API menyediakan endpoint yang membuat label di akun (jika belum ada) dan menerapkannya ke kontak serta percakapan yang terbuka. Dengan demikian, Anda dapat membuat label “diarsipkan” dan menerapkannya ke semua percakapan yang ingin dikeluarkan dari tampilan utama.

Alurnya mirip dengan kontak: daftar percakapan, filter yang harus diarsipkan, lalu untuk masing-masing kirim permintaan penerapan label. Label akan dibuat otomatis pada panggilan pertama jika belum ada.

5. Memeriksa pengarsipan

Setelah skrip selesai, buka modul Kontak dan Percakapan di dasbor Papo. Gunakan filter berdasarkan label untuk melihat hanya item yang ditandai “diarsipkan” — atau sebaliknya, untuk menyembunyikannya dan tetap fokus pada catatan aktif. Jika operasi tidak memberikan efek yang diharapkan, periksa kembali payload dan header autentikasi.

Untuk siapa otomatisasi ini cocok

• Operasi dengan volume kontak besar yang perlu membersihkan basis secara berkala, menghapus dari tampilan utama prospek dingin atau percakapan yang sudah selesai.
• Reseller white label yang mengelola puluhan akun klien dan ingin menawarkan layanan pengorganisasian otomatis via API.
• Tim TI dan pengembang yang membangun integrasi khusus untuk menjaga CRM tetap ramping, tanpa bergantung pada tindakan manual.
• Perusahaan yang memigrasikan data dari sistem lain dan sekarang ingin mengarsipkan catatan lama yang tidak akan digunakan lagi dalam operasional sehari-hari.

Pertanyaan umum

Apakah API Papo memiliki endpoint khusus untuk mengarsipkan?

Tidak perlu endpoint eksklusif. Anda menggunakan endpoint pembaruan kontak dan penerapan label pada percakapan untuk menandai catatan sebagai diarsipkan. Dokumentasi resmi merinci parameter yang diterima.

Bisakah saya menghapus kontak atau percakapan alih-alih mengarsipkan?

API saat ini tidak menyediakan endpoint penghapusan. Rekomendasinya adalah menggunakan pengarsipan melalui label atau atribut khusus, yang menjaga data tetap tersimpan tetapi di luar tampilan utama.

Bagaimana cara mengautentikasi permintaan?

Sertakan header Authorization: Bearer {sua_chave_secreta} di semua panggilan tulis. Kunci rahasia dibuat di dasbor Papo, di bagian pengembang.

Apakah mungkin mengarsipkan ribuan catatan sekaligus?

Ya. Cukup buat skrip yang melakukan loop melalui daftar kontak atau percakapan dan mengirim satu permintaan untuk masing-masing. Alat seperti n8n juga dapat mengorkestrasi proses ini.

Apakah percakapan yang diarsipkan hilang dari kotak masuk?

Percakapan tetap ada, tetapi dengan menerapkan label seperti “diarsipkan”, Anda dapat memfilternya keluar dari tampilan standar. Cara tampilannya bergantung pada filter yang dikonfigurasi di modul Percakapan.

Di mana saya menemukan kunci API?

Di dasbor Papo, buka area pengembang atau pengaturan API. Kunci rahasia hanya ditampilkan saat pembuatan; jika hilang, Anda perlu membuat yang baru.

Baca juga

• Cara menggunakan API Papo untuk mendaftar percakapan dan mengirim pesan secara programatik
• Cara menggunakan API Papo untuk mengelola atribut khusus kontak

Mulai gratis dan rapikan basis Anda dengan API →

Dengan paket gratis Papo, Anda sudah dapat menguji integrasi dan mengarsipkan kontak serta percakapan secara massal tanpa biaya awal.