Ustawianie dostępności wiadomości

Zanim użytkownicy będą mogli rozpocząć rozmowy z Twoim agentem, musisz ustawić dostępność agenta w Business Messages.

Jeśli użytkownik wyśle wiadomość do Twojego agenta w godzinach jego dostępności, agent powita go wiadomością powitalną i propozycjami rozpoczęcia rozmowy. Jeśli rozmowa rozpocznie się poza godzinami dostępności, użytkownicy zobaczą wiadomość offline agenta. Więcej informacji o tych wiadomościach znajdziesz w artykule Rozpoczęcie rozmowy.

Dostępność botów i osób

Możesz określić oddzielną dostępność bota i przedstawiciela.

Jeśli masz jakikolwiek rodzaj automatyzacji tworzenia wiadomości dla agenta – niezależnie od tego, czy jest to automatyczna odpowiedź informująca użytkowników o ich miejscu w kolejce, złożony agent rozumienia języka naturalnego, który ma dynamiczny dostęp do szczegółów użytkownika, czy coś pomiędzy – określ dostępność wiadomości bota.

Jeśli chcesz uruchomić agenta w punktach wejścia zarządzanych przez Google, w tym w punktach wejścia opartych na lokalizacji i punktach wejścia niezwiązanych z lokalizacją (z wyjątkiem Google Ads), musisz zapewnić dostępność osób. W przypadku dostępności obsługi klienta podaj tylko dni tygodnia i godziny, w których pracownicy są dostępni, aby odpowiadać na pytania.

Jeśli przedstawiciele w postaci botów są dostępni przez całą dobę, a przedstawiciele w postaci ludzi – od 8:00 do 20:00, możesz określić te godziny niezależnie.

Jeśli określisz dostępność zarówno bota, jak i pracownika obsługi klienta, możesz wysyłać sugestie dotyczące prośby o pomoc pracownika obsługi klienta, aby zachęcić użytkowników do poproszenia o pomoc pracownika obsługi klienta, jeśli bot nie może spełnić ich potrzeb.

Aktualizowanie dostępności wiadomości

Aby zaktualizować dostępność wiadomości, wyślij żądanie PATCH za pomocą interfejsu Business Communications API, aby zaktualizować pola primaryAgentInteraction i additionalAgentInteractions agenta.

Gdy aktualizujesz te pola, musisz podać wartości wszystkich pól w obiekcie SupportedAgentInteraction. Żądania aktualizacji zastępują zawartość wszystkich edytowanych pól, w tym pól podrzędnych. Jeśli na przykład wysyłasz prośbę o dodanie instancji do hours, musisz też uwzględnić wszystkie poprzednie instancje hours, w przeciwnym razie aktualizacja je zastąpi.

Wymagania wstępne

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

  • Ścieżka do klucza konta usługi projektu GCP na komputerze deweloperskim

  • Agent name (np. „brands/12345/agents/67890”)

    Jeśli nie znasz name agenta, zapoznaj się z artykułem Wyświetlanie listy wszystkich agentów marki.

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

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

Jeśli nie znasz bieżących wartości primaryAgentInteraction i additionalAgentInteractions, zobacz Uzyskiwanie informacji o agencie.

Wysyłanie prośby o aktualizację

Aby zaktualizować agenta, uruchom to polecenie. Zastąp zmienne wartościami określonymi w sekcji Wymagania wstępne.

Jeśli masz dostępność zarówno do wysyłania wiadomości przez bota, jak i przez człowieka, określ dostępność bota w primaryAgentInteraction, a dostępność człowieka w instancji additionalAgentInteractions.

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

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

Tylko ludzie 

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

Opcje formatowania i wartości znajdziesz w sekcjach brands.agents.patch i SupportedAgentInteraction.