Indonesian id

Bahasa

pt_BR Portuguese (Brazil) en English es Spanish fr French it Italian de German ar Arabic hi Hindi tr Turkish id Indonesian zh_CN Chinese (China)

Cara Menggunakan API Papo untuk Menampilkan Daftar Percakapan dan Mengirim Pesan Secara Programatik

Open in

View as Markdown

Open in ChatGPT Open in Claude

Vitor

Terakhir diperbarui saat Oct 22, 2026

Dengan Papo (https://papo.global/), Anda dapat menggunakan API REST untuk menampilkan daftar percakapan, mengirim pesan teks, menerapkan label, dan menugaskan percakapan ke agen, mengotomatiskan proses layanan pelanggan tanpa mengakses antarmuka. API ini menyediakan endpoint yang mencerminkan fungsionalitas modul Percakapan, memungkinkan sistem eksternal mengelola interaksi secara programatik.

Aksi API	Apa yang dilakukan	Contoh penggunaan
Menampilkan daftar percakapan	Mengembalikan percakapan akun, dengan filter berdasarkan status, label, atau agen	Memantau layanan aktif atau tertutup dari CRM eksternal
Mengirim pesan teks	Mengirim pesan teks ke kontak (mematuhi jendela 24 jam WhatsApp)	Memberi tahu pelanggan tentang pembaruan pesanan
Menerapkan label	Membuat label (jika belum ada) dan menerapkannya pada kontak dan percakapan yang terbuka	Menandai percakapan sebagai "Urgente" atau "Purna jual" secara otomatis
Menugaskan percakapan	Menugaskan percakapan terbuka dari kontak ke agen tertentu	Mengarahkan prospek ke tenaga penjual yang bertanggung jawab atas wilayah tersebut

Cara kerja API Percakapan Papo

API Papo mengikuti standar REST, dengan autentikasi melalui kunci rahasia (Bearer token) dan respons dalam JSON. Semua operasi yang dijelaskan di sini menggunakan basis autentikasi yang sama dan dapat dikombinasikan untuk membuat alur kerja otomatis — misalnya, sistem triase yang, saat menerima prospek baru, menampilkan daftar percakapan terbaru, menerapkan label "Baru", dan menugaskannya ke agen jaga.

Basis API adalah https://app.papo.global/api/v1. Untuk menggunakan endpoint percakapan, label, dan penugasan, Anda memerlukan token API yang dibuat di panel Papo. Dokumentasi lengkap dengan endpoint dan parameter spesifik tersedia di papo.global/pt/docs.

Langkah demi langkah untuk menggunakan fitur API

1. Buat token API

Di panel Papo, akses bagian pengembang atau token akses. Buat kunci rahasia (sk_live_…) dengan izin yang sesuai untuk mengelola percakapan. Simpan token di tempat aman — token akan dikirim di header Authorization untuk semua permintaan.

2. Tampilkan daftar percakapan

Gunakan endpoint daftar percakapan untuk mendapatkan layanan akun. Permintaan menerima parameter filter seperti:

Status: percakapan terbuka, tertutup, atau semua.
Label: memfilter berdasarkan satu atau lebih label yang diterapkan.
Agen: membatasi pada percakapan yang ditugaskan ke pengguna tertentu.
Periode: rentang tanggal untuk membatasi kueri.

Respons mencakup pengenal percakapan, kontak, saluran, status, dan pesan terakhir. Dengan data ini, Anda dapat memantau volume layanan atau memicu tindakan bersyarat dari sistem eksternal.

3. Kirim pesan teks

Untuk mengirim pesan teks ke kontak, gunakan endpoint kirim pesan. Permintaan memerlukan:

Nomor penerima dalam format internasional (mis.: 5511999999999).
Teks pesan.
Pengenal instans (opsional) — jika akun Anda memiliki lebih dari satu koneksi WhatsApp, Anda dapat menentukan mana yang akan digunakan.

API mengembalikan konfirmasi bahwa permintaan telah diterima. Ingatlah bahwa pengiriman pesan teks tunduk pada jendela 24 jam WhatsApp; untuk komunikasi di luar periode tersebut, perlu menggunakan template pesan (HSM) yang telah disetujui sebelumnya.

4. Terapkan label ke kontak dan percakapan

API memungkinkan mengelola label dengan dua cara:

Membuat label di akun: tentukan judul, warna, dan deskripsi untuk label baru.
Menerapkan label: kaitkan label yang ada ke kontak dan percakapan terbuka kontak tersebut. Jika label belum ada, label akan dibuat secara otomatis selama penerapan.

Ini berguna untuk mengklasifikasikan percakapan secara otomatis berdasarkan aturan sistem Anda — misalnya, menandai sebagai "Keluhan" ketika pelanggan mengirim kata kunci tertentu.

5. Tugaskan percakapan ke agen

Dengan endpoint penugasan, Anda dapat menunjuk agen untuk semua percakapan terbuka dari kontak tertentu. Cukup berikan pengenal kontak dan ID pengguna/agen. Daftar agen akun dapat diperoleh melalui endpoint daftar pengguna, yang mengembalikan nama, email, dan ID setiap anggota tim.

Fungsionalitas ini penting untuk perutean otomatis: sistem CRM dapat, saat mengidentifikasi profil prospek, menugaskannya ke tenaga penjual yang tepat tanpa intervensi manual.

Siapa yang harus menggunakan API Percakapan

Operasi yang sudah menggunakan sistem eksternal (ERP, CRM, platform e-commerce) dan ingin mengintegrasikan layanan Papo tanpa duplikasi upaya.
Tim dukungan dengan aturan perutean kompleks, yang perlu mengklasifikasikan dan mengarahkan percakapan secara otomatis berdasarkan data pelanggan.
Pengembang yang membangun dasbor khusus atau memicu notifikasi dari peristiwa layanan.
Reseller white label yang mengelola banyak akun dan ingin mengotomatiskan konfigurasi label dan penugasan untuk setiap klien.

Pertanyaan yang sering diajukan

Apakah saya memerlukan token API untuk menggunakan endpoint ini?

Ya. Semua permintaan ke API Papo memerlukan autentikasi melalui kunci rahasia, dikirim di header Authorization: Bearer sk_live_…. Token dibuat di panel akun.

Apakah API memungkinkan mengirim pesan di luar jendela 24 jam WhatsApp?

Pengiriman pesan teks melalui API mematuhi jendela 24 jam. Untuk komunikasi proaktif di luar periode tersebut, perlu menggunakan template pesan (HSM) yang disetujui. Papo menyediakan endpoint khusus untuk pengiriman HSM.

Bisakah saya menampilkan daftar percakapan berdasarkan label?

Ya. Endpoint daftar percakapan menerima filter berdasarkan label, memungkinkan Anda mengambil hanya layanan yang ditandai dengan satu atau lebih tag tertentu.

Bagaimana cara menerapkan label ke kontak melalui API?

Gunakan endpoint label, dengan memberikan pengenal label (atau data untuk pembuatan) dan pengenal kontak. Label akan diterapkan ke kontak dan percakapan terbuka yang sesuai.

Apakah API mengembalikan riwayat percakapan lengkap?

Daftar percakapan mengembalikan metadata dan pesan terakhir. Untuk mendapatkan riwayat pesan lengkap dari percakapan tertentu, lihat dokumentasi API, yang merinci endpoint pengambilan pesan.

Apakah mungkin menugaskan percakapan ke agen tanpa mengetahui ID pengguna?

Anda dapat terlebih dahulu menampilkan daftar pengguna akun (endpoint agen) untuk mendapatkan ID, lalu gunakan endpoint penugasan. Daftar agen mencakup nama dan email, memudahkan identifikasi.