Untuk developer
Komponen tertanam
Komponen tertanam Wavely menampilkan layar Wavely di halaman aplikasi Anda lewat iframe, memakai sesi berumur pendek dari server Anda.
Cara kerjanya
Komponen tertanam menampilkan layar Wavely di dalam halaman aplikasi Anda, lewat iframe. Alurnya:
- Backend Anda meminta sesi ke Platform API. Butuh scope
embed:sessions. Jawabannya berisiclient_secretsekali pakai yang berlaku 120 detik. - Halaman Anda memuat
wavely-embed.jsdari alamat Wavely, di/embed/v1/wavely-embed.js. - SDK menjalankan
initdengan kunci publikwvpk_...dan fungsi yang mengambilclient_secretdari backend Anda. - Frame menukar rahasia itu dengan token sepuluh menit yang hanya disimpan di memorinya. Frame tidak memakai penyimpanan browser.
Backend:
curl -X POST https://HOST-WAVELY/platform/v1/embed-sessions \
-H "Authorization: Bearer wvsk_..." \
-H "Wavely-Organization: ID-BISNIS" \
-H "Content-Type: application/json" \
-d '{"agent_external_ref":"agen-42","components":["inbox","notifier"],"origin":"https://app.contoh.id"}'
Halaman Anda:
const wavely = WavelyEmbed.init({
publishableKey: "wvpk_...",
fetchClientSecret: async () => {
const res = await fetch("/api/wavely-session", { method: "POST" })
return (await res.json()).client_secret
},
})
const inbox = wavely.create("inbox", {})
document.getElementById("inbox").append(inbox.element)
Pilih agen dengan agent_id atau agent_external_ref. origin harus ada di daftar origin yang diizinkan untuk aplikasi Anda, kalau tidak Wavely menjawab origin_not_allowed. Frame hanya mau tampil di origin itu.
Sembilan komponen
Satu sesi meminta 1 sampai 8 komponen untuk satu agen.
inbox: kotak masuk beserta utas dan penulis balasan.traffic: papan pengunjung di situs.numbers: nomor WhatsApp.canned: balasan cepat dan event-nya.fleet: dasbor dan tabel server WhatsApp. Hanya untuk sesi operator.notifier: tidak tampil. Ia hanya memberi tahu ada chat baru atau belum dibaca, agar Anda bisa memberi lencana di aplikasi.contact: panel kontak, sebagai daftarconversationsatau ringkasansummary.channels: halaman Kanal, bisa disaring kewebatauwhatsapp.branches: halaman Cabang.
Peran agen menentukan apa yang boleh diminta. numbers dan channels perlu peran yang boleh mengelola kanal, branches perlu peran yang boleh mengelola cabang. Komponen lain terbuka untuk semua peran. Sesi fleet dibuat lewat POST /platform/v1/embed-sessions/operator, dengan scope embed:sessions dan fleet:operate.
Perintah dan kejadian
Setiap komponen yang dikembalikan create punya perintah seperti openConversation, openContact, setLocale, setBranch, dan destroy. Dengarkan kejadian lewat on, misalnya ready, conversation.selected, unread.changed, dan session.expired. Daftar lengkapnya ada di berkas tipe SDK.