Ustawianie dostępności wiadomości

Aby użytkownicy mogli rozpoczynać rozmowy z agentem, musisz skonfigurować dostępność wiadomości agenta w Business Messages.

Jeśli użytkownik wyśle wiadomość do agenta w dostępnych godzinach, powita go. wiadomość powitalną i wskazówki ułatwiające rozpoczęcie rozmowy. Jeśli rozmowa się rozpocznie poza godzinami pracy, użytkownicy widzą wiadomość offline agenta. Patrz początek rozmowa .

Dostępność botów i ludzi

Możesz określić oddzielnego bota i człowieka reprezentatywny dostępność.

Jeśli korzystasz z automatycznego tworzenia wiadomości na potrzeby – czy automatyzacja to automatyczna odpowiedź informująca użytkowników, – złożony agent rozumiejący język naturalny z dynamicznym dostępem do kolejki dane użytkownika lub cokolwiek innego – określ dostępność wiadomości od bota.

Jeśli chcesz uruchomić agenta w zarządzanym przez Google, musisz potwierdzić dostępność przez człowieka punktów wejścia, w tym punktów wejścia w lokalizacji, nielokalne punkty wejścia (z wyjątkiem Google Ads). Aby skontaktować się z pracownikiem obsługi klienta, określ tylko dni tygodnia i godziny pracy pracowników obsługi klienta, którzy mogą odpowiedzieć na pytania.

Jeśli przedstawiciele botów są dostępni przez całą dobę ale przedstawiciele są dostępni od 8:00 do 20:00, dzięki czemu mogą pracować niezależnie.

Ponadto, jeśli określisz dostępność zarówno bota, jak i człowieka, może wysyłać prośby na żywo od pracownika obsługi klienta propozycje aby prosić użytkowników o pomoc pracownika obsługi klienta, jeśli przedstawiciele botów nie mogą do swoich potrzeb.

Zaktualizuj dostępność wiadomości

Aby zaktualizować dostępność wiadomości, wyślij prośbę PATCH do firmy Communications API w celu aktualizacji uprawnień primaryAgentInteraction i agenta additionalAgentInteractions pól.

Aktualizując te pola, musisz podać wartości dla wszystkich pól w Obiekt SupportedAgentInteraction. Żądania aktualizacji zastępują zawartość wszystkich edytowanych pól, w tym wszystkich pól podrzędnych. Na przykład jeśli poprosisz o aby dodać instancję do hours, musisz uwzględnić wszystkie poprzednie hours w inny sposób, w przeciwnym razie zostaną one nadpisane.

Wymagania wstępne

Zanim zaktualizujesz dostępność wiadomości, musisz mieć:

  • Ścieżka do klucza konta usługi projektu GCP na komputerze, którego używasz do programowania

  • Agent name (na przykład „brands/12345/agents/67890”)

    Jeśli nie znasz tego numeru (name), zobacz Wyświetlanie listy wszystkich agentów dla danego marki.

  • Strefy czasowe dostępności botów, dni tygodnia i godziny

  • Strefy czasowe, dni tygodnia i godziny dostępności

Jeśli nie znasz aktualnych danych primaryAgentInteraction i additionalAgentInteractions wartości, zobacz pobieranie agenta informacje.

Wysyłanie prośby o aktualizację

Aby zaktualizować agenta, uruchom następujące polecenie. Zastąp zmienne wartościami wskazanych w sekcji Wymagania wstępne.

Jeśli funkcja komunikacji jest dostępna zarówno przez bota, jak i przez człowieka, określ dostępność botów w primaryAgentInteraction i dostępności człowieka w przypadku: additionalAgentInteractions

Bot i ludzie Tylko bot Tylko człowiek 
# 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

Informacje o opcjach formatowania i wartości znajdziesz w brands.agents.patch oraz SupportedAgentInteraction