Menetapkan ketersediaan fitur pesan

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

Jika pengguna mengirim pesan kepada agen selama jam yang tersedia, agen akan menyapa pengguna tersebut dengan pesan selamat datang dan pembuka percakapan. Jika percakapan dimulai di luar jam yang tersedia, pengguna akan melihat pesan offline agen. Lihat Mulai tindakan percakapan untuk mengetahui informasi selengkapnya tentang pesan ini.

Ketersediaan manusia dan bot

Anda dapat menentukan bot dan robot terpisah representasi ketersediaan tinggi.

Jika Anda memiliki sistem penulisan pesan otomatis untuk agen — apakah otomatisasi adalah pemberi respons otomatis yang memberi tahu pengguna antrean, agen natural language understanding kompleks yang memiliki akses dinamis detail pengguna, atau apa pun di antaranya—menentukan ketersediaan pesan bot.

Ketersediaan manusia adalah suatu keharusan jika Anda ingin meluncurkan agen di titik entri, termasuk titik entri berbasis lokasi dan titik entri non-lokal (kecuali untuk Google Ads). Untuk ketersediaan manusia, hanya tentukan hari dan jam kerja agen langsung untuk menjawab pertanyaan.

Jika perwakilan bot tersedia 24 jam sehari tetapi perwakilan manusia tersedia dari pukul 08.00 hingga 20.00, Anda dapat menentukan mereka dapat bekerja secara mandiri.

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

Memperbarui ketersediaan fitur pesan

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

Saat memperbarui kolom ini, Anda harus menyertakan nilai untuk semua kolom di DidukungAgentInteraction. Permintaan pembaruan akan menimpa konten semua kolom yang diedit, termasuk kolom turunan. Misalnya, jika Anda membuat permintaan untuk menambahkan instance ke hours, Anda harus menyertakan semua hours sebelumnya instance lama, jika tidak, update Anda akan menimpanya.

Prasyarat

Sebelum memperbarui ketersediaan fitur 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 brand.

  • Zona waktu, hari, dan jam ketersediaan bot

  • Zona waktu, hari, dan jam ketersediaan manusia

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

Mengirim permintaan pembaruan

Untuk mengupdate agen, jalankan perintah berikut. Mengganti variabel dengan nilai yang Anda identifikasi dalam Prasyarat.

Jika Anda memiliki ketersediaan bot dan pesan manusia, tentukan ketersediaan bot di primaryAgentInteraction dan ketersediaan manusia dalam 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

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"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-bot.sh

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"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-human.sh

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