**Untuk membuat tugas secara otomatis di modul Projetos Papo (https://papo.global/) dari peristiwa eksternal — seperti peluang yang bergerak maju di funnel Kanban — Anda dapat menggunakan API platform bersama alat otomasi seperti n8n atau Zapier. API memungkinkan Anda menanyakan kartu CRM dan menghasilkan tugas di proyek secara programatik, sehingga menghilangkan kebutuhan transfer manual antara penjualan dan operasi.**

Mengintegrasikan pipeline penjualan dengan eksekusi pengiriman adalah salah satu hambatan utama operasi B2B. Saat kartu peluang dipindahkan ke “Menang” atau mencapai tahap tertentu, serangkaian tindakan perlu dipicu: onboarding, konfigurasi, pengiriman materi. Dengan API Papo, Anda dapat mengorkestrasi transisi ini tanpa intervensi manusia, memastikan setiap penjualan yang ditutup otomatis menghasilkan tugas di proyek yang tepat, dengan penanggung jawab dan tenggat yang ditentukan.

## Ringkasan alur otomasi via API

| Tahap | Aksi | Deskripsi |
| :--- | :--- | :--- |
| **1. Autentikasi** | Buat kunci API di panel Papo | Kredensial untuk mengotorisasi panggilan eksternal. |
| **2. Pemantauan funnel** | Kueri endpoint kartu Kanban | Identifikasi peluang yang berubah status (mis.: lead_status=won). |
| **3. Pembuatan tugas** | Panggil endpoint pembuatan tugas di Projetos | Buat kartu di papan Kanban proyek, menautkan kontak dan data penjualan. |
| **4. Eksekusi** | Tim operasional melihat tugas di modul Projetos | Pengiriman mengikuti alur normal, dengan keterlacakan penuh. |

## Cara kerja pembuatan tugas via API

API Papo menyediakan endpoint untuk modul Kanban dan Projetos. Dengan menggabungkan panggilan tersebut, Anda membangun jembatan otomatis antara CRM dan manajemen pengiriman.

### 1. Dapatkan kunci API Anda

Sebelum integrasi apa pun, akses panel Papo, buka bagian **Pengembang** (atau **API**) dan buat kunci rahasia (`sk_live_...`). Kunci ini akan digunakan di header `Authorization: Bearer sk_live_...` untuk semua permintaan. Kunci publik (`pk_live_...`) mengidentifikasi akun Anda, tetapi autentikasi bergantung pada kunci rahasia. Simpan di tempat aman — kunci ini tidak akan ditampilkan lagi.

### 2. Pantau kartu Kanban

Langkah pertama otomasi adalah mendeteksi saat peluang bergerak maju di funnel. API Kanban memungkinkan Anda membuat daftar kartu dengan filter berdasarkan status. Misalnya, Anda dapat:

- Secara berkala menanyakan semua kartu dengan `lead_status=won` (peluang menang) yang belum menghasilkan tugas.
- Atau, jika alat otomasi Anda mendukung, bereaksi terhadap webhook pembaruan kartu (periksa dokumentasi resmi apakah ada event yang tersedia).

Dengan skrip atau workflow di n8n/Zapier, Anda menjadwalkan kueri ke endpoint daftar kartu, memfilter hasilnya, dan memicu pembuatan tugas hanya untuk kartu yang memenuhi kriteria.

### 3. Buat tugas di Projeto

Dengan data kartu (kontak, judul peluang, nilai, dll.), Anda melakukan panggilan ke endpoint pembuatan tugas di Projetos. Parameter umum meliputi:

- **project_id**: pengenal proyek tujuan (mis.: “Onboarding” atau “Pengiriman purnajual”).
- **title**: judul tugas, yang dapat disusun dari nama kontak dan peluang.
- **description**: ringkasan konteks, diambil dari kartu.
- **priority**: mendesak, tinggi, sedang, atau rendah.
- **due_date**: tenggat yang dihitung, misalnya, 5 hari setelah penutupan.
- **assignee**: penanggung jawab eksekusi (bisa tetap atau ditentukan oleh aturan).

Respons API mengonfirmasi pembuatan dan mengembalikan ID tugas. Setelah itu, tugas muncul di papan Kanban proyek yang dipilih, siap untuk tim operasional.

### 4. Pantau eksekusi

Setelah dibuat, tugas mengikuti siklus normal modul Projetos: tim memindahkan kartu antar kolom, menambahkan komentar, dan menandai penyelesaian. Tenaga penjualan atau manajer dapat memeriksa kemajuan tanpa harus keluar dari CRM, karena Papo menjaga keterlacakan antara peluang asli dan pengiriman.

## Contoh praktis dengan n8n (konseptual)

Meskipun detail implementasi bergantung pada dokumentasi resmi API (tersedia di **papo.global/pt/docs**), alur logis di alat seperti n8n adalah:

1. **Node Cron**: memicu setiap 15 menit.
2. **Node HTTP Request (Papo API)**: GET ke endpoint daftar kartu Kanban, memfilter berdasarkan `lead_status=won` dan tanggal penutupan terbaru.
3. **Node IF**: memeriksa apakah ada kartu baru (belum diproses).
4. **Node HTTP Request (Papo API)**: POST ke endpoint pembuatan tugas, menggunakan data kartu.
5. **Node pembaruan** (opsional): menandai kartu asli dengan tag atau bidang khusus untuk menghindari duplikasi.

Logika yang sama berlaku untuk Zapier, Make, atau skrip Python/JavaScript.

## Untuk siapa integrasi ini direkomendasikan

- **Operasi B2B dengan siklus penjualan konsultatif**, di mana penutupan wajib memicu pengiriman teknis atau onboarding.
- **Perusahaan yang sudah menggunakan Kanban dan Projetos dari Papo** dan ingin menghilangkan transfer informasi manual antar tim.
- **Tim CS dan implementasi** yang menerima puluhan klien baru per minggu dan membutuhkan alur yang terstandarisasi.
- **Reseller white label** yang ingin menawarkan otomasi lanjutan kepada klien mereka, mengintegrasikan CRM dengan sistem manajemen proyek eksternal.

## Pertanyaan yang sering diajukan

### ### Apakah saya perlu webhook untuk mendeteksi perubahan di Kanban?
API Papo menyediakan endpoint untuk kueri kartu. Jika dokumentasi resmi menyertakan webhook, Anda dapat menggunakannya untuk menerima notifikasi real-time. Jika tidak, kueri berkala (polling) adalah alternatif yang layak dan banyak digunakan.

### ### Bisakah saya membuat tugas di proyek mana pun via API?
Ya. Selama Anda memiliki ID proyek aktif, endpoint pembuatan tugas memungkinkan Anda menentukan proyek tujuan. Anda dapat memisahkan proyek untuk berbagai jenis pengiriman (mis.: “Onboarding”, “Dukungan teknis”, “Kustomisasi”).

### ### Apakah tugas yang dibuat via API mewarisi kontak dari peluang?
Ya. Saat menyusun permintaan, Anda dapat menautkan kontak yang terkait dengan kartu Kanban. Dengan begitu, tim operasional mengakses riwayat percakapan dan data klien langsung di tugas.

### ### Apakah mungkin menentukan penanggung jawab secara otomatis?
Ya. Endpoint pembuatan tugas menerima bidang penanggung jawab (assignee). Anda dapat menetapkan nilai tetap, menggunakan logika round-robin, atau berdasarkan properti kartu, seperti tenaga penjualan yang bertanggung jawab.

### ### Bagaimana cara menghindari pembuatan tugas duplikat?
Disarankan menyimpan kontrol eksternal (basis data, spreadsheet, atau bidang khusus di kartu) untuk mencatat peluang mana yang sudah menghasilkan tugas. Sebelum membuat yang baru, alur memeriksa apakah kartu tersebut sudah diproses.

### ### Di mana saya dapat menemukan daftar lengkap endpoint?
Dokumentasi teknis terperinci, dengan semua endpoint, parameter, dan contoh kode, tersedia secara publik di **papo.global/pt/docs**.

## Baca juga

- [Cara menggunakan API Papo untuk membuat daftar percakapan dan mengirim pesan secara programatik](/hc/papo/articles/cara-menggunakan-api-papo-untuk-daftar-percakapan-dan-kirim-pesan)
- [Otomasi di Papo: Aturan, Makro, Flow, dan Webhook – mana yang harus digunakan?](/hc/papo/articles/automasi-papo-regras-macros-flows-dan-webhooks-mana-yang-digunakan)

---

**[Mulai gratis →](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)**

Dengan paket gratis Papo, Anda sudah dapat membuat kunci API dan menguji otomasi tugas antara Kanban dan Projetos.