ตั้งค่าความพร้อมใช้งานของการรับส่งข้อความ

ก่อนที่ผู้ใช้จะเริ่มการสนทนากับตัวแทนได้ คุณต้องตั้งค่า ความพร้อมใช้งานของการรับส่งข้อความของตัวแทนใน Business Messages

หากผู้ใช้ส่งข้อความถึงตัวแทนในช่วงเวลาที่พร้อมให้บริการ ตัวแทนจะทักทายผู้ใช้ ด้วยข้อความต้อนรับและประโยคชวนคุย หากการสนทนาเริ่มต้นขึ้น เมื่ออยู่นอกช่วงเวลาว่าง ผู้ใช้จะเห็นข้อความออฟไลน์ของตัวแทน ดูเริ่มต้น เวลา การสนทนา เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับข้อความเหล่านี้

ความพร้อมให้บริการของบ็อตและเจ้าหน้าที่

คุณสามารถระบุบ็อตแยกกันและมนุษย์ได้ ตัวแทน

หากคุณมีระบบเขียนข้อความอัตโนมัติสำหรับ อัตโนมัติหรือไม่ ว่าการทำงานอัตโนมัตินั้นเป็นระบบตอบรับอัตโนมัติที่แจ้งให้ผู้ใช้ทราบถึงตำแหน่งของตนใน ซึ่งเป็น Agent ที่เข้าใจภาษาธรรมชาติที่ซับซ้อน ซึ่งมีการเข้าถึงแบบไดนามิก รายละเอียดผู้ใช้หรือสิ่งใดก็ตามที่อยู่ระหว่างนั้น ระบุความพร้อมใช้งานของการรับส่งข้อความกับบ็อต

ความพร้อมใช้งานของเจ้าหน้าที่เป็นสิ่งจำเป็นหากต้องการเปิดใช้งานตัวแทนใน Google จุดแรกเข้า ซึ่งรวมถึงจุดแรกเข้าที่อิงตามตำแหน่ง และ จุดแรกเข้าที่ไม่ใช่ในพื้นที่ (ยกเว้น Google Ads) สำหรับเจ้าหน้าที่รับสาย ให้ระบุเฉพาะวันในสัปดาห์และเวลาทำการที่คุณมีตัวแทนแบบเรียลไทม์พร้อมตอบคำถามเท่านั้น

หากตัวแทนของบ็อตพร้อมให้บริการทุกวันตลอด 24 ชั่วโมง แต่ตัวแทนที่เป็นมนุษย์พร้อมให้บริการตั้งแต่ 8.00 น. ถึง 20.00 น. คุณสามารถระบุให้ ได้อย่างอิสระ

นอกจากนี้ หากคุณระบุทั้งบ็อตและเจ้าหน้าที่ สามารถส่งคำขอตัวแทนแบบสด คำแนะนำ เพื่อแจ้งให้ผู้ใช้ขอตัวแทนแบบเรียลไทม์ หากตัวแทนบ็อตไม่สามารถดำเนินการตามคำสั่งซื้อได้ ตามความต้องการ

อัปเดตความพร้อมใช้งานของการรับส่งข้อความ

หากต้องการอัปเดตความพร้อมของการรับส่งข้อความ คุณต้องส่งคำขอ Patch กับธุรกิจ Communications API เพื่ออัปเดต primaryAgentInteraction ของ Agent และ additionalAgentInteractions ช่อง

เมื่ออัปเดตช่องเหล่านี้ คุณต้องใส่ค่าสำหรับทุกช่องใน SupportedAgentInteraction คำขออัปเดตจะเขียนทับเนื้อหาของทั้งหมด ช่องที่คุณแก้ไข รวมถึงช่องย่อย เช่น หากคุณส่งคำขอ หากต้องการเพิ่มอินสแตนซ์ไปยัง hours คุณจะต้องรวม hours ก่อนหน้าทั้งหมด มิฉะนั้นการอัปเดตของคุณจะเขียนทับข้อมูลเหล่านั้น

ข้อกำหนดเบื้องต้น

ก่อนอัปเดตความพร้อมของการรับส่งข้อความ คุณต้องมีสิ่งต่อไปนี้

  • เส้นทางไปยังคีย์บัญชีบริการของโปรเจ็กต์ GCP ในเครื่องพัฒนา

  • ตัวแทน name (เช่น "brands/12345/agents/67890")

    หากคุณไม่รู้จัก name ของตัวแทน โปรดดูที่แสดงตัวแทนทั้งหมดสำหรับ แบรนด์

  • เขตเวลาที่บ็อตเปิดได้ วันในสัปดาห์ และเวลา

  • เขตเวลาที่พร้อมให้บริการโดยมนุษย์ วันในสัปดาห์ และเวลาทําการ

หากคุณไม่ทราบ primaryAgentInteraction ปัจจุบันและ ค่า additionalAgentInteractions โปรดดูรับตัวแทน ข้อมูล

ส่งคำขออัปเดต

หากต้องการอัปเดต Agent ให้เรียกใช้คำสั่งต่อไปนี้ แทนที่ตัวแปรด้วยค่า ที่คุณระบุไว้ในข้อกำหนดเบื้องต้น

หากคุณมีความพร้อมใช้งานทั้งของบ็อตและการรับส่งข้อความมนุษย์ ให้ระบุความพร้อมใช้งานของบ็อต ใน primaryAgentInteraction และความพร้อมให้บริการของมนุษย์ในกรณี additionalAgentInteractions

บ็อตและมนุษย์ 

# 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

บ็อตเท่านั้น 

# 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

มนุษย์เท่านั้น 

# 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

สำหรับตัวเลือกการจัดรูปแบบและค่า โปรดดู brands.agents.patch และ SupportedAgentInteraction