Buat agen pertama Anda

Agen Entitas terprogram yang mengirim pesan kepada pengguna atas nama brand. Agen menyertakan antarmuka apa pun yang berinteraksi dengan pengguna dan kode atau infrastruktur apa pun yang diperlukan untuk mendukung interaksi. Agen dapat memberikan pengalaman satu arah yang sederhana, seperti mengirim notifikasi, atau dapat bersifat percakapan dan bereaksi terhadap respons pengguna dalam pertukaran bolak-balik.

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

Prasyarat

Sebelum memulai agen, Anda memerlukan item berikut:

• Nama merek yang akan diwakili agen Anda
• Agen Anda
  • Nama
  • Region tempat agen akan beroperasi
  • Kategori penagihan
  • Kasus penggunaan
• Perangkat Android dengan nomor telepon aktif
• Mesin pengembangan yang dapat menjalankan kode contoh

Menyiapkan perangkat pengujian

Untuk berkomunikasi dengan agen RBM yang belum diluncurkan, perangkat pengujian harus didukung RCS, tetapi tidak semua perangkat Android dapat menerima pesan RCS secara default. Anda dapat memeriksa status RCS perangkat dan, jika perlu, mengaktifkan RCS dengan mengonfigurasi perangkat Anda dengan versi pra-rilis aplikasi Message dan Carrier Services.

Memeriksa status RCS perangkat Anda

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

2. Ketuk Fitur chat, lalu temukan nilai Status.

   Jika Status Terhubung, RCS aktif di perangkat Anda.

Langkah berikutnya

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

Menyiapkan agen

Agen RBM 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.

Mengidentifikasi wilayah agen

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

Saat membuat agen, pilih region 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 pengguna yang Anda targetkan tidak sesuai dengan region tersebut, pilih region 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 menentukan wilayah agen berdasarkan maskapai target Anda. Semua region memiliki akses yang sama ke operator di seluruh dunia.

Catatan: Anda tidak dapat mengubah region agen setelah membuat agen.

Menentukan kategori penagihan agen

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

• Percakapan: Untuk agen yang terlibat dalam percakapan multi-giliran dengan pengguna.
• Pesan Dasar atau Pesan Tunggal: Untuk agen yang mengirim pesan tanpa mengharapkan balasan yang sering.

Catatan: Dua kategori penagihan non-percakapan, Pesan Dasar dan Pesan Tunggal, berfungsi dengan cara yang sama persis. Ini adalah sedikit keanehan historis yang kami coba sederhanakan. Untuk saat ini, jangan ragu untuk menggunakan salah satu kategori untuk pesan non-percakapan Anda, baik teks biasa maupun kartu informasi. Anda akan ditagih tarif non-percakapan standar. Untuk informasi selengkapnya, lihat Kategori penagihan agen.

Anda hanya dapat mengubah kategori penagihan agen sebelum meluncurkannya. Kirim email ke [e-mail] jika Anda perlu mengubah kategori penagihan setelah peluncuran.

Untuk mengetahui informasi selengkapnya tentang model penagihan RBM, lihat FAQ penagihan RBM.

Mengidentifikasi kasus penggunaan agen

Setiap agen RBM harus memiliki kasus penggunaan yang telah ditentukan. Hal ini membantu mengategorikan agen Anda dan menerapkan aturan bisnis yang tepat untuk pengalaman pengguna yang baik. RBM mendukung empat kasus penggunaan:

• OTP: Sandi sekali pakai yang diperlukan untuk mengautentikasi akun dengan aman atau mengonfirmasi transaksi.
• Transaksi: Notifikasi, pembaruan, atau pemberitahuan yang membagikan informasi yang relevan secara langsung dengan layanan atau produk pelanggan yang ada, seperti pemberitahuan untuk aktivitas akun yang mencurigakan, konfirmasi pembelian, dan notifikasi pengiriman.
• Promosi: Pesan penjualan, pemasaran, dan promosi kepada pelanggan baru atau yang sudah ada, dengan tujuan meningkatkan awareness, engagement, dan penjualan.
• Multi-penggunaan: Percakapan yang menggabungkan pesan transaksional dan promosi, seperti mengirim notifikasi akun yang diikuti dengan penawaran diskon atau mengupgrade 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 sesuai untuk agen Anda, lihat Memilih kasus penggunaan yang tepat untuk agen Anda.

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

Membuat agen

Ikuti petunjuk ini untuk membuat agen di Business Communications Developer Console.

Catatan: Untuk membuat agen menggunakan RBM Management API, lihat dokumentasi Mengelola agen.

Untuk membuat agen:

1. Buka Konsol Developer Business Communications dan login dengan Akun Google partner RBM Anda.
2. Di halaman beranda, klik + Buat agen.
3. Di jendela New RCS Business Messaging agent, tentukan informasi berikut:
   • Merek yang diwakili oleh agen Anda
   • Nama agen
   • Wilayah hosting
   • Kategori penagihan
   • Kasus penggunaan
4. Klik Buat agen.

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

Mengundang perangkat pengujian

Setelah memiliki agen dan perangkat pengujian yang mengaktifkan RCS, Anda dapat mengundang perangkat 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 dengan aman. Jika Anda belum membuat kunci akun layanan untuk akun partner, sekarang saatnya melakukannya.

Di terminal pada mesin pengembangan, 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!"
  }
}'

• 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 + awal, tetapi jangan sertakan pemisah. Misalnya, [phone].
• Ganti AGENT ID dengan ID agen Anda, yang terletak di halaman Informasi agen di Konsol Developer Komunikasi Bisnis.
• Ganti PATH_TO_SERVICE_ACCOUNT_KEY dengan jalur ke kunci yang Anda buat sebelumnya.

Anda akan menerima pesan "Halo, dunia!" dari agen di perangkat pengujian. Jika Anda tidak menerima pesan di perangkat pengujian, pastikan Anda telah 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 yang kaya, lihat Mengirim pesan.

Langkah berikutnya

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

Setelah mengonfigurasi agen contoh, tinjau praktik terbaik RBM dan pelajari cara agen mengirim dan menerima pesan.