Daftar dengan Business Messages

Saat mendaftar sebagai partner dengan Business Messages, Anda dapat memungkinkan percakapan antara pengguna dan merek dengan membuat agen—entitas percakapan yang mewakili fungsi bisnis, seperti dukungan situs dan lokasi merek.

Agen: Representasi percakapan dari suatu merek, yang dikelola oleh partner. Mencakup antarmuka apa pun yang berinteraksi dengan pengguna dan kode atau infrastruktur apa pun yang diperlukan untuk mendukung interaksi.

Saat pengguna menemukan merek yang Anda kelola di Google Penelusuran atau Google Maps, hasil penelusuran akan menampilkan opsi Chat. Saat mengklik Chat, pengguna dapat mengirim pesan ke agen merek. Agen memungkinkan Anda menerima dan membalas pesan pengguna.

Daftar sebagai partner

Dengan mendaftar sebagai partner dalam Business Messages, membuat agen untuk merek, dan memanfaatkan API yang mendukung agen, Anda dapat mengaktifkan pengalaman pengiriman pesan untuk layanan pelanggan, penjualan, dan aplikasi bisnis lainnya.

1. Buka Konsol Developer Komunikasi Bisnis.
2. Di bagian Business Messages, klik Create partner account.

3. Masukkan nilai untuk informasi partner:

   Kolom	Nilai
   Nama Anda	Nama lengkap Anda
   Nama partner	Nama organisasi Anda
   Situs partner	Situs organisasi Anda
   Region	Wilayah tempat Anda ingin menghosting layanan Business Messages

Catatan: Untuk meluncurkan agen produksi dengan Business Messages, Anda harus mendaftar dengan email perusahaan, bukan email pribadi.

1. Tinjau dan setujui Persyaratan Layanan Business Messages.

2. Klik Buat.

Anda kini terdaftar sebagai partner Business Messages dan memiliki akses ke Business Messages dan Business Communications API. Business Messages API mengirimkan pesan kepada pengguna, sedangkan Business Communications API mengelola agen.

Membuat akun layanan

Untuk mengautentikasi panggilan API ke Business Messages dan Business Communications API dengan aman, Anda memerlukan kunci akun layanan dan alat command line oauth2l.

1. Di halaman beranda Konsol Developer Komunikasi Bisnis, klik Setelan akun partner.
2. Di navigasi sebelah kiri, klik Akun layanan.

3. Klik Create key, lalu klik Create.

   Browser Anda mendownload kunci akun layanan. Simpan kunci akun layanan Anda di lokasi pribadi yang aman. Jangan bagikan kunci Anda secara publik. Anda akan memerlukan kunci ini nanti untuk mengakses Business Messages dan Business Communication API.

Catatan: Jika Anda adalah partner Business Messages dengan akun GCP milik sendiri, Anda dapat mengakses kunci akun layanan di Google Cloud Console.

Menyetel webook

Setelah Business Messages dan Business Communications API diaktifkan, Anda harus menentukan URL webhook untuk mulai menerima pesan.

1. Buka Setelan akun di Konsol Developer Komunikasi Bisnis.
2. Pastikan akun partner yang benar dipilih.
3. Untuk URL webhook Business Messages, klik Konfigurasikan.
4. Untuk URL endpoint webhook, masukkan URL webhook Anda, dimulai dengan "https://".
5. Catat nilai clientToken Anda. Anda memerlukannya untuk memverifikasi bahwa pesan yang Anda terima berasal dari Google.

6. Konfigurasikan webhook Anda untuk menerima permintaan POST dengan parameter clientToken yang ditentukan dan kirim respons 200 OK dengan nilai teks biasa dari parameter secret sebagai isi respons.

   Misalnya, jika webhook Anda menerima permintaan POST dengan konten isi berikut

   {
     "clientToken":"SJENCPGJESMGUFPY",
     "secret":"0123456789"
   }
   

   webhook Anda harus mengonfirmasi nilai clientToken dan, jika clientToken benar, menampilkan respons 200 OK dengan 0123456789 sebagai isi respons.

7. Di konsol, klik Verifikasi.

   Saat Business Messages memverifikasi webhook Anda, dialog akan ditutup.

Lihat Contoh: Perbarui URL webhook untuk melihat cara mengonfigurasi webhook dengan Business Communication API.

Dapatkan informasi partner

Untuk mendapatkan informasi partner saat ini, Anda dapat membuat kueri Business Communications API dengan ID Partner.

Jalankan perintah berikut. Ganti PARTNER_ID dengan ID Partner Anda.

# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
get-partner.sh

Memperbarui informasi partner

Untuk memperbarui informasi partner, Anda dapat menggunakan halaman Setelan akun di Business Communications Developer Console atau menjalankan perintah berikut.

Ganti PARTNER_ID dengan ID Partner Anda(ID Partner dapat ditemukan di Konsol Developer Komunikasi Bisnis), dan ganti UPDATED_FIELDS dengan nama kolom yang Anda perbarui.

# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'
update-partner.sh

Untuk opsi pemformatan dan nilai, lihat partners.patch.

Contoh: Perbarui nama tampilan

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

Contoh: Perbarui URL webhook

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

Langkah berikutnya

Setelah Anda menjadi partner terdaftar dan telah mengaktifkan API, Anda dapat mulai mengembangkan aplikasi dengan Business Messages. Untuk memulai dengan cepat, lihat Membuat agen pertama.

Jika tidak, pelajari cara membuat agen untuk mewakili merek Anda dalam percakapan dan mengonfigurasi webhook Anda untuk menerima pesan dari pengguna.