Untuk developer
Platform API
Platform API Wavely memungkinkan aplikasi Anda mengelola bisnis, cabang, tim, dan anggotanya dari server Anda, tanpa membuka dashboard.
Apa yang bisa dilakukan API
Platform API dipakai aplikasi Anda dari server ke server, di bawah /platform/v1. Dengannya aplikasi Anda mengatur Wavely tanpa membuka dasbor:
- bisnis milik aplikasi Anda beserta pengaturannya, cabang, dan tim (disebut divisi di API)
- anggota (agen), pengaturan routing dan visibilitasnya
- kontak dan persetujuan WhatsApp mereka
- kanal, nomor WhatsApp, balasan cepat, dan event balasan cepat
- percakapan dan pesan: mengirim pesan WhatsApp, membaca riwayat, mengunggah berkas
- endpoint webhook dan sesi komponen tertanam
Aplikasi hanya melihat bisnis yang dibuatnya sendiri.
Memulai
- Aplikasi Anda didaftarkan oleh tim Wavely. Anda menerima kunci publik
wvpk_...untuk komponen tertanam, dan satu atau lebih kunci rahasiawvsk_.... - Setiap kunci rahasia membawa scope, seperti
directory:read,contacts:write,messages:write,webhooks:manage, danembed:sessions. Rahasia kunci hanya tampil sekali, saat dibuat atau diputar. Simpan di tempat aman. - Kirim kunci di header
Authorization. Rute yang bekerja pada satu bisnis juga meminta headerWavely-Organization.
curl https://HOST-WAVELY/platform/v1/branches \
-H "Authorization: Bearer wvsk_..." \
-H "Wavely-Organization: ID-BISNIS"
Kunci tanpa scope yang diminta rute mendapat 403 insufficient_scope, dan details.required_scope menyebut scope yang kurang.
Aturan permintaan
- Permintaan
POSTyang membuat sesuatu wajib membawaIdempotency-Key. Mengulang permintaan yang sama dengan kunci yang sama mengembalikan jawaban yang sama, bukan data ganda. - Perubahan pada data bernomor versi (cabang, tim, agen, kontak, kanal, dan lainnya) wajib membawa
If-Matchberisi versi dariETag. Versi yang basi menghasilkan412, dan header yang hilang428. - Daftar memakai
cursordanlimit(1 sampai 100), dan menjawab{ items, next_cursor }. - Galat berbentuk
{ "error": { "code", "message", "details" } }. Jawaban429menyertakanRetry-After.
Catatan: Lihat juga halaman Webhook untuk menerima kabar perubahan, dan Komponen tertanam untuk menampilkan layar Wavely di aplikasi Anda.