Menetapkan ketersediaan fitur pesan

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

Jika pengguna mengirim pesan ke agen Anda selama jam buka, agen Anda akan menyapa pengguna dengan pesan selamat datang dan saran untuk memulai percakapan. Jika percakapan dimulai di luar jam buka, pengguna akan melihat pesan offline agen. Lihat Mulai percakapan untuk mengetahui informasi selengkapnya tentang pesan ini.

Ketersediaan bot dan manusia

Anda dapat menentukan ketersediaan perwakilan bot dan manusia secara terpisah.

Jika Anda memiliki otomatisasi apa pun yang menyusun pesan untuk agen Anda—baik otomatisasi tersebut berupa penjawab otomatis yang memberi tahu pengguna posisi mereka dalam antrean, agen natural language understanding yang kompleks yang memiliki akses dinamis ke detail pengguna, atau apa pun di antaranya—tentukan ketersediaan pesan bot.

Ketersediaan manusia adalah hal yang wajib 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 petugas, hanya tentukan hari dalam seminggu dan jam saat Anda memiliki petugas yang tersedia untuk menjawab pertanyaan.

Jika perwakilan bot tersedia 24 jam sehari, tetapi perwakilan manusia tersedia dari pukul 08.00 hingga 20.00, Anda dapat menentukannya secara terpisah.

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

Memperbarui ketersediaan fitur pesan

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

Saat memperbarui kolom ini, Anda harus menyertakan nilai untuk semua kolom dalam objek SupportedAgentInteraction. Permintaan pembaruan akan menggantikan konten semua kolom yang Anda edit, termasuk kolom turunan. Misalnya, jika Anda membuat permintaan untuk menambahkan instance ke hours, Anda juga harus menyertakan semua instance hours sebelumnya, jika tidak, pembaruan Anda akan menimpanya.

Prasyarat

Sebelum memperbarui ketersediaan pesan, Anda memerlukan item berikut:

  • Jalur ke kunci akun layanan project GCP Anda di mesin pengembangan

  • Agen name (misalnya, "brands/12345/agents/67890")

    Jika Anda tidak mengetahui name agen, lihat Mencantumkan semua agen untuk merek.

  • Zona waktu, hari dalam seminggu, dan jam ketersediaan bot

  • Zona waktu, hari dalam seminggu, dan jam ketersediaan petugas

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 pesan bot dan manusia, tentukan ketersediaan bot di primaryAgentInteraction dan ketersediaan manusia 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"
              }
            ]
          }
        }
      }
    ]
  }
}'

Khusus 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"
            }
          ]
        }
      }
    }
  }
}'

Khusus 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"
            }
          ]
        }
      }
    }
  }
}'

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