Buat agen pertama Anda

Pengguna berinteraksi dengan agen melalui aplikasi pesan yang mendukung RCS, seperti Google Message, di perangkat mereka. Dalam panduan memulai ini, Anda akan membuat agen RCS for Business dasar yang dapat mengirim pesan sederhana ke perangkat pengujian dan menerima respons.

Alur pesan melalui percakapan yang mendukung RBM

Prasyarat

Sebelum memulai penggunaan agen, Anda memerlukan item berikut:

Menyiapkan perangkat pengujian

Untuk berkomunikasi dengan agen RCS for Business yang belum diluncurkan, perangkat pengujian harus mendukung RCS, tetapi tidak semua perangkat Android dapat menerima pesan RCS secara default. Anda dapat memeriksa status RCS perangkat Anda dan, jika perlu, mengaktifkan RCS dengan mengonfigurasi perangkat Anda menggunakan aplikasi Message dan Layanan Operator versi pra-rilis.

Memeriksa status RCS perangkat Anda

  1. Di aplikasi Pesan, ketuk tombol , lalu ketuk Setelan.

  2. Ketuk Fitur chat, lalu temukan nilai Status.

    Jika Status adalah Terhubung, RCS aktif di perangkat Anda.

Langkah berikutnya

Jika RCS aktif di perangkat Anda, Anda siap menyiapkan agen. Jika RCS tidak aktif di perangkat Anda, Anda harus mengaktifkan RCS di perangkat Anda sebelum dapat menguji agen RCS for Business.

Menyiapkan agen Anda

Agen RCS untuk Bisnis menggunakan RBM API untuk mengirim pesan, peristiwa, dan permintaan lainnya kepada pengguna. Saat membuat agen, Anda mengaktifkan akses ke RBM API dan menentukan informasi dasar agen Anda.

Mengidentifikasi wilayah agen

Agen RCS for Business dapat berada di salah satu dari tiga wilayah: Amerika Utara, Eropa, dan Asia Pasifik. RBM API mendukung tiga endpoint regional untuk membantu bisnis mematuhi persyaratan regional dan bisnis.

Saat membuat agen, pilih wilayah agen berdasarkan peraturan, persyaratan, dan jarak dengan pengguna akhir yang berlaku. Region ini menentukan tempat operasi agen Anda dan lokasi penyimpanan datanya.

Jika Anda atau target pengguna Anda tidak berada di wilayah tersebut, pilih wilayah yang paling dekat dengan Anda untuk meminimalkan latensi. Contoh:

  • Jika Anda berada di Amerika Latin, pilih wilayah Amerika Utara.
  • Jika Anda berada di Afrika, pilih wilayah Eropa.
  • Jika Anda berada di Australia, pilih wilayah Asia Pasifik.

Jangan tentukan wilayah agen berdasarkan operator target Anda. Semua region memiliki akses yang sama ke operator di seluruh dunia.

Menentukan kategori penagihan agen

Saat membuat agen RCS for Business, Anda harus menentukan kategori penagihannya berdasarkan cara agen berinteraksi dengan pengguna. Pilih kategori yang paling sesuai dengan perilaku yang diinginkan agen Anda:

  • Percakapan (Conversational): Untuk agen yang melakukan percakapan bolak-balik dengan pengguna.
  • Pesan Dasar atau Pesan Tunggal: Untuk agen yang mengirim pesan tanpa mengharapkan balasan yang sering.

Anda hanya dapat mengubah kategori penagihan agen sebelum meluncurkannya. Jika Anda perlu mengubah kategori penagihan setelah peluncuran, hubungi tim dukungan RCS for Business.

Untuk mengetahui informasi selengkapnya tentang model penagihan standar RCS atau Business, lihat FAQ penagihan.

Mengidentifikasi kasus penggunaan agen

Setiap agen RCS for Business harus memiliki kasus penggunaan yang telah ditentukan sebelumnya. Tindakan ini membantu mengategorikan agen Anda dan menerapkan aturan bisnis yang tepat untuk pengalaman pengguna yang baik. RCS for Business mendukung empat kasus penggunaan:

  • OTP: Sandi sekali pakai yang diperlukan untuk mengautentikasi akun atau mengonfirmasi transaksi secara aman.
  • Transaksional: Notifikasi, pembaruan, atau pemberitahuan yang membagikan informasi yang relevan secara langsung dengan layanan atau produk yang sudah dimiliki pelanggan, seperti pemberitahuan untuk aktivitas akun yang mencurigakan, konfirmasi pembelian, dan notifikasi pengiriman.
  • Promosi: Pesan penjualan, pemasaran, dan promosi kepada pelanggan baru atau lama, dengan sasaran meningkatkan awareness, engagement, dan penjualan.
  • Penggunaan ganda: Percakapan yang menggabungkan pesan transaksional dan promosi, seperti mengirim notifikasi akun yang diikuti dengan penawaran diskon atau upgrade ke produk atau layanan baru.

Setiap kasus penggunaan memiliki aturan yang berbeda tentang apa yang dapat Anda kirim. Untuk mempelajari lebih lanjut setiap kasus penggunaan dan menemukan yang paling cocok untuk agen Anda, lihat Memilih kasus penggunaan yang tepat untuk agen Anda.

Setelah mengirimkan agen untuk peluncuran, Anda tidak dapat mengubah kasus penggunaan. Periksa kasus penggunaan dan aturan bisnis negara Anda sebelum mengirimkan agen Anda.

Membuat agen

Ikuti petunjuk berikut untuk membuat agen Anda di Konsol Developer RCS for Business.

Untuk membuat agen:

  1. Buka Konsol Developer RCS untuk Bisnis dan login dengan Akun Google partner RCS untuk Bisnis Anda.
  2. Di halaman beranda, klik + Create agent.
  3. Di jendela New RCS for Business agent, tentukan informasi berikut:
  4. Klik Create agent.

Setelah agen tersedia, Anda dapat menambahkan informasi bisnis dan branding. Lihat Membuat agen Anda.

Mengundang perangkat pengujian Anda

Setelah memiliki agen dan perangkat pengujian yang mendukung RCS, Anda dapat mengundang perangkat Anda untuk menguji agen.

  1. Di navigasi sebelah kiri, klik Perangkat.
  2. Untuk Tambahkan perangkat pengujian, masukkan nomor telepon perangkat Anda, lalu klik Tambahkan.
  3. Di perangkat pengujian, terima permintaan penguji untuk agen Anda.

Jika Anda tidak menerima undangan di perangkat pengujian, pastikan RCS diaktifkan di perangkat Anda.

Kirim pesan

Dengan perangkat pengujian terdaftar, agen Anda kini dapat mengirim pesan.

Anda memerlukan kunci akun layanan untuk mengautentikasi panggilan API secara aman. Jika Anda belum membuat kunci akun layanan untuk akun partner Anda, sekaranglah saatnya untuk melakukannya.

Di terminal pada mesin pengembangan Anda, jalankan perintah berikut:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  },
  "messageTrafficType": "PROMOTION"
}'
  • Ganti REGION dengan asia, europe, atau us, bergantung pada region agen Anda.
  • Ganti PHONE_NUMBER dengan nomor telepon perangkat pengujian Anda. Sertakan kode negara, kode area, dan awalan +, tetapi jangan sertakan pemisah. Misalnya, +14155555555.
  • Ganti AGENT ID dengan ID agen Anda, yang ada di halaman Informasi agen di Konsol Developer RCS for Business.
  • Ganti PATH_TO_SERVICE_ACCOUNT_KEY dengan jalur ke kunci yang Anda buat sebelumnya.

Anda akan menerima pesan "Hello, world!" dari agen di perangkat pengujian. Jika Anda tidak menerima pesan di perangkat pengujian, pastikan Anda memasukkan dan memformat nomor telepon dan jalur ke kunci akun layanan dengan benar dalam perintah.

Untuk mengirim berbagai jenis pesan, seperti balasan yang disarankan dan kartu multimedia, lihat Mengirim pesan.

Langkah berikutnya

Setelah agen Anda dapat mengirim pesan ke perangkat pengujian, saatnya membuat sesuatu yang sesuai dengan kebutuhan bisnis Anda. Dapatkan agen contoh dalam bahasa pilihan Anda dan ikuti petunjuk di README contoh.

Setelah mengonfigurasi agen contoh, tinjau praktik terbaik RCS for Business dan pelajari cara agen mengirim dan menerima pesan.

Sebelumnya
Menyiapkan akun partner