Cara Menggunakan API Papo untuk Membuat dan Mengelola Tag

Q: Di mana saya dapat menemukan jalur yang tepat dan format payload?

Di dokumentasi resmi API, tersedia di https://papo.global/pt/docs. Di sana terdapat detail autentikasi, parameter, respons, dan contoh kode untuk tag dan sumber daya lainnya.

Dengan API REST dari Papo, Anda dapat membuat daftar tag yang ada, membuat tag baru, dan menerapkan tag ke kontak dengan percakapan terbuka — semuanya melalui permintaan terautentikasi, tanpa membuka panel. Ini adalah cara programatik untuk mengotomatiskan kategorisasi dan organisasi layanan dari sistem eksternal, CRM, atau alat otomatisasi.

API Papo mengekspos sumber daya Percakapan yang mencakup manajemen tag. Dengan ini, tim Anda dapat mempertahankan taksonomi yang konsisten, menyiapkan kategori sebelum kampanye, dan mengklasifikasikan kontak serta percakapan secara real-time, menggunakan autentikasi yang sama dengan endpoint platform lainnya.

Ringkasan operasi tag via API

Operasi	Apa yang dilakukan	Kapan digunakan
Daftar tag	Mengembalikan tag yang terdaftar di akun, dengan nama dan warna untuk identifikasi visual.	Mengaudit standardisasi akun atau menyinkronkan tag dengan alat lain.
Buat tag	Membuat tag di akun tanpa menerapkannya ke kontak.	Menyiapkan kategori baru sebelum menerapkan secara massal atau dalam otomatisasi.
Terapkan tag ke kontak + percakapan	Membuat tag jika belum ada dan menerapkannya ke kontak dan percakapan terbuka.	Mengotomatiskan triase, kualifikasi, atau klasifikasi saat percakapan masuk.

Bagaimana autentikasi API bekerja

Semua rute penulisan, termasuk operasi tag, memerlukan kunci rahasia akun. Ini harus dikirim sebagai token Bearer di header otorisasi. 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 muncul hanya sekali saat pembuatan; simpan di tempat aman dan cabut jika ada kecurigaan kebocoran.

Cara menggunakan dalam praktik

Akses area pengembang/API di panel Papo dan buat kunci rahasia. Salin juga kunci publik akun.
Di setiap permintaan, autentikasi dengan kunci rahasia sebagai token Bearer. Jika ingin memperkuat validasi, kirim kunci publik di header yang ditunjukkan dalam dokumentasi.
Untuk membuat daftar tag, panggil endpoint daftar tag API. Responsnya berisi tag yang terdaftar, memungkinkan Anda memetakan apa yang sudah ada sebelum membuat yang baru.
Untuk membuat tag tanpa menerapkannya, kirim payload JSON dengan informasi tag di endpoint pembuatan. Konsultasikan dokumentasi resmi untuk format yang tepat.
Untuk menerapkan tag ke kontak dengan percakapan terbuka, panggil endpoint pemberian tag. Jika tag belum ada, tag akan dibuat secara otomatis dan diterapkan ke kontak dan percakapan terbuka.

Karena API ini REST dan menggunakan JSON, bahasa apa pun yang mendukung HTTP dapat digunakan untuk mengintegrasikan tag ke skrip, ERP, CRM, atau alat otomatisasi. Dokumentasi resmi di https://papo.global/pt/docs menyediakan detail autentikasi, parameter, respons, dan contoh kode.

Untuk siapa integrasi ini masuk akal

Tim yang menggunakan otomatisasi eksternal untuk mengklasifikasikan percakapan tanpa membuka antarmuka Papo.
Operasi yang perlu membuat tag secara massal sebelum kampanye atau saat menerapkan taksonomi layanan baru.
Integrator dan reseller white label yang menghubungkan Papo ke sistem klien dan ingin mempertahankan kategorisasi yang konsisten antar akun.
Perusahaan yang sudah menggunakan API Papo untuk kontak dan pesan dan ingin melengkapi alur dengan tag.

Pertanyaan yang sering diajukan

Apakah saya perlu membuat tag sebelum menerapkan via API?

Tidak. API memiliki fitur yang membuat tag di akun, jika belum ada, dan langsung menerapkannya ke kontak dan percakapan terbuka. Ada juga opsi untuk hanya membuat tag, tanpa menerapkannya ke kontak mana pun.

Apakah tag yang diterapkan via API berlaku untuk kontak dan percakapan?

Ya. Fitur pemberian tag menerapkan tag ke kontak dan percakapan terbuka, membantu mengklasifikasikan riwayat prospek maupun layanan yang sedang berlangsung.

Apakah autentikasinya sama dengan yang digunakan di endpoint Papo lainnya?

Ya. Rute penulisan memerlukan kunci rahasia akun, dikirim sebagai token Bearer. Kunci publik bersifat opsional dan, jika dikirim, harus sesuai dengan akun yang sama.

Di mana saya dapat menemukan jalur yang tepat dan format payload?

Di dokumentasi resmi API, tersedia di https://papo.global/pt/docs. Di sana terdapat detail autentikasi, parameter, respons, dan contoh kode untuk tag dan sumber daya lainnya.

Bisakah saya menggunakan API untuk mengklasifikasikan percakapan lama secara massal?

Fitur penerapan yang dijelaskan di platform bertindak pada kontak dan percakapan terbuka. Untuk kasus spesifik migrasi atau klasifikasi retroaktif, sebaiknya konsultasikan dokumentasi resmi dan kombinasikan daftar percakapan dengan panggilan berurutan, jika alurnya memungkinkan.