Verfügbarkeit der Nachrichtenfunktion festlegen

<ph type="x-smartling-placeholder">

Bevor Nutzer Unterhaltungen mit dem Agent starten können, müssen Sie Folgendes festlegen: Messaging-Verfügbarkeit des Agents in Business Messages.

Wenn ein Nutzer Ihrem Agent während der verfügbaren Zeiten eine Nachricht sendet, wird er von ihm begrüßt. mit einer Willkommensnachricht und Gesprächseinstiegen. Beginn der Unterhaltung außerhalb der verfügbaren Zeiten, sehen Nutzer die Offlinenachricht des Agents. Siehe Beginn die Unterhaltung finden Sie weitere Informationen zu diesen Meldungen.

Verfügbarkeit von Bots und Personen

Sie können Bot und Mensch getrennt angeben repräsentativ Verfügbarkeit.

Wenn Sie mit irgendeiner Art von Automatisierung Nachrichten für Ihre ob es sich bei der Automatisierung um eine automatische Antwortfunktion handelt, die Nutzern mitteilt, ist ein komplexer Natural Language Understanding-Agent, der dynamischen Zugriff auf z. B. Nutzerdetails oder Ähnliches, geben Sie die Verfügbarkeit der Nachrichtenfunktion an.

Die menschliche Verfügbarkeit ist unverzichtbar, wenn Sie einen Kundenservicemitarbeiter in einem von Google verwalteten Dienst Einstiegspunkte, darunter standortbasierte Einstiegspunkte und nicht lokale Einstiegspunkte (außer Google Ads) Geben Sie im Hinblick auf die Verfügbarkeit vor Ort nur die Wochentage und Uhrzeiten an, an bzw. zu denen Ihr Kundenservicemitarbeiter Fragen beantworten kann.

Bot-Beauftragte sind 24 Stunden am Tag verfügbar aber von 08:00 bis 20:00 Uhr verfügbar sind, können Sie diese angeben. unabhängig voneinander unterscheiden.

Wenn Sie sowohl die Bot- als auch die menschliche Verfügbarkeit angeben, kann eine Live-Agent-Anfrage senden Vorschläge Nutzer werden aufgefordert, Kundenservicemitarbeiter zu kontaktieren, wenn der Bot-Mitarbeiter die Anfrage nicht ausführen kann ihre Bedürfnisse zu erfüllen.

Verfügbarkeit der Nachrichtenfunktion aktualisieren

Um die Verfügbarkeit von Messaging zu aktualisieren, stellen Sie eine PATCH-Anfrage beim Unternehmen Communications API zum Aktualisieren der primaryAgentInteraction eines Agents und additionalAgentInteractions-Feldern.

Wenn Sie diese Felder aktualisieren, müssen Sie Werte für alle Felder in der SupportedAgentInteraction. Aktualisierungsanfragen überschreiben den Inhalt aller die Sie bearbeiten, einschließlich aller untergeordneten Felder. Wenn Sie zum Beispiel Wenn Sie hours eine Instanz hinzufügen möchten, müssen Sie alle vorherigen hours einschließen sonst werden sie von der Aktualisierung überschrieben.

Vorbereitung

Bevor Sie die Verfügbarkeit der Nachrichtenfunktion aktualisieren, benötigen Sie Folgendes:

  • Pfad zum Dienstkontoschlüssel Ihres GCP-Projekts auf Ihrem Entwicklungscomputer

  • Den Agent name, z. B. „brands/12345/agents/67890“

    Wenn Sie den name des Agents nicht kennen, lesen Sie Alle Agents für einen brand [Marke].

  • Zeitzonen, Wochentage und Öffnungszeiten für Bot-Verfügbarkeit

  • Zeitzonen für menschliche Verfügbarkeit, Wochentage und Öffnungszeiten

Wenn du die aktuellen Werte für primaryAgentInteraction und additionalAgentInteractions-Werte, siehe Agent abrufen Informationen.

Aktualisierungsanfrage senden

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

Geben Sie die Bot-Verfügbarkeit an, wenn Sie die Verfügbarkeit von Nachrichten sowohl an Bots als auch an Personen haben in primaryAgentInteraction und menschliche Verfügbarkeit in einer Instanz von additionalAgentInteractions.

Mensch und Bot 

# 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