Menyiapkan akun partner

Setelah terdaftar sebagai partner RBM, Anda akan memiliki akun partner. Untuk mengakses setelan akun partner, buka Konsol Developer Business Communications dan klik Setelan akun partner. Dari sini, Anda dapat melakukan hal berikut:

Memperbarui 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 dalam laporan penagihan RBM yang diterima operator (sebagai kolom owner_name). Operator akan menggunakannya untuk mengidentifikasi Anda sebagai partner tepercaya dan untuk memastikan mereka membuat informasi invoice yang benar untuk penggunaan RBM 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

  • Nama
  • Alamat email perusahaan
  • Nomor telepon
Webhook Ini adalah URL endpoint webhook Anda. Klik Konfigurasikan untuk memperbaruinya. Saat Anda mengonfigurasi webhook partner, konfigurasi tersebut akan 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.

Mengelola merek

Sebagai partner RBM, Anda dapat membuat agen atas nama brand.

Gunakan halaman Brands di Account settings untuk menambahkan, mengedit, dan menghapus brand 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 , lalu klik Edit nama.
  3. Edit, lalu klik Selesai.

Menghapus merek

Merek tidak dapat dihapus jika dikaitkan 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 partner. 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 semua agen yang termasuk dalam akun partner.
  • Pembaca memiliki akses hanya baca ke Konsol Play, untuk melihat semua agen yang dimiliki akun partner.

Tambahkan pengguna

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

Saat Anda menambahkan pengguna baru, mereka akan menerima email yang memberi tahu bahwa mereka memiliki akses ke akun partner.

Menghapus pengguna

Untuk menghapus pengguna:

  1. Temukan pengguna yang ingin Anda hapus, lalu klik tombol di baris tabelnya.
  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 menghubungi dukungan.

Mengubah peran pengguna

Untuk memperbarui peran pengguna:

  1. Temukan pengguna yang ingin diperbarui, lalu klik tombol di baris tabelnya.
  2. Pilih Edit peran.
  3. Pilih peran baru dari menu 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. Akun layanan dapat memiliki hingga 10 kunci.

Untuk mengautentikasi panggilan API dengan aman, Anda juga memerlukan alat command line oauth2l.

Ikuti langkah-langkah berikut untuk membuat kunci akun layanan:

  1. Di Setelan akun, buka halaman Akun layanan.
  2. 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 secara publik. Anda akan memerlukan kunci ini nanti untuk mengakses RBM API.

Mengonfigurasi webhook partner

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

Jika ingin menggunakan webhook yang berbeda untuk agen, Anda dapat menyiapkan webhook tingkat agen yang akan mengganti webhook partner. Untuk informasi selengkapnya, lihat Mengonfigurasi webhook agen.

Untuk mengonfigurasi webhook partner, ikuti langkah-langkah berikut:

  1. Buka Business Communications Developer Console, lalu login dengan Akun Google partner RBM Anda.

  2. Buka Setelan akun.

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

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

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

  6. Konfigurasikan webhook Anda untuk menerima permintaan POST dengan parameter clientToken yang ditentukan dan kirim respons 200 OK dengan nilai teks biasa dari parameter secret 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, 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 ditutup.

Untuk menangani kegagalan pengiriman webhook dan memastikan pemrosesan pesan yang andal, lihat Penanganan pesan.

Memverifikasi pesan masuk

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

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

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

    • Jika hash tidak cocok, periksa proses hashing Anda pada pesan yang dikenal baik.

      Jika proses hashing Anda berfungsi dengan benar dan Anda menerima pesan yang menurut Anda dikirim kepada Anda secara menipu, 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 disiapkan, kini saatnya untuk membuat agen pertama.

Sebelumnya
Mendaftar sebagai partner
Berikutnya
Buat agen pertama Anda