Panduan pemecahan masalah RBM

Ikuti panduan ini untuk memberikan informasi yang diperlukan guna memecahkan masalah terkait RBM.

Masalah pengiriman dan format pesan

Ini adalah masalah dengan transmisi dan penerimaan pesan yang sebenarnya, termasuk masalah pemformatan pesan.

Tidak dapat mengirim pesan RBM

Bagikan sebanyak mungkin detail berikut untuk mempercepat pemecahan masalah:

  • Contoh ID pesan dengan stempel waktu
  • ID Partner (lihat screenshot)
  • Jumlah agen yang terpengaruh
  • ID agen (dipisahkan koma)
  • Perkiraan jumlah pesan yang terpengaruh atau berpotensi terpengaruh
  • Metode API yang bermasalah (misalnya: upload file, buat pesan agen ke pengguna, buat peristiwa agen ke pengguna, hapus pesan agen ke pengguna, dapatkan kemampuan, ambil batch)
  • Contoh payload JSON permintaan yang gagal
  • Untuk masalah klien: Laporan bug klien

  • Log error (error yang terlihat di terminal saat memanggil RBM API), termasuk kode error dan pesan error. Contoh:

    "error": {
"code": 403,
"message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
"status": "PERMISSION_DENIED",
}

    Tidak menerima peristiwa atau pesan di webhook

Agar pengiriman pesan lancar, pastikan semua webhook agen akun partner Anda berfungsi dengan benar dan dapat memproses pesan dari Google. Semua agen di akun partner berbagi satu channel untuk pesan dan acara masuk, sehingga webhook yang tidak berfungsi dapat mengganggu pengiriman untuk semua agen.

Jika masalah berlanjut, bagikan detail berikut untuk memungkinkan pemecahan masalah yang lebih cepat:

  • Kapan masalah mulai terjadi? Apakah Anda menerima pesan dan peristiwa dengan berhasil sebelum itu?
  • ID Partner
  • ID Agen
  • URL webhook
  • ID pesan dengan stempel waktu

Pesan RBM dikirim sebagai JSON atau dikonversi ke SMS

Bagikan sebanyak mungkin detail berikut untuk mempercepat pemecahan masalah:

  • ID pesan dengan stempel waktu
  • Payload JSON
  • Langkah-langkah perangkat untuk mereproduksi jika diketahui
  • Laporan bug dari perangkat yang menerima pesan
  • Detail tentang perangkat dan versi aplikasi pesan yang digunakan
  • Screenshot atau rekaman video masalah

Tidak dapat menerima pesan di perangkat yang kompatibel dengan RCS

Bagikan sebanyak mungkin detail berikut untuk mempercepat pemecahan masalah:

  • Laporan bug dari perangkat yang gagal menerima pesan RBM
  • Nomor telepon
  • Detail tentang perangkat dan OS
  • Versi aplikasi pesan yang digunakan
  • Langkah-langkah untuk merekonstruksi jika diketahui
  • Screenshot yang menampilkan status RCS
  • Screenshot atau rekaman video masalah
  • Nama dan negara operator

Masalah penyiapan/konektivitas klien dan perangkat

Masalah ini mencakup penyiapan, koneksi, dan masalah khusus platform di sisi klien.

Gagal membuat URL atau kode QR P2A

Bagikan sebanyak mungkin detail berikut untuk mempercepat pemecahan masalah:

Bagikan sebanyak mungkin detail berikut untuk mempercepat pemecahan masalah:

  • ID Agen
  • Nomor telepon
  • Langkah-langkah untuk merekonstruksi jika diketahui
  • Laporan bug dari perangkat tempat link dibuka
  • Screenshot atau rekaman video masalah

Masalah terkait pemeriksaan kemampuan

Bagikan detail berikut untuk memungkinkan pemecahan masalah yang lebih cepat:

  • Daftar nomor telepon dengan kode negara yang disertakan dalam file CSV
  • ID Agen
  • Log error
  • Status RCS perangkat
  • Tanggal dan waktu pengujian dilakukan

Perangkat pengujian tidak menerima undangan atau pesan penguji

Ikuti langkah-langkah dari Menyiapkan perangkat pengujian.

Jika masalah berlanjut, bagikan detail berikut untuk memungkinkan pemecahan masalah yang lebih cepat:

  • ID Agen
  • Nomor telepon
  • ID pesan dengan stempel waktu
  • Laporan bug dalam waktu 5 menit setelah mengirim undangan pengujian

Masalah RCS/RBM di perangkat iOS

Meskipun Apple telah mengadopsi standar Rich Communication Services (RCS) untuk pengiriman pesan, mereka memilih untuk mengembangkan implementasi unik mereka sendiri. Hal ini mencakup fitur seperti RCS Business Messaging (RBM).

Jika Anda mengalami masalah terkait RBM di perangkat iOS, sebaiknya laporkan masalah tersebut langsung ke Apple melalui aplikasi Asisten Masukan. Hal ini akan membantu Apple mengidentifikasi dan mengatasi masalah apa pun yang khusus untuk penerapan mereka.

  1. Buka aplikasi Asisten Masukan di perangkat iOS.
  2. Pilih topik awal yang sesuai, yang terkait dengan masalah pada aplikasi pesan.
  3. Tulis dan kirim masukan Anda.
  4. Agar tim Dukungan RBM tetap mengetahui perkembangan, harap bagikan temuan Anda kepada kami. Kami menghargai bantuan Anda dalam meningkatkan kualitas pengalaman RCS bagi semua orang.

Ketersediaan operator RCS/RBM di perangkat iOS

Apple memiliki pilihan operator sendiri untuk peluncuran RCS/RBM di iOS. Untuk menanyakan ketersediaan global atau rencana Apple pada masa mendatang, hubungi Apple secara langsung. Anda juga dapat menghubungi operator yang Anda minati untuk menanyakan status peluncuran RCS/RBM mereka di iOS.

Untuk menemukan informasi tentang dukungan dan fitur operator nirkabel untuk iPhone menurut negara, buka halaman dukungan Apple.

Masalah performa dan tampilan

Berikut adalah masalah terkait performa dan tampilan RBM.

Latensi dalam melakukan tindakan RBM

Jangan lupa untuk memeriksa hal berikut terlebih dahulu:

Pertanyaan Rekomendasi
Apakah latensinya <5s? Jika demikian, hal ini berada dalam rentang yang dapat diterima.
Apakah ada regresi dalam latensi? Jika ya, kapan dimulai? Berapa latensi biasanya sebelum dibandingkan dengan sekarang?
Apakah Anda menggunakan API upload file? Coba gunakan ID file, bukan mengirim URL langsung. Pemrosesan URL media baru melibatkan download, pemrosesan, thumbnail, perlindungan dari penyalahgunaan, dan perlindungan dari virus. Perlindungan dari virus membutuhkan waktu sekitar 50% dari total waktu pemrosesan.
Sudahkah Anda mengupload media pesan di awal? Untuk mempercepat pemrosesan, sebaiknya lakukan dengan panggilan API berikut: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create
Sudahkah Anda menjalankan pemeriksaan kemampuan? Untuk mengurangi latensi dalam mengirim pesan kepada pengguna yang tidak dapat dijangkau melalui RCS, jalankan pemeriksaan kemampuan terlebih dahulu.

Jika masalah berlanjut, berikan detail tambahan sebanyak mungkin untuk mempercepat pemecahan masalah:

  • Jumlah pesan yang terpengaruh
  • Sumber latensi (misalnya: upload file, buat pesan agen ke pengguna, buat peristiwa agen ke pengguna, hapus pesan agen ke pengguna, dapatkan kemampuan, ambil batch)
  • Endpoint layanan
  • Distribusi latensi (p50, p95, p99)
  • Perubahan latensi dan jangka waktu
  • ID Partner
  • ID agen yang terpengaruh
  • ID pesan dengan stempel waktu
  • Payload JSON

Contoh masalah ini mencakup kegagalan memuat, menampilkan layar hitam, pemangkasan, dan tindakan yang disarankan tidak muncul.

Bagikan sebanyak mungkin detail berikut untuk mempercepat pemecahan masalah:

  • ID pesan dengan stempel waktu
  • Payload JSON
  • Langkah-langkah perangkat untuk mereproduksi jika diketahui
  • Laporan bug dari perangkat yang menerima pesan
  • Detail tentang perangkat dan versi aplikasi pesan yang digunakan
  • Screenshot atau rekaman video masalah

Masalah pengelolaan akun, agen, dan ekspedisi

Masalah ini terkait dengan pengelolaan dan pelaporan akun, termasuk pertanyaan terkait penagihan.

Tidak dapat menambahkan penguji

Ikuti langkah-langkah dari Menyiapkan perangkat pengujian.

Jika masalah berlanjut, bagikan detail berikut untuk memungkinkan pemecahan masalah yang lebih cepat:

  • ID Agen
  • Nomor telepon
  • Nama dan negara operator

Operator tidak dapat menyetujui peluncuran agen

Laporkan masalah dari Konsol Administrasi RBM (lihat screenshot).

Untuk peluncuran mendesak, berikan:

  • Nama dan negara operator
  • ID agen yang akan diluncurkan
  • Otorisasi operator untuk peluncuran

Permintaan untuk memperbarui detail agen

Bagikan detail berikut untuk mengaktifkan update yang lebih cepat:

  • ID agen
  • Detail yang ingin Anda ubah
  • Konfirmasi Anda untuk membatalkan peluncuran agen

Untuk kolom berikut, tim Dukungan RBM akan membatalkan peluncuran agen. Kemudian, Anda dapat melakukan perubahan pada agen dan mengirim ulang untuk peluncuran.

  • Nama tampilan
  • Deskripsi
  • Warna
  • Gambar logo dan banner
  • Informasi kontak agen seperti nomor telepon, situs, dan alamat email
  • Privasi dan Persyaratan Layanan

Untuk kolom berikut, tim Dukungan RBM juga akan membatalkan peluncuran agen serta mengubah kolom (partner RBM tidak dapat mengubah kolom ini secara langsung):

  • Kategori penagihan
  • Kasus penggunaan
  • Nama merek
  • Nama kontak brand
  • ID email kontak brand
  • URL situs merek
  • Nama kontak partner penyedia fitur pesan
  • Email kontak partner penyedia fitur pesan

Jika Anda ingin mengubah informasi agen tanpa membatalkan peluncuran agen, dapatkan persetujuan email dari kontak di jaringan yang dikelola operator tempat agen saat ini diluncurkan. Setelah Anda mengumpulkan semua email persetujuan, bagikan email tersebut kepada tim Dukungan RBM, beserta detail modifikasi yang diperlukan.

Tim Dukungan RBM akan memverifikasi persetujuan dan, jika semuanya sudah sesuai, menerapkan perubahan dan mengonfirmasinya kepada Anda dan operator terkait. Perhatikan bahwa proses ini dapat bervariasi bergantung pada prosedur masing-masing operator di berbagai negara.

Meminta perubahan pada akun partner RBM

Jika partner RBM memiliki agen yang diluncurkan di jaringan yang dikelola operator, ikuti langkah-langkah berikut:

  1. Dapatkan persetujuan email dari kontak di jaringan yang dikelola operator tempat agen Anda diluncurkan.
  2. Bagikan detail berikut kepada Dukungan RBM:

Setelah memverifikasi persetujuan dan detailnya, tim Dukungan RBM akan memberi tahu operator tentang perubahan yang tertunda. Perubahan ini akan diterapkan dan dikonfirmasi dalam waktu 24 jam setelah notifikasi ekspedisi tersebut.

Permintaan untuk memigrasikan agen dari partner RBM A ke partner B

Jika agen sudah diluncurkan di jaringan yang dikelola operator, ikuti langkah-langkah berikut:

  1. Mendapatkan persetujuan email dari kontak merek dan kontak di jaringan yang dikelola operator.
    • Pastikan partner RBM baru disertakan dalam email persetujuan ini.
  2. Bagikan detail berikut kepada Dukungan RBM:
    • ID Agen
    • Persetujuan melalui email dari kontak brand dan operator
    • ID partner baru

Setelah memverifikasi persetujuan dan detailnya, tim Dukungan RBM akan memberi tahu operator tentang perubahan yang tertunda. Perubahan ini akan diterapkan dan dikonfirmasi dalam waktu 24 jam setelah notifikasi ekspedisi tersebut.

Permintaan untuk memigrasikan agen ke akun partner lain

Bagikan detail berikut untuk mengaktifkan update yang lebih cepat:

  • Daftar ID agen
  • ID partner lama
  • ID partner baru

Informasi tidak ada dalam laporan peristiwa penagihan

Bagikan detail berikut untuk memungkinkan pemecahan masalah yang lebih cepat:

  • Tanggal saat file tidak ada
  • ID Agen