**Dengan API REST [Papo](https://papo.global/), Anda dapat menampilkan daftar semua Flow yang tersedia di akun Anda, mengaktifkan atau menonaktifkan perjalanan, dan mendaftarkan kontak ke otomasi secara programatik — semuanya melalui permintaan terautentikasi, tanpa membuka panel. Inilah cara mengintegrasikan mesin Flow dengan sistem eksternal, alur kerja n8n, CRM, atau skrip internal.**

API Papo menyediakan fitur Flow yang memungkinkan Anda mengelola otomasi seperti Anda mengelola kotak masuk atau kontak. Dengan API ini, tim pengembang, integrator, dan reseller white label dapat mengontrol secara massal perjalanan mana yang aktif, memulai kontak dalam urutan, dan menyinkronkan status otomasi dengan proses bisnis.

## Ringkasan Operasi Flow via API

| Operasi | Deskripsi | Contoh Penggunaan |
| :--- | :--- | :--- |
| Menampilkan daftar Flow | Mengembalikan Flow dan urutan yang tersedia, dengan pengenal, nama, tipe, dan status (Aktif/Nonaktif). | Mengaudit otomasi, menyinkronkan dengan dasbor eksternal, atau memeriksa apa yang sedang berjalan. |
| Mengaktifkan/menonaktifkan Flow | Mengubah status Flow tertentu, membuka atau menjeda penerimaan dan pemrosesan kontak. | Menjeda perjalanan selama pemeliharaan, membuka setelah penyesuaian, atau menonaktifkan kampanye yang sudah berakhir. |
| Mendaftarkan kontak | Memasukkan kontak yang ada ke awal Flow aktif, memulai perjalanan yang dikonfigurasi. | Menyertakan lead dari CRM eksternal, memicu alur selamat datang setelah integrasi, atau memperbaiki entri manual. |

## Cara Kerja Autentikasi API

Semua panggilan ke API, termasuk yang melibatkan Flow, 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 hanya muncul sekali saat pembuatan; simpan di tempat aman dan cabut jika ada kecurigaan kebocoran.

Pola autentikasi sama dengan yang digunakan di semua endpoint:

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

## Mengelola Flow via API dalam Praktik

Meskipun detail persis setiap endpoint dan parameter ada di dokumentasi resmi API, alur kerja umum mengikuti langkah-langkah konseptual berikut:

1. **Autentikasi** dengan kunci rahasia (dan, jika diinginkan, kunci publik) untuk memvalidasi akun.
2. **Tampilkan daftar Flow** untuk mendapatkan daftar perjalanan saat ini, termasuk pengenal dan statusnya. Ini memungkinkan Anda memetakan apa yang sudah ada dan memilih Flow yang tepat untuk operasi berikutnya.
3. **Ubah status** Flow tertentu, jika perlu. Kirim permintaan yang menetapkan Flow sebagai aktif (dibuka untuk menerima kontak) atau nonaktif (dijeda). Hanya Flow aktif yang memproses kontak dan menerima pendaftaran.
4. **Daftarkan kontak** ke Flow aktif. Berikan pengenal kontak dan pengenal Flow yang diinginkan untuk memasukkannya ke awal perjalanan. Riwayat kontak di CRM tetap dipertahankan.
5. **Integrasikan dengan sistem eksternal** — melalui webhook atau panggilan langsung, Anda dapat memulai kontak yang berasal dari formulir eksternal, peristiwa di sistem lain, atau pipeline data.

Platform ini juga mendukung pembuatan Flow kosong dan nonaktif serta pengisian node-nya via API, sehingga memungkinkan untuk menyediakan otomasi lengkap secara programatik. Untuk format payload yang tepat, bidang wajib, dan contoh kode, lihat bagian Flow di dokumentasi API Papo.

## Untuk Siapa Integrasi Ini Cocok

- **Tim TI yang mengoperasikan banyak otomasi** dan perlu menjeda, mengaktifkan kembali, atau memantau Flow secara massal tanpa mengakses panel secara manual.
- **Reseller white label** yang ingin menyediakan journey terstandarisasi untuk setiap klien baru secara otomatis, mendaftarkan kontak awal, dan menjaga keselarasan antar platform.
- **Integrator dan pengembang** yang menghubungkan Papo ke CRM, ERP, atau alat seperti n8n, memicu Flow dari peristiwa eksternal (pembelian, pendaftaran, penjadwalan).
- **Operasi yang bekerja dengan pendaftaran bersyarat**, di mana kontak dimasukkan ke Flow hanya setelah melewati aturan bisnis yang ditentukan di sistem lain.

## Pertanyaan yang Sering Diajukan

### Apakah saya memerlukan kunci rahasia untuk menampilkan daftar Flow?

Ya. Menampilkan daftar Flow, seperti operasi lain yang mengembalikan data akun, memerlukan autentikasi dengan kunci rahasia. Polanya sama dengan semua endpoint lain: kirim token Bearer di header `Authorization`.

### Bisakah saya mengaktifkan atau menonaktifkan Flow melalui API?

Ya. API memungkinkan Anda mengubah status Flow antara aktif dan nonaktif. Anda memerlukan pengenal Flow dan kunci rahasia. Flow nonaktif tidak menerima kontak dan tidak melanjutkan perjalanan, meskipun ada upaya pendaftaran.

### Bagaimana cara mendaftarkan kontak ke Flow via API?

Berikan pengenal kontak dan pengenal Flow aktif pada panggilan pendaftaran. Kontak akan dimasukkan ke awal perjalanan, tanpa menghapus riwayat percakapan atau data profil. Dokumentasi resmi merinci format parameter yang tepat.

### Apakah mungkin membuat Flow dari awal melalui API?

Ya. API memungkinkan Anda membuat Flow kosong (hanya dengan node Start) dan nonaktif, serta mengisi node-nya dengan pertanyaan, pesan, dan kondisi. Ini berguna untuk menyediakan otomasi secara skalabel, terutama dalam skenario reseller atau onboarding klien baru.

### Apakah API mengembalikan status setiap Flow saat menampilkan daftar?

Ya. Daftar ini mencakup status (Aktif atau Nonaktif) setiap Flow dan urutan, serta pengenal, nama, dan tipe, sehingga sistem eksternal dapat memantau apa yang berjalan dan apa yang dijeda.

### Di mana saya dapat menemukan dokumentasi lengkap rute Flow?

Dokumentasi resmi tersedia di [https://papo.global/pt/docs](https://papo.global/pt/docs). Di sana Anda dapat menemukan semua endpoint, parameter yang diterima, kode error, dan contoh dalam berbagai bahasa. Rute Flow mengikuti pola REST dan autentikasi yang sama dengan modul lainnya.

## Baca Juga

- Cara menggunakan API Papo untuk membuat dan memperbarui kontak secara massal
- [Cara menggunakan API Papo untuk membuat dan mengelola label (tag)](/hc/papo/articles/cara-menggunakan-api-papo-untuk-membuat-dan-mengelola-tag)

---

**[Mulai integrasikan Flow Anda sekarang juga →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

Buat akun gratis Papo, akses kunci API, dan hubungkan otomasi Anda dengan dunia luar.