Mendaftar ke Business Messages

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

Agen: Representasi percakapan dari sebuah brand, yang dikelola oleh partner. Mencakup semua berinteraksi dengan pengguna dan kode atau infrastruktur apa pun yang diperlukan untuk memberdayakan untuk berinteraksi.

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

Mendaftar sebagai partner

Dengan mendaftar sebagai partner di Business Messages, membuat agen untuk brand, serta memanfaatkan API yang mendukung agen Anda, Anda dapat mengaktifkan pesan untuk layanan pelanggan, penjualan, dan aplikasi bisnis lainnya.

1. Buka Konsol Developer Komunikasi Bisnis.
2. Pada Business Messages, klik Buat akun partner.

3. Masukkan nilai untuk informasi partner Anda:

   Kolom	Nilai
   Nama Anda	Nama lengkap Anda
   Nama partner	Nama organisasi Anda
   Situs partner	Situs organisasi Anda
   Wilayah	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 mengirim pesan kepada pengguna, sedangkan Business Communications API mengelola agen.

Membuat akun layanan

Untuk mengautentikasi panggilan API dengan aman ke Business Messages dan Business Communications API, Anda memerlukan kunci akun layanan dan 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 akan mendownload kunci akun layanan. Simpan kunci akun layanan Anda di lokasi yang aman dan bersifat pribadi. Larangan bagikan kunci Anda secara publik. Anda akan memerlukan kunci ini nanti untuk mengakses Business Message API dan Business Communication API.

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

Setel webook

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

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

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

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

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

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

7. Di konsol, klik Verifikasi.

   Saat Business Messages memverifikasi webhook Anda, dialog akan ditutup.

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

Mendapatkan informasi partner

Untuk mendapatkan informasi partner saat ini, Anda dapat mengkueri bisnis Communications API dengan ID Partner Anda.

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

Perbarui informasi partner

Untuk memperbarui informasi partner, Anda dapat menggunakan halaman Setelan akun di Konsol Developer Komunikasi Bisnis atau menjalankan perintah berikut.

Ganti PARTNER_ID dengan ID Partner Anda(ID Partner dapat ditemukan di Konsol Developer Business Communications), 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: Memperbarui 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: Memperbarui 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 menjadi mitra terdaftar dan telah mengaktifkan API, Anda dapat mulai berkembang dengan Business Messages. Untuk memulai dengan cepat, lihat Buat agen pertama Anda.

Atau, pelajari cara membuat agen untuk mewakili brand Anda dalam percakapan dan mengonfigurasi webhook Anda untuk menerima pesan dari pengguna.