Dengan API REST dari Papo, Anda dapat mengotomatiskan administrasi tim tanpa membuka panel: mendaftar tim, membuat tim, mendaftar anggota tim, menambahkan pengguna ke tim, dan mendaftar atau membuat kotak masuk. Ini adalah cara programatik untuk menjaga struktur layanan tetap sinkron dengan sistem eksternal, operasi besar, dan reseller white label.
API Papo mengekspos sumber daya tim dan kotak masuk dengan autentikasi yang sama seperti endpoint platform lainnya. Dengan ini, tim Anda dapat menyediakan struktur baru, mengaudit siapa yang menjadi bagian dari setiap grup, dan mempersiapkan perutean percakapan tanpa intervensi manual di panel.
Ringkasan operasi tim dan anggota via API
| Operasi | Apa yang dilakukan | Kapan digunakan |
|---|---|---|
| Mendaftar tim | Mengembalikan tim yang terdaftar di akun. | Mengaudit struktur sebelum membuat tim baru. |
| Membuat tim | Membuat tim dengan nama dan deskripsi opsional. | Menyediakan tim baru melalui skrip, ERP, atau CRM. |
| Mendaftar anggota tim | Mengembalikan pengguna yang menjadi bagian dari tim tersebut. | Memeriksa siapa yang termasuk dan menghindari akses yang salah. |
| Menambahkan pengguna ke tim | Menyertakan satu atau lebih pengguna dengan memberikan ID yang dipisahkan koma. | Menyinkronkan tim dengan daftar agen saat ini. |
| Mendaftar kotak masuk | Mengembalikan kotak masuk dengan saluran, dalam tampilan administrator. | Memeriksa saluran yang tersedia dan bagaimana mereka diatur. |
| Membuat kotak masuk | Membuat kotak masuk baru. | Menyediakan saluran baru bersama dengan struktur tim. |
Bagaimana autentikasi API bekerja
Operasi tulis, termasuk untuk tim dan anggota, memerlukan kunci rahasia akun. Kunci ini harus dikirim sebagai token Bearer di header otorisasi. 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 hanya muncul sekali saat pembuatan; simpan di tempat yang aman dan cabut jika ada kecurigaan kebocoran.
Langkah demi langkah untuk mengelola tim dan anggota via API
- Akses area pengembang/API di panel Papo dan buat kunci rahasia. Salin juga kunci publik akun jika Anda ingin validasi tambahan.
- Di setiap permintaan, autentikasi dengan kunci rahasia sebagai token Bearer. Jika memperkuat validasi, kirim kunci publik di header yang ditunjukkan dalam dokumentasi.
- Daftar tim yang ada untuk memetakan struktur saat ini sebelum membuat yang baru.
- Buat tim dengan mengirim payload JSON dengan nama dan, jika perlu, deskripsi. Konsultasikan dokumentasi resmi untuk format yang tepat.
- Daftar anggota tim untuk mengaudit siapa yang sudah termasuk dan menghindari duplikasi.
- Tambahkan pengguna ke tim dengan memberikan ID yang dipisahkan koma. Langkah ini menyinkronkan tim dengan daftar agen saat ini.
- Daftar kotak masuk dengan tampilan administrator untuk memeriksa saluran yang ada dan gunakan API juga untuk membuat kotak masuk bila diperlukan.
Karena API ini REST dan menggunakan JSON, bahasa apa pun yang mendukung HTTP dapat digunakan untuk mengintegrasikan tim dan anggota ke skrip, ERP, CRM, atau alat otomatisasi. Dokumentasi resmi di https://papo.global/pt/docs memberikan detail autentikasi, parameter, respons, dan contoh kode.
Untuk siapa integrasi ini masuk akal
- Operasi besar yang perlu membuat dan menyesuaikan tim secara sering tanpa membuka panel secara manual.
- Tim TI dan otomatisasi yang menyinkronkan struktur agen dengan direktori, HR, atau sistem internal.
- Reseller white label yang menyediakan akun klien secara standar, menggunakan kembali logika tim dan kotak masuk yang sama.
- Perusahaan yang sudah menggunakan API Papo untuk kontak dan percakapan dan ingin melengkapi alur dengan administrasi tim.
API mengelola struktur tim dan penambahan anggota. Peran pengguna, seperti Agen atau Administrator, dan izin granular tetap ditentukan di panel. Dengan menambahkan pengguna ke tim dan menghubungkannya ke kotak masuk yang relevan, Anda mengontrol akses operasional ke percakapan.
Pertanyaan yang sering diajukan
Apakah API Papo menentukan peran pengguna, seperti Agen atau Administrator?
Tidak. API tim dan anggota berfokus pada pembuatan tim, pendaftaran anggota, dan penambahan pengguna. Penentuan peran dan izin setiap pengguna dilakukan di panel. Dengan menyertakan pengguna dalam tim dan kotak masuk yang benar, Anda membatasi akses ke percakapan operasional.
Bisakah saya membuat tim tanpa menambahkan anggota pada langkah yang sama?
Ya. API memungkinkan pembuatan tim dengan nama dan deskripsi opsional, tanpa menyertakan pengguna segera. Setelah itu, Anda dapat menambahkan anggota menggunakan operasi penambahan massal.
Bagaimana API mengidentifikasi akun dalam permintaan?
Melalui kunci rahasia yang dikirim sebagai token Bearer. Kunci publik bersifat opsional dan, jika dikirim, harus sesuai dengan akun yang sama dengan kunci rahasia.
Apakah API ini berfungsi untuk reseller white label?
Ya. Reseller dapat menggunakan API untuk menyediakan tim dan anggota di akun klien secara standar, mengurangi konfigurasi manual dan menjaga konsistensi antar operasi.
Di mana saya dapat menemukan jalur yang tepat dan format payload?
Di dokumentasi resmi API, tersedia di https://papo.global/pt/docs. Di sana terdapat detail autentikasi, parameter, respons, dan contoh kode untuk tim, anggota, dan sumber daya lainnya.
Baca juga
- Cara menggunakan API Papo untuk membuat dan mengelola tag (label)
- Cara mengelola pengguna dan izin di dalam platform white label Anda
Mulai gratis dan otomatiskan tim dan anggota via API →
Pengguna pertama gratis selamanya, jadi Anda dapat memvalidasi integrasi sebelum menyusun operasi Anda.