Menyiapkan akun partner

Setelah mendaftar sebagai partner RCS for Business, Anda akan memiliki akun partner. Untuk mengakses setelan akun partner, buka Konsol Developer RCS untuk Bisnis dan 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:

Kolom	Deskripsi
Nama partner	Nama akun partner Anda
Nama tampilan	Nama akan muncul di laporan penagihan yang diterima operator (sebagai kolom owner_name ). Operator akan menggunakan hal ini untuk mengidentifikasi Anda sebagai partner tepercaya dan membuat informasi invoice yang benar untuk penggunaan RCS untuk Bisnis dalam 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 berlaku untuk semua agen Anda. Jika ingin menggunakan webhook lain untuk agen tertentu, Anda dapat mengonfigurasi webhook agen yang hanya akan berlaku untuk agen tersebut.

Mengelola merek

Sebagai partner RCS untuk Bisnis, Anda dapat membuat agen atas nama brand.

Merek Organisasi atau grup yang diwakili oleh satu atau beberapa agen. Misalnya, perusahaan jasa keuangan Growing Tree dapat membuat merek bernama Growing Tree dan agen bernama Growing Tree Bank untuk berbicara dengan pelanggan tentang layanan perbankan.

Gunakan halaman Merek di Setelan akun untuk menambahkan, mengedit, dan menghapus merek yang terkait dengan akun partner Anda.

Tambahkan merek

Catatan: Untuk menambahkan merek menggunakan RBM Management API, lihat dokumentasi Membuat merek.

Untuk menambahkan merek, masukkan namanya di kolom input, lalu klik Tambahkan.

Mengedit merek

Catatan: Untuk mengedit merek menggunakan RBM Management API, lihat dokumentasi Mengganti nama 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 belum diluncurkan.

Untuk menghapus merek, centang kotak 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 Developer, untuk mengelola semua agen yang dimiliki akun partner.
• Pembaca memiliki akses hanya baca ke Konsol Developer, untuk melihat semua agen yang dimiliki akun partner.

Menambahkan pengguna

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

Saat Anda menambahkan pengguna baru, dia akan menerima email yang memberitahukan bahwa dia 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 dia 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 Anda perbarui, 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 Buat kunci, lalu klik Buat. Browser Anda akan mendownload kunci akun layanan.

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

Konfigurasi webhook partner Anda

Untuk mempelajari cara mengonfigurasi webhook partner, lihat panduan Webhook.

Untuk panduan tentang cara memproses webhook secara asinkron untuk mencegah kegagalan pengiriman, 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 Base64 dalam elemen message.body permintaan.
3. Dengan menggunakan token klien webhook Anda (yang Anda tentukan saat menyiapkan webhook) sebagai kunci, buat SHA512 HMAC dari byte payload pesan yang didekode base64 dan enkode hasilnya dalam base64.
4. Bandingkan hash X-Goog-Signature dengan hash yang Anda buat.
   • Jika hash cocok, Anda telah mengonfirmasi bahwa Google mengirimkan pesan tersebut.

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

     Jika proses hashing Anda berfungsi dengan benar dan Anda menerima pesan yang menurut Anda 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
    const headerHash = req.header('X-Goog-Signature');
    const userEventString = Buffer.from(requestBody.message.data, 'base64');
    const hmac = crypto.createHmac('sha512', myClientToken);
    const genHash = hmac.update(userEventString).digest('base64');

    if (headerHash === genHash) {
      const userEvent = JSON.parse(userEventString);
      const webhookType = req.header('X-Goog-Webhook-Type');

      // Route based on the header type
      if (webhookType === 'message_callback') {
        handleMessage(userEvent);
      } else if (webhookType === 'agent_callback') {
        handleAgentEvent(userEvent);
      }
    } else {
      console.log('Hash mismatch - ignoring message');
      res.sendStatus(401);
      return;
    }
  }

  res.sendStatus(200);
  

Langkah berikutnya

Setelah akun partner Anda disiapkan, saatnya membangun agen pertama Anda.