**Untuk membuat dan memperbarui peluang di Kanban secara programatik, gunakan API REST [Papo](https://papo.global/). Dengan autentikasi menggunakan kunci rahasia (Bearer token) dan kunci publik akun, Anda dapat mengirim permintaan yang membuat kartu, memindahkan peluang antar tahap, dan menandai hasil, mengintegrasikan funnel penjualan dengan sistem eksternal tanpa intervensi manual.**

API Papo menyediakan operasi penulisan untuk Kanban, memungkinkan Anda bekerja dengan funnel, tahap, dan kartu CRM. Ini memungkinkan sinkronisasi ERP, landing page, atau alat pembayaran dengan funnel penjualan, menjaga peluang selalu diperbarui.

## Ringkasan integrasi dengan Kanban

| Tahap | Tindakan | Detail penting |
| :--- | :--- | :--- |
| 1. Dapatkan kunci | Buat kunci rahasia (`sk_live_…`) dan salin kunci publik (`pk_live_…`) di panel Papo. | Kunci rahasia hanya muncul sekali; simpan di tempat aman. |
| 2. Autentikasi panggilan | Sertakan header `Authorization: Bearer sk_live_…` di semua permintaan penulisan. | Kunci publik dapat dikirim di header `X-Papo-Public-Key` (opsional). |
| 3. Kenali funnel dan tahap | Daftar funnel Kanban dan tahapnya untuk mendapatkan pengidentifikasi yang diperlukan. | Respons API menyertakan pengidentifikasi yang digunakan dalam panggilan berikutnya. |
| 4. Buat atau pindahkan kartu | Kirim operasi untuk membuat kartu di suatu tahap, memindahkan kartu dari kontak ke tahap lain, atau menandai hasil. | Setiap operasi memproses satu tindakan; untuk banyak catatan, otomatiskan pengiriman dalam loop. |
| 5. Validasi respons | API mengembalikan `success: true` dan data kartu atau daftar. | Jika terjadi kesalahan, body respons menyertakan kode dan pesan untuk perbaikan. |

## Apa yang dapat dilakukan API di Kanban

Dengan endpoint Kanban, Anda dapat secara programatik:

- Daftar funnel yang tersedia dan tahapnya, dengan nama dan posisi.
- Daftar kartu CRM.
- Daftar semua kartu yang menang, untuk laporan penjualan yang berhasil.
- Buat kartu di suatu tahap, opsional terkait dengan kontak yang ada.
- Pindahkan kartu dari kontak ke tahap lain di funnel.
- Tandai kartu sebagai menang atau kalah.
- Buat funnel Kanban dengan tahap standar atau kustom.

Operasi ini memungkinkan funnel secara otomatis mencerminkan apa yang terjadi di luar Papo, seperti pembelian yang dikonfirmasi, rapat yang dijadwalkan, atau pendaftaran dari situs web.

## Cara kerja autentikasi dan panggilan

Setiap panggilan yang memodifikasi data memerlukan **kunci rahasia** akun. Ini harus dikirim sebagai token Bearer di header `Authorization` atau, sebagai alternatif, di header `X-Papo-Secret-Key`. **Kunci publik** dapat menyertai permintaan di header `X-Papo-Public-Key`; penggunaannya opsional, tetapi jika dikirim, harus sesuai dengan akun yang sama dengan kunci rahasia.

URL dasar API adalah `https://app.papo.global/api/v1`. Dari sana, endpoint Kanban menerima kata kerja HTTP yang sesuai untuk membuat, memindahkan, memperbarui, dan mendaftar. Karena dokumentasi lengkap merinci path, parameter, dan bidang yang diterima, kami merekomendasikan untuk merujuk ke [referensi resmi API](https://papo.global/pt/docs) sebelum coding.

Untuk memvalidasi bahwa kunci Anda berfungsi, Anda dapat memanggil endpoint `GET /api/v1/me`, yang mengembalikan data akun. Pola autentikasi sama dengan yang digunakan di endpoint lain:

```
curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_…" \
  -H "X-Papo-Public-Key: pk_live_…"
```

Respons yang berhasil mencakup `success: true` dan objek `data` dengan informasi akun.

## Alur integrasi tipikal dengan sistem eksternal

Skrip dalam Python, Node.js, atau otomasi di alat seperti n8n dapat menjalankan siklus lengkap funnel:

1. Daftar funnel dan tahap untuk mendapatkan pengidentifikasi setiap kolom.
2. Buat kartu di tahap awal, terkait dengan kontak jika perlu.
3. Pindahkan kartu ke tahap baru ketika peristiwa eksternal terjadi — misalnya, pembayaran dikonfirmasi atau rapat dijadwalkan.
4. Tandai kartu sebagai menang atau kalah ketika peluang selesai.
5. Daftar kartu yang menang untuk memberi masukan ke laporan, dasbor, atau sistem BI.

Karena API adalah REST dan menggunakan JSON, bahasa apa pun dengan dukungan HTTP berfungsi. Detail payload dan bidang untuk setiap operasi ada di dokumentasi resmi.

## Untuk siapa integrasi ini direkomendasikan

- **Perusahaan yang menangkap peluang di sistem eksternal**, seperti landing page, ERP, atau e-commerce, dan ingin agar mereka secara otomatis masuk ke funnel Papo.
- **Operasi yang perlu memindahkan kartu sesuai peristiwa pembayaran**, seperti gateway atau platform penagihan, tanpa membuka CRM secara manual.
- **Tim BI dan data** yang ingin menarik kartu menang dan nilai ke dasbor secara real-time.
- **Tim TI yang membangun integrasi kustom** antara Papo dan alat internal, menggunakan API sebagai jembatan antara funnel penjualan dan sisa operasi.

## Pertanyaan yang Sering Diajukan

### Apakah saya perlu menggunakan kunci publik di setiap panggilan?
Tidak. Kunci publik bersifat opsional, tetapi jika dikirim di header `X-Papo-Public-Key`, harus sesuai dengan akun yang sama dengan kunci rahasia.

### Bagaimana saya tahu tahap apa yang ada di funnel saya?
Daftar funnel Kanban melalui API. Respons mengembalikan tahap setiap funnel dengan pengidentifikasinya, yang digunakan untuk membuat atau memindahkan kartu.

### Dapatkah saya membuat kartu yang sudah terkait dengan kontak?
Ya. Pembuatan kartu memungkinkan untuk secara opsional terkait dengan kontak yang ada, menjaga riwayat dan data pelanggan terkait dengan peluang.

### Apakah API memungkinkan memperbarui nilai kartu?
API menyediakan operasi penulisan untuk kartu Kanban. Bidang tepat yang dapat diperbarui, termasuk nilai, dijelaskan secara rinci dalam dokumentasi resmi API.

### Apakah mungkin menandai kartu sebagai menang atau kalah melalui API?
Ya. API memungkinkan menandai kartu sebagai menang dan kalah, serta mendaftar semua kartu menang untuk laporan dan dasbor.

### Apakah saya perlu coding atau bisa menggunakan alat otomasi?
Anda dapat menggunakan bahasa apa pun dengan dukungan HTTP atau alat otomasi seperti n8n, menjalankan panggilan secara berurutan sesuai alur yang diinginkan.

## Baca juga

- Cara menggunakan API Papo untuk membuat dan memperbarui kontak secara massal
- [Cara menerima peristiwa real-time dari Papo via Webhook (outbound)](/hc/papo/articles/cara-menerima-acara-waktu-nyata-dari-papo-melalui-webhook-outbound)

---

**[Mulai gratis →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=cara-menggunakan-api-papo-untuk-membuat-dan-memperbarui-peluang-di-kanban&utm_content=id)**

Pengguna pertama gratis dan tidak memerlukan kartu kredit.