Đặt khả năng nhắn tin

Trước khi người dùng có thể bắt đầu trò chuyện với nhân viên hỗ trợ của bạn, bạn cần đặt khả năng nhắn tin của nhân viên hỗ trợ trong Business Messages.

Nếu người dùng nhắn tin cho nhân viên hỗ trợ của bạn trong giờ làm việc, thì nhân viên hỗ trợ sẽ chào đón người dùng đó bằng tin nhắn chào mừng và câu mở đầu cuộc trò chuyện. Nếu cuộc trò chuyện bắt đầu ngoài giờ hoạt động, người dùng sẽ thấy thông báo ngoại tuyến của nhân viên hỗ trợ. Xem phần Bắt đầu thời gian cuộc trò chuyện để biết thêm thông tin về các thư này.

Khả năng sử dụng của bot và con người

Bạn có thể chỉ định bot và người đại diện tình trạng còn hàng.

Nếu bạn có bất kỳ loại thư soạn thư tự động nào dành cho – liệu tự động hoá có phải là một câu trả lời tự động cho người dùng biết vị trí của họ trong hàng đợi, một công cụ hiểu ngôn ngữ tự nhiên phức tạp có quyền truy cập động vào thông tin chi tiết về người dùng hoặc bất kỳ thông tin nào liên quan – chỉ định khả năng nhắn tin qua bot.

Bạn phải bắt buộc phải có nhân viên hỗ trợ nếu muốn ra mắt một nhân viên hỗ trợ trên trang do Google quản lý điểm truy cập, bao gồm cả điểm truy cập dựa trên vị trí và điểm truy cập không phải tại địa phương (ngoại trừ Google Ads). Đối với nhân viên hỗ trợ, bạn chỉ cần nêu rõ ngày trong tuần và giờ mà nhân viên hỗ trợ có thể trả lời câu hỏi.

Nếu người đại diện của bot sẵn sàng trợ giúp 24/24 nhưng nhân viên đại diện làm việc từ 8:00 đến 20:00, bạn có thể chỉ định những người đó một cách độc lập.

Ngoài ra, nếu bạn chỉ định cả bot và khả năng cung cấp người dùng, bạn có thể gửi yêu cầu nhân viên hỗ trợ trực tiếp gợi ý để nhắc người dùng yêu cầu nhân viên hỗ trợ trực tiếp nếu người đại diện của bot không thể thực hiện nhu cầu của họ.

Cập nhật khả năng nhắn tin

Để cập nhật khả năng nhắn tin, bạn cần gửi yêu cầu PATCH với Doanh nghiệp này Communications API để cập nhật primaryAgentInteraction của nhân viên hỗ trợ và additionalAgentInteractions trường.

Khi cập nhật những trường này, bạn phải thêm giá trị cho tất cả các trường trong Đối tượng supportedAgent tương tác. Yêu cầu cập nhật sẽ ghi đè nội dung của tất cả các trường bạn chỉnh sửa, bao gồm bất kỳ trường con nào. Ví dụ: nếu bạn đưa ra yêu cầu để thêm một thực thể vào hours, bạn cần thêm tất cả hours trước đó thực thể khác, nếu không thì bản cập nhật sẽ ghi đè lên các phiên bản đó.

Điều kiện tiên quyết

Trước khi cập nhật khả năng cung cấp tính năng nhắn tin, bạn cần có các mục sau:

  • Đường dẫn đến khoá tài khoản dịch vụ của dự án GCP trên máy phát triển

  • Tác nhân người dùng name (ví dụ: "brands/12345/agents/67890")

    Nếu bạn không biết name của nhân viên hỗ trợ, hãy xem phần Liệt kê tất cả nhân viên hỗ trợ cho một thương hiệu.

  • Múi giờ và giờ làm việc của bot

  • Múi giờ và giờ làm việc của nhân viên

Nếu bạn không biết primaryAgentInteraction hiện tại và additionalAgentInteractions giá trị, hãy xem phần Tải nhân viên hỗ trợ thông tin.

Gửi yêu cầu cập nhật

Để cập nhật nhân viên hỗ trợ, hãy chạy lệnh sau. Thay thế biến bằng các giá trị mà bạn đã xác định trong Điều kiện tiên quyết.

Nếu bạn có thể gửi tin nhắn cho cả bot lẫn người dùng, hãy chỉ định khả năng sử dụng bot trong primaryAgentInteraction và khả năng đáp ứng của con người trong một trường hợp additionalAgentInteractions

Bot và con người 

# 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

Chỉ 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

Chỉ người 

# 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

Để biết các lựa chọn về định dạng và giá trị, hãy xem brands.agents.patch và SupportedAgentInteraction.