Buat agen pertama Anda

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.

Alur pesan melalui percakapan yang mengaktifkan RBM

Prasyarat

Sebelum memulai agen, Anda memerlukan item berikut:

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

  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

RBM API mendukung tiga endpoint regional untuk membantu bisnis mematuhi persyaratan regional dan bisnis. Agen RBM dapat berada di salah satu dari tiga region:

  • Amerika Utara
  • Eropa
  • Asia Pasifik

Saat membuat agen, pilih region-nya berdasarkan peraturan, persyaratan, dan jarak dengan pengguna akhir yang berlaku. Perhatikan bahwa wilayah tidak spesifik per negara. ID ini mengidentifikasi area tempat agen Anda beroperasi. Google menggunakan informasi ini untuk menentukan tempat menyimpan data pesan dan cara merutekan traffic pesan dengan tepat.

Menentukan kategori penagihan agen

Operator yang menyetujui konten RBM di jaringan mereka juga menagih untuk mengirimkan pesan RBM kepada pelanggan mereka menggunakan framework penagihan ini:

  • Percakapan - Tagihan untuk percakapan yang terdiri dari beberapa pesan A2P dan P2A dalam jangka waktu tertentu.
  • Pesan Tunggal - Tagihan untuk satu pesan yang berisi konten RBM lengkap (seperti pesan yang berisi Kartu Informasi atau Carousel).
  • Pesan Dasar - Biaya untuk pesan teks biasa hingga 160 karakter.

Saat membuat agen, pilih kategori penagihan yang paling sesuai dengan perilaku logika agen Anda:

  • Percakapan - Agen ini terlibat dalam interaksi pengguna yang kompleks dengan pesan yang dipertukarkan dalam kedua arah.

Dua kategori berikut tidak pernah membuat peristiwa penagihan percakapan. Operator akan mengenakan harga Pesan Dasar atau Pesan Tunggal untuk setiap pesan, bergantung pada konten yang dikirim.

  • Pesan Tunggal - Agen ini umumnya mengirim pesan lengkap dan jarang mengharapkan untuk menerima balasan.
  • Pesan Dasar - Agen ini menerapkan upgrade SMS ke RBM dan jarang mengharapkan untuk menerima balasan. Secara umum, agen diharapkan mengirim pesan teks biasa hingga 160 karakter. Namun, agen tidak dibatasi; agen dapat mengirim konten yang lebih kaya jika diprogram untuk melakukannya, dan akan ditagih sesuai dengan itu.

Anda dapat mengubah kategori penagihan agen sebelum meluncurkannya. Hubungi kami untuk membahas perubahan ke kategori penagihan lain.

Mengidentifikasi kasus penggunaan agen

Setiap agen RBM diwajibkan untuk memiliki kasus penggunaan standar yang mencerminkan sifat percakapan yang dimaksudkan untuk dilakukan dengan pengguna akhir dan untuk membantu bisnis mematuhi aturan bisnis. RBM mendukung empat kasus penggunaan:

  • OTP: Sandi sekali pakai yang diperlukan untuk mengautentikasi akun dengan aman atau mengonfirmasi transaksi
  • Transaksi: Notifikasi, pembaruan, atau pemberitahuan untuk membagikan informasi yang relevan langsung dengan layanan atau produk yang ada milik 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 tujuan untuk meningkatkan awareness, engagement, dan penjualan.
  • Multi-penggunaan: Alur percakapan yang menggabungkan kasus penggunaan transaksional dan promosi, seperti mengirim notifikasi akun, lalu menawarkan diskon atau upgrade untuk produk dan layanan baru.

Lihat Memilih kasus penggunaan yang tepat untuk mengetahui penjelasan yang lebih menyeluruh tentang kapan harus menggunakan setiap kasus penggunaan.

Anda tidak dapat mengubah kasus penggunaan setelah agen dikirim untuk peluncuran. Pastikan untuk meninjau kasus penggunaan dan aturan bisnis untuk negara Anda sebelum mengirimkan agen.

Membuat agen

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

  1. Buka Business Communications Developer Console, lalu login dengan Akun Google partner RBM Anda.
  2. Klik Buat agen.
  3. Untuk Jenis agen, pilih RCS Business Messaging.
  4. Untuk Merek, pilih merek yang akan diwakili agen Anda, atau klik Tambahkan merek baru dan masukkan namanya.
  5. Masukkan nama agen, lalu pilih wilayah, kategori penagihan, dan kasus penggunaan agen Anda. Kemudian, klik Create agent.
  6. Jika agen Anda tersedia, klik nama agen Anda.

Setelah agen tersedia, Anda dapat menambahkan informasi bisnis dan branding. Lihat 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 untuk 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, +14155555555.
  • 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 serta menerima pesan.

Sebelumnya
Menyiapkan akun partner