Konsol Developer Komunikasi Bisnis

Business Messages menyediakan antarmuka pengguna web yang disebut Konsol Developer Business Communications. Anda dapat menggunakan konsol ini untuk membuat, mengelola, dan meluncurkan agen.

Konsol Developer Business Communications berbeda dengan Google Cloud Platform. Konsol GCP (GCP). Anda dapat menggunakan Konsol Developer Business Communications untuk mengelola agen Business Messages, sementara Anda menggunakan GCP Console untuk mengelola setelan khusus GCP (misalnya, penagihan dan API) dan resource GCP lainnya.

Meskipun Anda dapat menggunakan Konsol Developer Business Communications untuk membuat dan mengelola agen, Anda juga dapat menggunakan Business Communications API untuk membuat dan mengelola agen untuk skenario lanjutan seperti integrasi ke produk Anda sendiri.

Panduan memulai dan petunjuk membantu Anda melakukan langkah-langkah menggunakan konsol dan API. Halaman ini menyediakan ringkasan tingkat tinggi tata letak antarmuka pengguna dan tujuan penggunaan konsol.

Cara konsol digunakan

Konsol digunakan untuk membuat, mengelola, memperbarui, memverifikasi, dan meluncurkan agen Anda. Dengan ini, Anda dapat

  • Konfigurasikan setelan webhook dan akun partner lainnya.
  • Buat dan kelola agen, yang berisi semua properti dan data yang menentukan representasi percakapan merek.
  • Konfigurasikan setelan agen non-lokal dan ketersediaan pesan.
  • Membuat dan mengelola lokasi yang mewakili lokasi fisik untuk bisnis.
  • Ambil URL pengujian agen dan lokasi untuk melihat bagaimana percakapan dengan agen Anda ditampilkan kepada pengguna.
  • Integrasikan dengan Dialogflow untuk menjawab pertanyaan umum (FAQ).
  • Verifikasi agen dan lokasi Anda.
  • Luncurkan agen dan lokasi Anda.

Layar utama konsol

Saat pertama kali memuat konsol, Anda akan melihat layar pilihan agen. Dari halaman ini, link Setelan akun partner akan membuka halaman setelan akun partner Anda.

Selain itu, layar utama digunakan untuk:

  • Pilih agen yang ada.
  • Membuat agen baru.
  • Mengurutkan agen.
  • Filter agen menurut akun partner.

Secara default, agen ditampilkan dalam tampilan kartu. Agen diurutkan ketika terakhir diperbarui. Untuk beralih ke tampilan daftar, gunakan opsi Lihat sebagai di sebelah kanan. Dengan tampilan daftar, agen dapat diurutkan menurut nama, jenis, status, dan tanggal terakhir diperbarui.

Jika Anda memiliki beberapa akun partner, tersedia pemilih dropdown akun partner yang dapat digunakan untuk memfilter pilihan agen berdasarkan akun partner.

Setelan akun

Dari halaman Setelan, Anda dapat memperbarui:

  • Nama bisnis
  • Nama tampilan
  • Kontak dukungan teknis
  • Webhook

Di panel navigasi samping, Anda dapat mengakses pengelolaan merek dan pengguna serta akun layanan Anda.

Pengelolaan merek

Merek adalah bisnis, organisasi, atau grup. Agen adalah representasi percakapan dari suatu merek.

Gunakan halaman ini untuk menambahkan, mengedit, dan menghapus merek. Menghapus merek juga akan menghapus semua agen terkait. Merek tidak dapat dihapus jika terkait dengan agen yang diluncurkan.

Pengelolaan pengguna

Gunakan halaman ini untuk menambahkan dan menghapus akses ke akun partner terdaftar Anda. Untuk beralih akun, gunakan menu dropdown di menu navigasi atas.

Tambahkan pengguna

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

Pengguna baru dapat memiliki peran Pengelola atau Pembaca. Peran pengelola memiliki akses ke semua fungsi di konsol, sedangkan peran pembaca memberikan akses hanya baca ke informasi agen dan lokasi.

Saat Anda menambahkan pengguna baru, pengguna tersebut akan menerima email yang memberitahukan bahwa mereka sekarang memiliki akses ke akun partner.

Alamat email yang awalnya mendaftarkan akun partner memiliki peran Pemilik.

Menghapus pengguna

Untuk menghapus pengguna:

  1. Temukan pengguna yang ingin dihapus dalam daftar.
  2. Klik tombol .
  3. Pilih Hapus pengguna.
  4. Konfirmasi penghapusan.

Pengguna yang Anda hapus akan menerima notifikasi email yang memberitahukan bahwa pengguna tersebut tidak lagi memiliki akses ke akun.

Anda tidak dapat menghapus pengguna yang memiliki peran Pemilik. Untuk mengubah atau menghapus pemilik, Anda harus menghubungi dukungan.

Mengubah peran pengguna

Untuk memperbarui peran pengguna:

  1. Cari pengguna yang ingin diubah perannya.
  2. Klik tombol .
  3. Pilih Edit peran.
  4. Pilih peran baru dari menu drop-down.
  5. Klik Simpan.

Akun layanan

Saat melakukan panggilan ke Business Communications dan Business Messages API, Anda mengautentikasi panggilan dengan kunci akun layanan. Dengan kunci akun layanan, Anda dapat membuat dan mengelola merek, agen, dan lokasi, serta mengirim pesan dan permintaan sebagai agen.

Untuk membuat kunci akun layanan, pilih Service accounts dari navigasi samping. GCP Console untuk project GCP yang terkait dengan akun partner yang saat ini dipilih akan terbuka.

Untuk membuat akun layanan dan kunci:

  1. Klik Create service account.
  2. Untuk Nama akun layanan, masukkan nama agen Anda, lalu klik Buat.
  3. Klik Done.
  4. Temukan akun layanan baru di tabel, lalu klik > Buat kunci.
  5. Pilih JSON, lalu klik Buat.

Browser Anda mendownload kunci akun layanan.

Pilihan agen

Setelah memilih agen, Anda akan diarahkan ke halaman Ringkasan untuk agen yang dipilih.

Ringkasan menampilkan:

  • Nama brand
  • Nama agen
  • Akun partner yang dibuat oleh agen
  • ID Merek
  • ID Agen
  • URL pengujian agen yang memungkinkan Anda melihat tampilan percakapan dengan agen tersebut kepada pengguna dan memberi Anda kesempatan untuk memverifikasi infrastruktur pesan
  • Status verifikasi agen
  • Pratinjau agen
  • Lokasi yang terkait dengan agen
  • Link ke dokumentasi yang relevan

Navigasi kiri memungkinkan Anda mengakses hal berikut:

Informasi agen

Gunakan halaman informasi agen untuk memperbarui properti agen.

Halaman dibagi menjadi dua kolom. Gunakan kolom input di kolom sebelah kiri untuk memperbarui kolom agen seperti nama agen, logo, pesan selamat datang, pemicu percakapan, dan properti untuk lokasi dan titik entri non-lokal. Anda tidak dapat memperbarui beberapa kolom, seperti Nama agen dan Logo, setelah meluncurkan agen.

Gunakan kolom yang tepat untuk mendapatkan URL pengujian bagi agen Anda dan lihat pratinjau tampilan agen Anda di perangkat pengguna.

Pengelolaan lokasi

Gunakan halaman ini untuk menambahkan lokasi, mengambil URL pengujian untuk lokasi bisnis, dan memverifikasi lokasi setelah memverifikasi agen.

Integrasi

Gunakan halaman ini untuk mengintegrasikan dengan Dialogflow dan menyiapkan bot untuk menjawab pertanyaan umum (FAQ).

Survei

Gunakan halaman ini untuk menyesuaikan survei pelanggan agen Anda.

Log

Gunakan halaman ini untuk men-debug masalah pengiriman pesan. Log tersedia selama 14 hari. Filter menurut ID percakapan, ID pesan, stempel waktu, rute, atau status untuk menemukan log yang relevan dengan masalah pengguna. Anda juga dapat memeriksa halaman ini untuk memverifikasi bahwa Anda tidak mengirim pesan tidak valid secara tidak sengaja.

Log menyertakan payload pesan kecuali untuk kolom sensitif yang disamarkan, seperti konten teks pesan. Pesan yang gagal dan ditolak memiliki detail error tambahan untuk membantu proses debug.

Beberapa peristiwa, seperti indikator pengetikan, tidak memiliki laporan terkirim, dan statusnya ditampilkan sebagai "Terkirim".

Log debug yang menampilkan status Terkirim dan Gagal

Verifikasi

Gunakan halaman ini untuk mengirimkan agen Anda ke verifikasi.

Luncurkan

Gunakan halaman ini untuk meluncurkan agen Anda untuk lokasi dan titik entri non-lokal serta meluncurkan setiap lokasi.