Dengan API REST Papo, Anda dapat melihat daftar kotak masuk yang ada dan membuat koneksi baru untuk kanal seperti WhatsApp dan Instagram — semuanya melalui permintaan terautentikasi, tanpa membuka panel. Inilah cara programatik untuk menyediakan kanal layanan, mengintegrasikan sistem eksternal, dan menjaga operasi multikanal tetap selaras dengan otomasi.
API Papo menyediakan sumber daya kotak masuk yang memungkinkan Anda memeriksa konfigurasi saat ini dan menambahkan kanal baru. Dengan ini, tim TI, integrator, dan reseller white label dapat mengelola koneksi secara batch, mereplikasi pengaturan antar akun, dan mengotomatiskan aktivasi kanal tanpa bergantung pada antarmuka.
Ringkasan operasi kotak masuk via API
| Operasi | Apa fungsinya | Kapan digunakan |
|---|---|---|
| Menampilkan daftar kotak | Mengembalikan kotak masuk akun, dengan kanal terkait (WhatsApp, Instagram, email, dll.) dan detail konfigurasi. | Mengaudit kanal aktif, menyinkronkan dengan sistem pemantauan, atau mempersiapkan migrasi. |
| Membuat kotak | Membuat kotak masuk baru, menentukan kanal, nama, dan agen yang akan memiliki akses. | Menyediakan kanal secara otomatis saat mengintegrasikan klien, unit, atau merek baru. |
Bagaimana Autentikasi API Bekerja
Semua panggilan ke API, termasuk menampilkan daftar kotak, memerlukan kunci rahasia akun. Kunci ini harus dikirim sebagai token Bearer di header Authorization. Kunci publik akun bersifat opsional, tetapi jika dikirim, harus sesuai dengan akun yang sama dengan kunci rahasia.
URL dasar API adalah https://app.papo.global/api/v1. Kunci dibuat di area pengembang panel Papo. Kunci rahasia muncul hanya sekali saat dibuat; simpan di tempat aman dan cabut jika ada kecurigaan kebocoran.
Untuk memvalidasi autentikasi, Anda dapat memanggil endpoint GET /api/v1/me, yang mengembalikan data akun. Pola autentikasinya sama dengan yang digunakan di semua endpoint lainnya:
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_…" \
-H "X-Papo-Public-Key: pk_live_…"
Cara Mengelola Kotak Masuk dalam Praktik
- Buka area pengembang/API di panel Papo dan buat kunci rahasia. Salin juga kunci publik akun.
- Di setiap permintaan, autentikasi dengan kunci rahasia sebagai token Bearer. Jika ingin memperkuat validasi, kirim kunci publik di header
X-Papo-Public-Key. - Untuk menampilkan daftar kotak masuk, panggil endpoint daftar kotak. Responsnya berisi pengenal setiap kotak, kanal yang dikonfigurasi, dan properti lain, sehingga Anda dapat memetakan apa yang sudah ada sebelum membuat yang baru.
- Untuk membuat kotak baru, kirim payload JSON dengan informasi kanal yang diinginkan — misalnya, WhatsApp (API resmi Meta), Instagram, email, atau Telegram. Sertakan nama kotak dan pengenal agen yang harus memiliki akses. Lihat dokumentasi resmi untuk format pasti kolom dan nilai yang diterima.
- Setelah dibuat, kotak langsung tersedia di panel dan mulai menerima pesan begitu koneksi kanal selesai (untuk kanal yang memerlukan pemasangan, seperti WhatsApp, API mengembalikan instruksi yang diperlukan).
Karena API bersifat REST dan menggunakan JSON, bahasa apa pun yang mendukung HTTP dapat digunakan untuk mengintegrasikan pengelolaan kotak ke skrip, alat otomasi (seperti n8n), atau sistem penyediaan. Dokumentasi resmi di https://papo.global/pt/docs menyediakan detail autentikasi, parameter, respons, dan contoh kode.
Untuk Siapa Integrasi Ini Relevan
- Tim TI yang menyediakan kanal secara batch untuk unit, waralaba, atau merek baru, tanpa perlu mengakses panel satu per satu.
- Reseller white label yang ingin mengotomatiskan pembuatan kotak untuk setiap klien baru, menjaga konfigurasi tetap standar.
- Operasi yang memigrasikan atau mereplikasi konfigurasi antar akun, menggunakan daftar untuk mengaudit dan pembuatan untuk mereplikasi kanal.
- Integrator yang menghubungkan Papo ke sistem eksternal pengelolaan kanal, memastikan lingkungan layanan secara otomatis mencerminkan perubahan.
Pertanyaan yang Sering Diajukan
Apakah saya memerlukan kunci rahasia untuk menampilkan daftar kotak masuk?
Ya. Menampilkan daftar kotak memerlukan autentikasi dengan kunci rahasia akun, karena mengembalikan informasi konfigurasi yang sensitif. Polanya sama dengan panggilan API lainnya: kirim token Bearer di header Authorization.
Bisakah saya membuat kotak masuk untuk WhatsApp via API?
Ya. Saat membuat kotak, Anda menentukan jenis kanal yang diinginkan — termasuk WhatsApp (API resmi Meta) dan kanal lain yang didukung. Payload harus mengikuti format yang diharapkan untuk kanal yang dipilih, sesuai dokumentasi resmi.
Apakah mungkin memperbarui kotak masuk yang sudah ada melalui API?
API saat ini memungkinkan menampilkan daftar dan membuat kotak masuk. Untuk mengubah konfigurasi kotak yang sudah ada (seperti mengganti agen atau mengganti nama), Anda dapat menggunakan panel Papo atau, jika perlu, membuat ulang kotak dengan parameter baru.
Bagaimana cara mengaitkan agen ke kotak selama pembuatan?
Dalam payload pembuatan, Anda dapat menyertakan pengenal agen yang harus memiliki akses ke kotak. ID tersebut dapat diperoleh melalui API tim dan anggota. Lihat dokumentasi untuk format pastinya.
Apakah autentikasinya sama dengan yang digunakan di endpoint Papo lainnya?
Ya. Semua panggilan yang mengakses sumber daya akun menggunakan kunci rahasia sebagai token Bearer. Kunci publik bersifat opsional dan, jika dikirim, harus sesuai dengan akun yang sama.
Di mana saya dapat menemukan jalur pasti dan format payload?
Dalam dokumentasi resmi API, tersedia di https://papo.global/pt/docs. Di sana terdapat detail autentikasi, parameter, respons, dan contoh kode untuk kotak masuk dan sumber daya lainnya.
Baca juga
- Cara menggunakan API Papo untuk mengelola tim dan anggota
- Cara menggunakan API Papo untuk membuat dan mengelola label (tag)
Mulai otomatiskan koneksi Anda sekarang juga →
Buat akun gratis dan integrasikan kanal via API tanpa membuka panel.