Setelah mendaftar sebagai partner RBM, Anda memiliki akun partner. Untuk mengakses setelan akun partner, buka Business Communications Developer Console, lalu klik Setelan akun partner. Dari sini, Anda dapat melakukan hal berikut:
- Memperbarui informasi akun partner
- Menambahkan, mengedit, dan menghapus merek yang ditautkan ke akun Anda
- Mengelola pengguna akun
- Membuat akun layanan dan kunci untuk mengautentikasi panggilan API
Perbarui informasi akun partner
Dari halaman Setelan, Anda dapat melihat ID partner dan memperbarui informasi berikut:
Kolom | Deskripsi |
---|---|
Nama partner | Nama akun partner Anda |
Nama tampilan | Nama akan muncul di
Laporan penagihan RBM yang diterima operator (sebagai kolom
owner_name ). Operator akan menggunakannya untuk mengidentifikasi Anda sebagai partner tepercaya dan memastikan mereka membuat informasi invoice yang benar untuk penggunaan RBM oleh Anda guna menjangkau pelanggan mereka. Nama yang Anda berikan di sini harus sesuai dengan
nama yang digunakan dalam kontrak pesan operator Anda. |
Kontak dukungan teknis | Orang yang akan dihubungi Google jika ada masalah teknis dengan agen Anda. Anda dapat memperbarui
|
Webhook | Ini adalah URL endpoint webhook Anda. Klik **Configure** untuk memperbaruinya. Saat Anda mengonfigurasi webhook partner, webhook ini berlaku untuk semua agen Anda. Jika ingin menggunakan webhook yang berbeda untuk setiap agen, Anda dapat mengonfigurasi webhook agen yang hanya akan berlaku untuk agen tersebut. |
Kelola merek
Sebagai partner RBM, Anda dapat membuat agen atas nama brand.
Gunakan halaman Merek di Setelan akun untuk menambahkan, mengedit, dan menghapus merek yang terkait dengan akun partner Anda.
Tambahkan merek
Untuk menambahkan merek, masukkan namanya di kolom input dan klik Tambahkan.
Mengedit merek
Untuk mengedit merek:
- Klik kotak centang di samping nama merek.
- Klik tombol , lalu klik Edit name.
- Edit, lalu klik Selesai.
Menghapus merek
Merek tidak dapat dihapus jika terkait dengan agen, meskipun agen tidak diluncurkan.
Untuk menghapus merek, klik kotak centang di samping nama merek, lalu klik Hapus.
Kelola pengguna
Halaman Pengguna di Setelan akun adalah tempat Anda mengelola pengguna akun partner Anda. Pengguna yang membuat akun partner memiliki peran Pemilik. Pengguna baru dapat memiliki peran Pengelola atau Pembaca.
- Pengelola dapat mengakses semua kemampuan Konsol Play, untuk mengelola setiap dan semua agen yang merupakan bagian dari akun partner.
- Pembaca memiliki akses hanya baca ke Konsol Developer, untuk melihat setiap dan semua agen yang merupakan bagian dari akun partner.
Tambahkan pengguna
Untuk menambahkan pengguna, masukkan alamat emailnya di kolom input, lalu pilih Peran.
Saat Anda menambahkan pengguna baru, dia akan menerima email yang memberitahukan bahwa dia memiliki akses ke akun partner.
Menghapus pengguna
Untuk menghapus pengguna:
- Temukan pengguna yang ingin Anda hapus, lalu klik tombol di baris tabelnya.
- Pilih Hapus pengguna.
- Konfirmasi penghapusan.
Pengguna yang Anda hapus akan menerima email yang memberitahukan bahwa dia tidak lagi memiliki akses ke akun partner.
Anda tidak dapat menghapus pengguna dengan peran Pemilik. Untuk mengubah atau menghapus Pemilik, Anda perlu menghubungi dukungan.
Mengubah peran pengguna
Untuk memperbarui peran pengguna:
- Temukan pengguna yang ingin Anda perbarui, lalu klik tombol di baris tabelnya.
- Pilih Edit peran.
- Pilih peran baru dari menu drop-down.
- Klik Save.
Menyiapkan akun layanan untuk mengautentikasi panggilan API
Saat melakukan panggilan ke RBM API, Anda mengautentikasi panggilan dengan kunci akun layanan. Dengan kunci ini, Anda dapat membuat dan mengelola merek dan agen, serta mengirim pesan dan permintaan sebagai agen.
Ikuti langkah-langkah berikut untuk membuat kunci akun layanan:
- Di Setelan akun, buka halaman Akun layanan.
- Klik Create key, lalu klik Create. Browser Anda akan mendownload kunci akun layanan.
Simpan kunci akun layanan Anda di lokasi pribadi yang aman. Jangan bagikan kunci Anda ke publik. Anda akan memerlukan kunci ini nanti untuk mengakses RBM API.
Mengonfigurasi webhook partner Anda
Webhook adalah callback HTTPS yang dibuat partner yang menentukan cara agen Anda harus merespons pesan dan peristiwa. Setelah mengonfigurasi webhook, Anda dapat mulai menerima pesan dan peristiwa.
Untuk mengonfigurasi webhook partner, ikuti langkah-langkah berikut:
Buka Konsol Developer Business Communications, lalu login dengan Akun Google partner RBM Anda.
Buka Setelan akun.
Untuk URL webhook RCS Business Messaging, klik Konfigurasikan.
Untuk URL endpoint Webhook, masukkan URL webhook yang diawali dengan "https://".
Catat nilai
clientToken
Anda. Anda memerlukannya untuk memverifikasi bahwa pesan yang Anda terima berasal dari Google.Konfigurasikan webhook Anda untuk menerima permintaan
POST
dengan parameterclientToken
yang ditentukan dan mengirim respons200 OK
dengan nilai teks biasa dari parametersecret
sebagai isi respons.Misalnya, jika webhook Anda menerima permintaan
POST
dengan konten isi berikut{ "clientToken":"SJENCPGJESMGUFPY", "secret":"1234567890" }
webhook Anda harus mengonfirmasi nilai
clientToken
dan, jikaclientToken
benar, menampilkan respons200 OK
dengan1234567890
sebagai isi respons:// clientToken from Configure const myClientToken = "SJENCPGJESMGUFPY"; // Example endpoint app.post("/rbm-webhook", (req, res) => { const msg = req.body; if (msg.clientToken === myClientToken) { res.status(200).send(msg.secret); return; } res.send(400); });
Di Konsol Play, klik Verifikasi. Saat RBM memverifikasi webhook Anda, dialog akan ditutup.
Memverifikasi pesan masuk
Karena webhook dapat menerima pesan dari setiap pengirim, Anda harus memverifikasi bahwa Google telah mengirim pesan masuk sebelum memproses konten pesan.
Untuk memverifikasi bahwa Google mengirim pesan yang Anda terima, ikuti langkah-langkah berikut:
- Ekstrak header
X-Goog-Signature
pesan. Ini adalah salinan payload isi pesan berenkode base64. - Dekode base-64 payload RBM di elemen
message.body
permintaan. - Dengan menggunakan token klien webhook (yang Anda tentukan saat menyiapkan webhook) sebagai kunci, buat HMAC SHA512 untuk byte pesan yang didekode base-64 dan mengenkode base64 hasilnya.
- Bandingkan hash
X-Goog-Signature
dengan hash yang Anda buat.- Jika hash cocok, berarti Anda telah mengonfirmasi bahwa Google yang mengirim pesan.
Jika hash tidak cocok, periksa proses hashing pada pesan yang diketahui bagus.
Jika proses hashing berfungsi dengan benar dan Anda menerima pesan yang Anda yakini dikirimkan kepada Anda secara curang, hubungi kami.
Node.js
if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) { // Validate the received hash to ensure the message came from Google RBM let userEventString = Buffer.from(requestBody.message.data, 'base64'); let hmac = crypto.createHmac('sha512', CLIENT_TOKEN); let data = hmac.update(userEventString); let genHash = data.digest('base64'); let headerHash = req.header('X-Goog-Signature'); if (headerHash === genHash) { let userEvent = JSON.parse(userEventString); console.log('userEventString: ' + userEventString); handleMessage(userEvent); } else { console.log('hash mismatch - ignoring message'); } } res.sendStatus(200);
Langkah berikutnya
Setelah akun partner Anda siap, saatnya untuk membuat agen pertama.