Dengan API REST Papo, Anda dapat menampilkan, mencari, membuat, memperbarui, dan menautkan kontak ke Perusahaan di CRM — semuanya melalui permintaan terautentikasi, tanpa membuka panel. Ini adalah cara programatik untuk menjaga pengelolaan klien B2B tetap tersinkronisasi dengan sistem eksternal, ERP, CRM, atau alat otomatisasi.
API Papo mengekspos sumber daya modul Perusahaan agar operasi Anda dapat mengatur akun B2B, mengonsolidasikan kontak yang tertaut, dan memantau percakapan terbaru setiap perusahaan. Dengan autentikasi kunci rahasia dan respons JSON, endpoint ini memungkinkan Anda mengintegrasikan visi akun ke skrip, otomatisasi, dan reseller white label.
Ringkasan operasi Perusahaan via API
| Operasi | Apa yang dilakukan | Kapan digunakan |
|---|---|---|
| Menampilkan perusahaan | Mengembalikan perusahaan yang terdaftar di CRM dengan nama, domain, dan jumlah kontak. | Mengaudit basis akun atau menyinkronkan perusahaan dengan sistem lain. |
| Cari berdasarkan nama atau domain | Menemukan perusahaan tertentu di CRM. | Menemukan akun B2B sebelum memperbarui data atau menautkan kontak. |
| Detail perusahaan | Mengembalikan data perusahaan berdasarkan pengenal. | Mengonsultasikan akun tertentu selama integrasi. |
| Membuat perusahaan | Membuat perusahaan baru; nama wajib diisi, sedangkan domain dan deskripsi bersifat opsional. | Mendaftarkan akun B2B secara otomatis dari ERP, situs web, atau alur eksternal. |
| Memperbarui perusahaan | Memperbarui nama, domain, dan deskripsi perusahaan yang ada. | Menjaga CRM selalu selaras dengan basis klien B2B. |
| Menautkan kontak | Menautkan kontak yang sudah ada di CRM ke perusahaan. | Mengonsolidasikan hubungan dan riwayat antara kontak dan akun. |
| Menampilkan kontak dan percakapan | Menampilkan kontak yang tertaut ke perusahaan dan percakapan terbaru kontak tersebut. | Mendapatkan visi lengkap akun selama layanan atau tindak lanjut. |
Bagaimana autentikasi API bekerja
Semua rute penulisan, termasuk operasi Perusahaan, memerlukan kunci rahasia akun. Kunci ini harus dikirim sebagai token Bearer. 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 aman dan cabut jika ada kecurigaan kebocoran.
Karena API bersifat REST dan menggunakan JSON, bahasa apa pun yang mendukung HTTP dapat digunakan untuk mengintegrasikan Perusahaan ke skrip, ERP, CRM, atau alat otomatisasi. Dokumentasi resmi di https://papo.global/pt/docs menyediakan detail autentikasi, parameter, respons, dan contoh kode.
Cara mengelola Perusahaan melalui API dalam praktik
- Akses area pengembang panel Papo dan buat kunci rahasia. Salin juga kunci publik akun.
- Pada setiap permintaan, autentikasi dengan kunci rahasia sebagai token Bearer. Jika ingin memperkuat validasi, kirim kunci publik di header yang ditunjukkan dalam dokumentasi.
- Untuk menampilkan perusahaan di CRM, panggil endpoint daftar Perusahaan. Responsnya berisi nama, domain, dan jumlah kontak setiap akun.
- Untuk menemukan perusahaan tertentu, gunakan endpoint pencarian berdasarkan nama atau domain. Dengan begitu Anda mendapatkan pengenal yang diperlukan untuk memperbarui data atau menautkan kontak.
- Untuk membuat perusahaan, kirim payload JSON dengan nama wajib. Domain dan deskripsi dapat disertakan sebagai data opsional.
- Untuk memperbarui perusahaan, kirim nilai baru nama, domain, atau deskripsi di endpoint pembaruan.
- Untuk menautkan kontak yang sudah ada, gunakan pengenal kontak dan pengenal perusahaan dalam operasi penautan.
Karena API memproses satu operasi per permintaan, pengelolaan massal dilakukan dengan menjalankan panggilan secara berurutan. Skrip Python, Node.js, atau otomatisasi di alat seperti n8n dapat membaca akun dari CSV atau ERP, mendaftarkan perusahaan, menautkan kontak, dan mengumpulkan respons untuk penanganan kesalahan.
Untuk siapa integrasi ini masuk akal
- Perusahaan B2B yang menyimpan akun di CRM atau ERP lain dan ingin menyinkronkan secara otomatis dengan modul Perusahaan Papo.
- Tim komersial yang menangani klien akun, seperti agensi, konsultan, SaaS, dan penyedia, serta perlu mengonsolidasikan kontak dan percakapan per perusahaan.
- Operasi yang menangkap perusahaan dari formulir, landing page, atau sistem eksternal dan ingin membuatnya di CRM tanpa kerja manual berulang.
- Reseller white label dan integrator yang menghubungkan Papo ke sistem klien dan ingin menjaga pengelolaan akun tetap konsisten di berbagai lingkungan.
- Tim TI yang membangun integrasi kustom menggunakan API sebagai jembatan antara basis perusahaan dan bagian lain dari operasi.
Pertanyaan yang sering diajukan
Apakah saya perlu membuat kontak sebelum menautkannya ke Perusahaan?
Ya. API menautkan kontak yang sudah ada di CRM. Untuk mendaftarkan kontak baru, gunakan endpoint pembuatan kontak lalu lakukan penautan dengan perusahaan.
Data apa saja yang dapat saya perbarui pada Perusahaan via API?
Anda dapat memperbarui nama, domain, dan deskripsi perusahaan. Pembuatan memerlukan nama; domain dan deskripsi bersifat opsional.
Apakah API memungkinkan menampilkan percakapan suatu Perusahaan?
Ya. Modul Perusahaan memungkinkan Anda menampilkan kontak yang tertaut ke perusahaan dan percakapan terbaru kontak tersebut, memudahkan visi akun selama layanan.
Apakah autentikasinya sama dengan yang digunakan di endpoint Papo lainnya?
Ya. Rute penulisan memerlukan kunci rahasia akun, dikirim sebagai token Bearer. Kunci publik bersifat opsional dan, jika dikirim, harus sesuai dengan akun yang sama.
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 Perusahaan dan sumber daya lainnya.
Bisakah saya menggunakan API untuk menyinkronkan basis Perusahaan dengan CRM saya saat ini?
Ya. Karena API bersifat REST dan menggunakan JSON, Anda dapat mengotomatiskan penampilan, pembuatan, pembaruan, dan penautan kontak secara berurutan, menjaga kedua sistem tetap selaras.
Baca juga
- Cara menggunakan modul Perusahaan di CRM Papo
- Cara menggunakan API Papo untuk mengelola atribut kustom kontak
Mulai gratis dan kelola Perusahaan di CRM via API →
Pengguna pertama Papo gratis selamanya, tanpa kartu.