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:

  1. Backend Anda meminta sesi ke Platform API. Butuh scope embed:sessions. Jawabannya berisi client_secret sekali pakai yang berlaku 120 detik.
  2. Halaman Anda memuat wavely-embed.js dari alamat Wavely, di /embed/v1/wavely-embed.js.
  3. SDK menjalankan init dengan kunci publik wvpk_... dan fungsi yang mengambil client_secret dari backend Anda.
  4. 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 daftar conversations atau ringkasan summary.
  • channels: halaman Kanal, bisa disaring ke web atau whatsapp.
  • 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.