Untuk mulai menggunakan API Papo Global (https://papo.global/), Anda perlu membuat kunci rahasia di panel, mengautentikasi permintaan dengan header Authorization, dan melakukan panggilan REST ke base https://app.papo.global/api/v1. Uji praktis pertama adalah menampilkan kontak dari Extrator dengan perintah cURL sederhana.
API Papo bersifat REST, menggunakan JSON, dan menerima permintaan dari origin mana pun (CORS diaktifkan). Dengan API ini, Anda menghubungkan CRM, platform otomasi (seperti n8n), ERP, atau backend Anda sendiri ke ekosistem layanan pelanggan, penjualan, dan AI Papo.
Ringkasan elemen penting
| Elemen | Deskripsi |
|---|---|
Kunci publik (pk_live_…) |
Pengenal tetap akun Anda, dapat ditampilkan di front-end |
Kunci rahasia (sk_live_…) |
Token autentikasi, harus dirahasiakan dan hanya digunakan di server |
| Autentikasi | Header Authorization: Bearer sk_live_... (atau X-Papo-Secret-Key) di semua panggilan kecuali GET /api/v1 |
| Base URL | https://app.papo.global/api/v1 |
| Endpoint contoh | GET /api/v1/contacts — menampilkan kontak yang diekstrak (Extrator), dengan paginasi |
Langkah demi langkah untuk panggilan pertama
1. Buat kunci API Anda
Buka halaman developer di panel Papo (tersedia di app.papo.global/developers). Di sana Anda dapat membuat kunci rahasia bernama — misalnya, “primeiro-teste” — dan segera menyalinnya. Kunci ditampilkan satu kali saja; setelah itu Anda hanya dapat mencabutnya dan membuat yang baru.
Kunci publik (pk_live_…) bersifat tetap per akun dan terlihat di halaman yang sama kapan saja. Meskipun opsional dalam permintaan, jika Anda mengirimkannya, kunci tersebut harus terkait dengan akun yang sama dengan kunci rahasia.
2. Pilih endpoint
Untuk panduan ini, kita akan menggunakan GET /api/v1/contacts, yang menampilkan lead yang diekstrak oleh modul Extrator. Anda dapat melakukan paginasi hasil dengan parameter page (default 1) dan per_page (1 hingga 100, default 20). Kueri teks dengan q juga diterima untuk mencari berdasarkan perusahaan, telepon, atau email.
3. Lakukan panggilan dengan cURL
Dengan kunci rahasia di tangan, susun permintaan. Contoh berikut menampilkan hingga 20 kontak:
curl "https://app.papo.global/api/v1/contacts?page=1&per_page=20" \
-H "Authorization: Bearer sk_live_…"
Ganti sk_live_… dengan kunci rahasia Anda. Jika ingin menggunakan header alternatif, lakukan:
curl "https://app.papo.global/api/v1/contacts" \
-H "X-Papo-Secret-Key: sk_live_…"
Responsnya adalah JSON dengan success: true dan data di dalam objek data. Jika terjadi error, JSON akan membawa success: false dan objek error dengan kode dan pesan penjelasan.
Dari sini, Anda dapat menjelajahi endpoint lain yang didokumentasikan di halaman API, seperti pengiriman pesan (POST /api/v1/messages), detail akun (GET /api/v1/me), atau melengkapi teks dengan AI (POST /api/ai/v1/complete).
Untuk siapa panduan ini
Konten ini ditujukan untuk developer yang ingin mengintegrasikan Papo dengan sistem eksternal — CRM, alat otomasi (misalnya n8n), atau aplikasi sendiri. Jika Anda adalah pengguna akhir yang hanya ingin menghubungkan kanal dan melayani, Pusat Bantuan menawarkan artikel lain yang lebih sesuai.
Pertanyaan umum
Apakah saya perlu mengirim kunci publik di semua panggilan?
Tidak. Kunci publik bersifat opsional. Jika Anda memilih untuk mengirimkannya, kunci tersebut harus cocok dengan akun kunci rahasia yang digunakan.
Apakah kunci rahasia kedaluwarsa?
Tidak kedaluwarsa secara otomatis. Anda dapat mencabutnya kapan saja melalui panel dan membuat yang baru, jika mencurigai kebocoran.
Bisakah saya menguji API dengan akun gratis?
Ya. Pengguna pertama Papo gratis dan Anda dapat membuat kunci untuk menjelajahi API. Akses ke modul seperti Extrator dapat menghabiskan saldo sesuai penggunaan, tetapi pembuatan kunci dan panggilan baca dasar dapat diuji tanpa biaya tambahan.
Apa yang harus dilakukan jika saya kehilangan kunci rahasia?
Buat kunci bernama baru di panel developer. Kunci sebelumnya tidak dapat dipulihkan; hanya dapat dicabut demi keamanan.
Bisakah saya menggunakan API untuk mengirim pesan massal?
Ya, endpoint POST /api/v1/messages memungkinkan pengiriman pesan teks. Namun, patuhi kebijakan persetujuan dan ketentuan penggunaan platform.
Apakah API hanya menampilkan kontak dari Extrator?
Endpoint GET /api/v1/contacts mengembalikan kontak yang diekstrak. Untuk mengelola basis CRM terpadu (mencari, membuat, dan memperbarui kontak apa pun), Anda dapat merujuk ke dokumentasi lengkap API.
Baca juga: Cara menggunakan API Papo untuk membuat formulir pendaftaran dan mengisi CRM secara otomatis · Cara menggunakan API Papo untuk memantau konsumsi kredit dan faktur reseller white label
Pengguna pertama R$ 0, tanpa kartu. Pelajari lebih lanjut di papo.global.