Halaman ini diterjemahkan oleh Cloud Translation API.

Menetapkan ketersediaan fitur pesan

Sebelum pengguna dapat memulai percakapan dengan agen Anda, Anda harus menetapkan ketersediaan pesan agen di Business Messages.

Jika pengguna mengirim pesan ke agen selama jam yang tersedia, agen akan menyambut pengguna dengan pesan selamat datang dan pembuka percakapan. Jika percakapan dimulai di luar jam yang tersedia, pengguna akan melihat pesan offline agen. Baca artikel Memulai percakapan untuk mengetahui informasi selengkapnya tentang pesan tersebut.

Ketersediaan bot dan manusia

Anda dapat menentukan ketersediaan bot dan perwakilan manusia yang terpisah.

Jika Anda memiliki jenis penulisan pesan otomatis untuk agen Anda—baik otomatisasi tersebut merupakan penjawab otomatis yang memberi tahu pengguna tempat mereka dalam antrean, agen pemahaman bahasa alami yang kompleks, yang memiliki akses dinamis ke detail pengguna, atau apa pun di antaranya—tentukan ketersediaan pesan bot.

Ketersediaan manusia wajib diisi jika Anda ingin meluncurkan agen di titik entri yang dikelola Google, termasuk titik entri berbasis lokasi dan titik entri non-lokal (kecuali untuk Google Ads). Untuk ketersediaan khusus, hanya tentukan hari dan jam yang menyediakan agen langsung untuk menjawab pertanyaan.

Jika perwakilan bot tersedia 24 jam sehari, tetapi perwakilan manusia tersedia dari pukul 8 pagi hingga 8 malam, Anda dapat menentukannya secara independen.

Selain itu, jika menentukan bot dan ketersediaan manusia, Anda dapat mengirim saran permintaan agen langsung untuk meminta pengguna meminta agen langsung jika perwakilan bot tidak dapat memenuhi kebutuhan mereka.

Memperbarui ketersediaan fitur pesan

Untuk memperbarui ketersediaan pesan, buat permintaan PATCH dengan Business Communications API untuk memperbarui kolom primaryAgentInteraction dan additionalAgentInteractions agen.

Saat memperbarui kolom ini, Anda harus menyertakan nilai untuk semua kolom di objek SupportAgentInteraction. Permintaan update akan menimpa konten semua kolom yang Anda edit, termasuk kolom turunan. Misalnya, jika membuat permintaan untuk menambahkan instance ke hours, Anda juga harus menyertakan semua instance hours sebelumnya. Jika tidak, update Anda akan menimpanya.

Prasyarat

Sebelum memperbarui ketersediaan fitur pesan, Anda memerlukan item berikut:

Jalur ke kunci akun layanan project GCP di mesin pengembangan Anda
Agen name (misalnya, "brands/12345/agents/67890")

Jika Anda tidak mengetahui name agen, lihat Membuat daftar semua agen untuk merek.
Zona waktu ketersediaan bot, hari, dan jam
Zona waktu ketersediaan, hari, dan jam ketersediaan manusia

Jika Anda tidak mengetahui nilai primaryAgentInteraction dan additionalAgentInteractions saat ini, lihat Mendapatkan informasi agen.

Mengirim permintaan pembaruan

Untuk mengupdate agen, jalankan perintah berikut. Ganti variabel dengan nilai yang Anda identifikasi di Prasyarat.

Jika Anda memiliki ketersediaan bot dan pengiriman pesan manual, tentukan ketersediaan bot di primaryAgentInteraction dan ketersediaan manual di instance additionalAgentInteractions.

Bot dan manusia


# This code updates the agent interaction of a bot and human representatives.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction,businessMessagesAgent.additionalAgentInteractions" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "BOT",
      "botRepresentative": {
        "botMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    },
    "additionalAgentInteractions": [
      {
        "interactionType": "HUMAN",
        "humanRepresentative": {
          "humanMessagingAvailability": {
            "hours": [
              {
                "startTime": {
                  "hours": 8,
                  "minutes": 0
                },
                "endTime": {
                  "hours": 20,
                  "minutes": 0
                },
                "timeZone": "America/Los_Angeles",
                "startDay": "MONDAY",
                "endDay": "SUNDAY"
              }
            ]
          }
        }
      }
    ]
  }
}'update-agent-bm-agentInteractions-bot-and-human.sh

Hanya bot


# This code updates the primary agent interaction of a bot representative
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "BOT",
      "botRepresentative": {
        "botMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    }
  }
}'update-agent-bm-agentInteractions-bot.sh

Hanya manusia


# This code updates the primary agent interaction of a human representative
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "HUMAN",
      "humanRepresentative": {
        "humanMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    }
  }
}'update-agent-bm-agentInteractions-human.sh

Untuk opsi pemformatan dan nilai, lihat brands.agents.patch dan SupportedAgentInteraction.