Diese Seite wurde von der Cloud Translation API übersetzt.

Verfügbarkeit von Nachrichten festlegen

Bevor Nutzer Unterhaltungen mit Ihrem Agent starten können, müssen Sie die Nachrichtenverfügbarkeit für den Agent in Business Messages festlegen.

Wenn ein Nutzer Ihrem Agent während der verfügbaren Zeiten eine Nachricht sendet, begrüßt er den Nutzer mit einer Willkommensnachricht und einer Unterhaltung. Wenn die Unterhaltung außerhalb der verfügbaren Zeiten beginnt, sehen Nutzer die Offlinenachricht des Agents. Weitere Informationen zu diesen Nachrichten finden Sie unter Unterhaltung starten.

Bot- und menschliche Verfügbarkeit

Sie können eine separate Bot-Verfügbarkeit für Mitarbeiter angeben.

Wenn Automatisierungen Nachrichten für Ihren Agent zusammensetzen, z. B. ob die Automatisierung eine automatische Antwort ist, die den Nutzer in einer Warteschlange eingibt, ein komplexer Natural Language Understanding-Agent, der dynamischen Zugriff auf Nutzerdetails hat, oder etwas dazwischen, geben Sie die Verfügbarkeit von Bot-Nachrichten an.

Humanverfügbarkeit ist ein Muss, wenn Sie einen Agent auf von Google verwalteten Einstiegspunkten starten möchten, einschließlich standortbasierter Einstiegspunkte und nicht lokalen Einstiegspunkten (außer in Google Ads). Geben Sie für die Verfügbarkeit durch Mitarbeiter nur die Wochentage und Zeiten an, zu denen Sie Kundenservicemitarbeiter zur Beantwortung Ihrer Fragen haben können.

Wenn Bot-Mitarbeiter rund um die Uhr verfügbar sind, aber Mitarbeiter von 8:00 bis 20:00 Uhr, können Sie diese selbst angeben.

Wenn Sie außerdem die Verfügbarkeit von Bots und menschlichen Nutzern angeben, können Sie Vorschläge für Anfragen an den Live-Agent senden, damit Nutzer aufgefordert werden, Live-Agents anzufordern, wenn die Bots nicht ihre Anforderungen erfüllen können.

Verfügbarkeit von Nachrichten aktualisieren

Zum Aktualisieren der Nachrichtenverfügbarkeit senden Sie eine PATCH-Anfrage mit der Business Communications API, um die Felder primaryAgentInteraction und additionalAgentInteractions eines Agents zu aktualisieren.

Wenn Sie diese Felder aktualisieren, müssen Sie Werte für alle Felder im Objekt SupportedAgentInteraction angeben. Aktualisierungsanfragen überschreiben den Inhalt aller Felder, die Sie bearbeiten, einschließlich aller untergeordneten Felder. Wenn Sie beispielsweise eine Anfrage zum Hinzufügen einer Instanz zu hours stellen, müssen Sie auch alle vorherigen hours-Instanzen einschließen. Andernfalls werden sie durch das Update überschrieben.

Voraussetzungen

Bevor Sie die Verfügbarkeit von Nachrichten aktualisieren können, benötigen Sie Folgendes:

Pfad zum Dienstkontoschlüssel Ihres GCP-Projekts auf Ihrem Entwicklungscomputer
Der Agent name (z. B. „brands/12345/agents/67890“)

Wenn Sie die name des Agents nicht kennen, lesen Sie Alle Agents für eine Marke auflisten.
Verfügbarkeitszonen, Wochentage und Stunden des Bots
Manuell verfügbare Zeitzonen, Wochentage und Stunden

Wenn Sie die aktuellen primaryAgentInteraction- und additionalAgentInteractions-Werte nicht kennen, finden Sie weitere Informationen unter Agent-Informationen abrufen.

Aktualisierungsanfrage senden

Führen Sie den folgenden Befehl aus, um den Agent zu aktualisieren. Ersetzen Sie Variablen durch Werte, die Sie unter Voraussetzungen angegeben haben.

Wenn Sie sowohl Bot- als auch Human Messaging-Verfügbarkeit haben, geben Sie die Bot-Verfügbarkeit in primaryAgentInteraction und die Verfügbarkeit in einer Instanz von additionalAgentInteractions an.

Bot und Mensch


# 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

Nur 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

Nur für Menschen


# 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

Informationen zu Formatierungs- und Wertoptionen finden Sie unter brands.agents.patch und SupportedAgentInteraction.