Untuk mengelola Urutan follow-up melalui API di Papo, Anda dapat menampilkan urutan yang tersedia, mendaftarkan kontak, dan menjeda keikutsertaan lead menggunakan pembaruan atribut khusus — semuanya melalui permintaan terautentikasi, tanpa membuka dasbor. Inilah cara mengintegrasikan nutrisi lead ke CRM, ERP, dan alur otomasi eksternal.
Ringkasan operasi via API
| Operasi | Deskripsi | Cara API melakukannya |
|---|---|---|
| Menampilkan urutan | Mendapatkan semua urutan follow-up akun, dengan nama, pengenal, dan status (aktif/nonaktif). | Permintaan GET terautentikasi ke endpoint flows, memfilter berdasarkan tipe "sequence". |
| Mendaftarkan kontak | Memasukkan kontak yang sudah ada ke urutan aktif, memulai perjalanan pesan. | POST dengan ID kontak dan ID urutan ke endpoint pendaftaran. |
| Menjeda urutan untuk kontak | Menghentikan sementara pengiriman ke lead tanpa menghapusnya dari urutan. | Pembaruan atribut khusus kontak (mis.: status_pausa) via API kontak, dikombinasikan dengan kondisi di Flow. |
Cara kerja autentikasi dan endpoint
Semua operasi menggunakan API REST Papo, terautentikasi dengan kunci rahasia akun (token Bearer). URL dasar adalah https://app.papo.global/api/v1. Kunci dibuat di dasbor, di area pengembang.
Fitur urutan dikelompokkan dalam endpoint flows. API memungkinkan menampilkan semua flow, termasuk yang bertipe "sequence", dan juga mengaktifkan/menonaktifkan seluruh flow. Untuk mendaftarkan kontak, ada endpoint khusus yang menerima pengenal kontak dan pengenal flow.
Detail persis setiap endpoint (parameter, payload, dan contoh) tersedia di dokumentasi resmi API Papo. Di sini, kami fokus pada alur kerja untuk mengelola urutan follow-up.
Langkah demi langkah: menampilkan, mendaftarkan, dan menjeda
1. Menampilkan urutan yang tersedia
Sebelum mendaftarkan lead, Anda perlu mengetahui urutan mana yang ada dan pengenalannya. Panggilan penampilan mengembalikan daftar dengan nama, ID, dan status (aktif/nonaktif). Hanya urutan aktif yang menerima pendaftaran baru.
Dengan daftar di tangan, sistem eksternal Anda dapat memetakan urutan mana yang digunakan untuk setiap lead.
2. Mendaftarkan kontak ke urutan
Dengan ID kontak (diperoleh melalui pencarian atau pembuatan via API kontak) dan ID urutan aktif, Anda mengirim permintaan untuk memasukkannya di awal perjalanan. Kontak harus sudah ada di CRM Papo; jika belum, buat terlebih dahulu menggunakan endpoint kontak.
Pendaftaran langsung memulai pengiriman pesan yang dijadwalkan, dengan mematuhi interval yang dikonfigurasi di Flow. Riwayat kontak tetap terjaga.
3. Menjeda urutan untuk kontak tertentu
API Papo tidak memiliki perintah langsung untuk "menjeda" keikutsertaan kontak dalam urutan. Namun, Anda dapat memperoleh efek yang sama dengan menggabungkan API kontak dan kondisi di Flow.
Prasyarat: urutan harus dibuat dengan node kondisi yang memeriksa atribut khusus (mis.: status_pausa). Jika atribut sama dengan "pausado", kondisi memblokir pengiriman pesan berikutnya; jika tidak, kondisi meloloskannya. (Lihat artikel tentang jeda sementara untuk detail penyusunan Flow.)
Dengan struktur ini di Flow, penjedaannya dilakukan dalam dua langkah via API:
- Identifikasi kontak berdasarkan ID atau cari berdasarkan telepon/email menggunakan endpoint penampilan kontak.
- Perbarui atribut khusus kontak menjadi "pausado" (atau nilai yang diharapkan kondisi Anda). Gunakan endpoint pembaruan kontak, kirimkan field khusus.
Mulai saat itu, ketika flow mencapai kondisi, ia akan mengenali nilai "pausado" dan tidak mengirim pesan. Untuk melanjutkan, cukup perbarui atribut ke nilai lain (mis.: "ativo") atau kosongkan, dan kontak akan melanjutkan dari tempatnya berhenti.
Metode ini menjaga kontak tetap terdaftar dan progres dalam urutan, tanpa kehilangan riwayat.
Untuk siapa integrasi ini berguna
- Operasi SDR dan penjualan B2B yang memicu urutan dari peristiwa eksternal (mis.: lead mengunduh materi, deal dibuat di CRM).
- Reseller white label yang menyediakan perjalanan follow-up secara otomatis untuk klien baru, mendaftarkan kontak awal tanpa tindakan manual.
- Tim pemasaran dan otomasi yang menggunakan alat seperti n8n atau Zapier untuk menghubungkan Papo ke puluhan sistem dan membutuhkan kontrol granular atas urutan.
- Perusahaan dengan proses jeda bersyarat, di mana lead meminta waktu dan sales ingin menghentikan urutan tanpa kehilangan titik dalam urutan — semuanya dipicu oleh tombol di CRM eksternal.
Pertanyaan umum
Apakah saya memerlukan kunci rahasia untuk menampilkan urutan?
Ya. Setiap operasi yang mengembalikan data akun memerlukan autentikasi dengan kunci rahasia, dikirim sebagai token Bearer di header Authorization.
Bisakah saya mendaftarkan kontak yang belum ada di Papo?
Tidak. Kontak harus sudah ada di CRM Papo. Anda dapat membuatnya terlebih dahulu via API kontak (dengan nama, telepon, atau email) lalu mendaftarkannya ke urutan.
Apakah API memungkinkan menghapus kontak dari urutan?
Penghapusan (pembatalan pendaftaran) tidak tersedia sebagai endpoint khusus di versi saat ini. Alternatif untuk menghentikan pengiriman adalah menjeda via atribut khusus, seperti dijelaskan, atau menonaktifkan seluruh flow, yang memengaruhi semua kontak.
Bagaimana saya tahu jeda via atribut berhasil?
Setelah memperbarui atribut, urutan akan terus memproses node tunggu. Saat mencapai kondisi, ia akan memeriksa nilai. Jika "pausado", pesan tidak akan dikirim. Anda dapat mengonfirmasi di profil kontak, di modul Kontak, bahwa kontak tetap terdaftar, tetapi pesan berikutnya tidak dikirim.
Bisakah saya menjeda seluruh urutan via API?
Ya. API memungkinkan mengubah status flow menjadi nonaktif, menjeda urutan untuk semua kontak. Gunakan endpoint aktivasi/penonaktifan flow. Untuk melanjutkan, cukup aktifkan kembali.
Di mana saya menemukan endpoint persis dan contoh kode?
Dokumentasi lengkap API tersedia di https://papo.global/pt/docs. Di sana Anda menemukan endpoint flows, kontak, dan format permintaan.
Baca juga
- Cara menggunakan API Papo untuk mengelola Flow otomasi
- Cara menggunakan API Papo untuk membuat dan memperbarui kontak secara massal
Mulai gratis dan otomatiskan urutan Anda →
Dengan API Papo, Anda mengintegrasikan nutrisi lead langsung ke stack Anda, tanpa membuka dasbor — pengguna pertama gratis untuk Anda coba.