Pipeline Penjualan dan Peluang

Pipeline penjualan adalah papan kanban tempat tim Anda melacak peluang (opportunity) yang sedang dinegosiasikan lewat percakapan. Satu peluang memiliki nama, kontak terkait, nilai, probabilitas menang, dan tahap (stage) di dalam pipeline aktif. Peluang dapat ditautkan ke percakapan sebagai tautan primer atau terkait.

Tujuan

• Melihat dan menyaring seluruh peluang di papan kanban berdasarkan tahap dan hasil (semua/terbuka/menang/kalah).
• Membuat peluang baru, baik dari papan maupun dari dalam percakapan.
• Memindahkan peluang antar-tahap — termasuk menandai Menang (WON) atau Kalah (LOST) dengan alasan.
• Membuka kembali peluang yang sudah ditutup bila diperlukan.
• Menautkan dan melepas tautan peluang–percakapan, serta menetapkan tautan primer.

Untuk siapa

• Agent penjualan: membuat dan memindahkan peluang miliknya.
• Agent dengan cakupan tim: mengelola peluang milik anggota timnya.
• Admin dan owner: mengelola seluruh peluang, pipeline, dan tahap; membuka kembali peluang; melihat nilai penjualan dan mengekspor laporan.
• Viewer: melihat daftar peluang (izin view_opportunities) tanpa kemampuan mengubah.

Prasyarat

• Akun workspace dengan peran yang sudah ditetapkan (lihat Mengelola pengguna, tim, dan inbox).
• Izin yang berlaku sesuai peran (lihat tabel pada bagian Batasan). Tanpa izin, permintaan perubahan ditolak HTTP 403.
• Sudah ada pipeline aktif beserta tahap-tahapnya (dibuat oleh pemilik izin manage_sales_pipelines).
• Peluang baru wajib dimulai pada tahap bertipe terbuka (OPEN).

Alur kerja

1. Membuka papan pipeline

1. Pada bilah navigasi aplikasi web, pilih Pipeline.
2. Papan menampilkan kolom per tahap pipeline aktif; kartu peluang tersusun di kolom tahapnya masing-masing.
3. Gunakan kolom pencarian untuk menyaring peluang, dan pemilih hasil untuk menampilkan semua, hanya terbuka, menang, atau kalah.

Akses seluler (PWA) menampilkan daftar peluang vertikal, bukan papan kanban. Lihat Contacts dan sales di perangkat seluler untuk batasannya.

2. Membuat peluang

1. Dari papan, klik Create opportunity (atau dari panel percakapan, bagian peluang, klik tombol buat).
2. Isi nama peluang dan pilih kontak terkait.
3. Pilih tahap awal — hanya tahap bertipe OPEN yang tersedia.
4. Simpan. Peluang baru tercatat dengan pemilik = pengguna yang membuatnya.

Saat dibuat dari dalam percakapan, sistem otomatis membuat tautan primer ke percakapan tersebut dan menyalin kontaknya.

3. Memindahkan peluang antar-tahap

1. Seret kartu peluang ke kolom tahap tujuan, atau gunakan menu pindah pada detail peluang.
2. Jika tujuan adalah tahap akhir, isi alasan pada dialog konfirmasi:
   • Menuju WON → probabilitas otomatis menjadi 100%.
   • Menuju LOST → alasan kekalahan wajib diisi dan probabilitas otomatis menjadi 0%.
3. Simpan perpindahan. Riwayat perpindahan tercatat (dari tahap, ke tahap, pelaku, alasan).

Setiap perubahan peluang memakai mekanisme versi (expected_version); simpan gagal jika peluang sudah diubah orang lain (HTTP 409). Muat ulang papan lalu ulangi.

4. Menutup dan membuka kembali peluang

1. Menang/kalah dilakukan lewat perpindahan tahap seperti di atas — tidak mengubah status percakapan yang tertaut secara otomatis.
2. Untuk membuka kembali peluang yang sudah WON/LOST, pindahkan kembali ke tahap OPEN dan isi alasan pembukaan kembali. Izin reopen_opportunities diperlukan (admin/owner).
3. Perpindahan terminal ke tahap yang sama (mis. LOST → LOST) tidak memerlukan alasan maupun izin buka kembali.

5. Menautkan peluang dengan percakapan

1. Buka detail peluang atau panel percakapan.
2. Gunakan kontrol tautan untuk menghubungkan peluang dengan percakapan, atau lepas tautan yang tidak relevan.
3. Tetapkan satu tautan sebagai primer bila satu peluang terhubung ke lebih dari satu percakapan. Tautan primer dipakai antarmuka untuk membuka percakapan utama peluang.

Membuka percakapan dari kartu papan mempertahankan konteks papan — tombol kembali mengembalikan Anda ke posisi papan sebelumnya.

6. Melihat nilai dan mengekspor laporan

Lihat Laporan, ekspor, dan CSAT untuk ringkasan nilai pipeline dan ekspor CSV. Nilai peluang hanya tampil bagi pemegang izin view_sales_values; tanpa izin tersebut, nilai ditampilkan nol di seluruh respons.

Tanda berhasil

• Peluang baru muncul di kolom tahap OPEN papan dengan pemilik yang benar.
• Perpindahan tahap langsung mengubah posisi kartu; dialog memaksa pengisian alasan pada perpindahan terminal (LOST) dan pembukaan kembali.
• Riwayat tahap mencatat setiap perpindahan beserta pelaku dan alasan.
• Peluang yang ditautkan dari percakapan menampilkan tautan primer; membuka percakapan dari papan kembali ke papan dengan konteks utuh.

Jika terjadi masalah

Gejala	Penyebab	Pemulihan
403 saat membuat/memindahkan/menghapus peluang	Izin manage_own/manage_team/manage_all_opportunities tidak dimiliki	Hubungi owner workspace untuk penyesuaian peran
403 saat membuka kembali peluang WON/LOST	Izin reopen_opportunities tidak dimiliki	Minta admin/owner memindahkan atau menyesuaikan peran
409 saat menyimpan perubahan	Versi peluang sudah berubah (diedit orang lain)	Muat ulang papan, tinjau nilai terbaru, ulangi
Validasi menolak menuju WON/LOST	Probabilitas tidak 100%/0% atau alasan kosong	Isi alasan; sistem menetapkan probabilitas otomatis
Nilai peluang tampil nol	Pemirsa tidak memiliki view_sales_values	Tidak dapat diubah sendiri; minta akses ke owner
400 VALIDATION_ERROR pada operasi cakupan tim tanpa team_id	Cakupan manage_team butuh pemilihan tim	Pilih tim lebih dulu pada aksi cakupan tim; pada pemanggilan API langsung, sertakan team_id

Batasan

• Peran dan izin (ditegakkan per-permintaan di API):
  • view_opportunities — semua peran termasuk viewer (melihat/mencari daftar peluang).
  • manage_own_opportunities — owner, admin, agent (mengelola peluang milik sendiri).
  • manage_team_opportunities — owner, admin, agent (mengelola peluang tim; butuh team_id pada permintaan).
  • manage_all_opportunities — owner, admin.
  • manage_sales_pipelines — owner, admin (membuat/mengubah tahap dan pipeline).
  • reopen_opportunities — owner, admin.
  • view_sales_values — owner, admin, agent (nilai peluang; selain itu diredaksi menjadi nol).
  • export_sales_reports — owner, admin (lihat laporan nilai; lihat dokumen laporan).
• Tahap ≠ status percakapan: memindahkan peluang ke WON/LOST tidak mengubah status percakapan tertaut (mis. resolved). Keduanya dikelola terpisah.
• Tahap akhir tidak dapat dibuat target tanpa aturan di atas: menuju WON memaksa probabilitas 100, menuju LOST memaksa probabilitas 0 + alasan wajib; membuka kembali dari WON/LOST wajib alasan.
• Peluang baru selalu mulai pada tahap OPEN.
• Perpindahan antar-pipeline tidak didukung lewat antarmuka standar; peluang berpindah antar-tahap di pipeline aktif.
• Riwayat, audit, dan nilai sensitif diredaksi untuk peran tanpa view_sales_values.

Tugas terkait

• Laporan, ekspor, dan CSAT
• Contacts dan sales di perangkat seluler
• Mengelola pengguna, tim, dan inbox
• Referensi API — kontrak endpoint lengkap