Menyiapkan akun partner

Setelah terdaftar sebagai partner RBM, Anda memiliki akun partner. Untuk mengakses pengaturan akun mitra Anda, buka Konsol Developer Komunikasi Bisnis lalu klik Setelan akun partner. Dari sini, Anda dapat melakukan hal berikut:

• Memperbarui informasi akun partner Anda
• Menambahkan, mengedit, dan menghapus merek yang ditautkan ke akun Anda
• Mengelola pengguna akun
• Membuat akun layanan dan kunci untuk mengautentikasi panggilan API

Memperbarui informasi akun partner

Dari halaman Setelan, Anda dapat melihat ID partner dan memperbarui informasi berikut:

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, lalu klik Tambahkan.

Mengedit merek

Untuk mengedit merek:

1. Klik kotak centang di samping nama merek.
2. Klik tombol more_vert, lalu klik Edit nama.
3. Edit, lalu klik Selesai.

Menghapus merek

Merek tidak dapat dihapus jika terkait dengan agen, meskipun agen tersebut 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 mitra 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 termasuk dalam akun partner.
• Pembaca memiliki akses hanya baca ke Konsol Developer, untuk melihat setiap dan semua agen yang termasuk dalam akun partner.

Tambahkan pengguna

Untuk menambahkan pengguna, masukkan alamat emailnya di kolom input, lalu pilih Peran.

Saat Anda menambahkan pengguna baru, mereka menerima email yang memberitahukan bahwa mereka telah akses ke akun partner.

Menghapus pengguna

Untuk menghapus pengguna:

1. Temukan pengguna yang ingin Anda hapus, lalu klik more_vert di baris tabel mereka.
2. Pilih Hapus pengguna.
3. Konfirmasi penghapusan.

Pengguna yang Anda hapus akan menerima email yang memberitahukan bahwa mereka tidak lagi memiliki akses ke akun partner.

Anda tidak dapat menghapus pengguna dengan peran Pemilik. Untuk mengubah atau menghapus Pemilik, Anda harus perlu menghubungi tim dukungan.

Mengubah peran pengguna

Untuk memperbarui peran pengguna:

1. Temukan pengguna yang ingin Anda perbarui, dan klik more_vert di baris tabel mereka.
2. Pilih Edit peran.
3. Pilih peran baru dari drop-down.
4. Klik Simpan.

Menyiapkan akun layanan untuk mengautentikasi panggilan API

Saat melakukan panggilan ke RBM API, Anda mengautentikasi panggilan dengan kunci akun layanan. Kunci ini memungkinkan Anda membuat dan mengelola merek dan agen, serta mengirim pesan dan permintaan sebagai agen.

Ikuti langkah-langkah berikut untuk membuat kunci akun layanan:

1. Di Setelan akun, buka halaman Service account.
2. Klik Create key, lalu klik Create. Browser Anda mendownload kunci akun layanan Google.

Simpan kunci akun layanan Anda di lokasi yang aman dan bersifat pribadi. Jangan bagikan kunci secara publik. Anda akan memerlukan kunci ini nanti untuk mengakses RBM API.

Konfigurasi webhook partner Anda

Webhook adalah callback HTTPS yang dibuat partner yang menentukan cara agen Anda harus merespons pesan dan acara. Setelah mengonfigurasi webhook, Anda dapat mulai menerima pesan dan peristiwa.

Untuk mengonfigurasi webhook partner, ikuti langkah-langkah berikut:

1. Buka Konsol Developer Komunikasi Bisnis dan login dengan Akun Google partner RBM Anda.

2. Buka Setelan akun.

3. Untuk URL webhook Business Messaging RCS, klik Configure.

4. Untuk URL endpoint Webhook, masukkan URL webhook Anda diawali dengan "https://".

5. Catat nilai clientToken Anda. Anda memerlukannya untuk memverifikasi bahwa pesan yang Anda terima berasal dari Google.

6. Konfigurasi webhook Anda untuk menerima permintaan POST dengan atribut yang ditentukan clientToken dan kirim respons 200 OK dengan nilai teks biasa parameter secret sebagai isi respons.

   Misalnya, jika webhook Anda menerima permintaan POST dengan hal berikut konten isi

   {
     "clientToken":"SJENCPGJESMGUFPY",
     "secret":"1234567890"
   }
   

   webhook Anda harus mengonfirmasi nilai clientToken dan, jika clientToken benar, tampilkan respons 200 OK dengan 1234567890 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);
   });
   

7. Di Konsol Play, klik Verifikasi. Saat RBM memverifikasi webhook Anda, dialog akan tertutup.

Memverifikasi pesan masuk

Karena webhook dapat menerima pesan dari pengirim mana pun, Anda harus memverifikasi bahwa Google mengirim pesan masuk sebelum memproses isi pesan.

Untuk memverifikasi bahwa Google mengirim pesan yang Anda terima, ikuti langkah-langkah berikut:

1. Ekstrak header X-Goog-Signature pesan. Ini adalah hash, salinan payload pesan berenkode base64.
2. Base-64 melakukan dekode payload RBM di elemen message.body permintaan.
3. Menggunakan token klien webhook Anda (yang Anda tentukan saat menyiapkan webhook) sebagai kunci, buat HMAC SHA512 dari byte base-64 yang didekode payload pesan dan melakukan encoding base64.
4. Bandingkan hash X-Goog-Signature dengan hash yang Anda buat.
   • Jika hash cocok, Anda telah mengonfirmasi bahwa Google yang mengirim pesan.

   • Jika {i>hash<i} tidak cocok, periksa proses {i>hashing<i} Anda pada untuk membuat pesan email baru.

     Jika proses {i>hashing<i} Anda bekerja dengan benar dan Anda menerima pesan yang Anda yakini dikirim kepada Anda secara curang, hubungi kami.

  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 mitra Anda siap, saatnya untuk membuat agen pertama Anda.