Diese Seite wurde von der Cloud Translation API übersetzt.

Online-Abholung im Geschäft: Bonjour-Mahlzeit – Teil 1 – Erste Schritte

1. Einführung

Zuletzt aktualisiert:11.05.2022

Willkommen bei Business Messages!

Dieses Codelab ist eine Einführung in die Einbindung von Business Messages. Damit können Kunden über die Google Suche und Google Maps mit Unternehmen in Kontakt treten, die Sie verwalten. Vielleicht möchten Sie Business Messages direkt einbinden oder arbeiten bei einem unabhängigen Softwareanbieter, der Messaging-Lösungen für die Unternehmen entwickelt, mit denen Sie zusammenarbeiten, oder sind Sie gerade auf Business Messages gestoßen und möchten etwas an der Plattform ausprobieren?

Egal, was Sie hergebracht hat – dieses Codelab ist ein großartiger Einstieg. Am Ende haben Sie Ihren ersten digitalen Kundenservicemitarbeiter, mit dem Nutzer interagieren können. Wenn Sie bereit sind, Business Messages noch ein wenig zu optimieren, können Sie Millionen von Kunden erreichen.

Was macht einen guten digitalen Kundenservicemitarbeiter aus?

Business Messages ist eine dialogorientierte Oberfläche, die eine App-ähnliche Oberfläche auf Mobilgeräten bietet, über die Nutzer mit Unternehmen in Kontakt treten können, ohne eine zusätzliche App installieren zu müssen. Ein digitaler Agent ist die Logik, mit der Ihre Kunden interagieren. Die Logik wird von einer Webanwendung verwaltet, die in der Cloud oder in Ihrer Infrastruktur bereitgestellt wird. Es liegt ganz bei Ihnen, wie Sie auf die Nutzer reagieren. Die besten Kundenservicemitarbeiter liefern Kontext, um Erwartungen zu definieren, die Kundeninteraktionen aufrechtzuerhalten und Funktionen für den Support bereitzustellen Anforderungen.

Inhalt

In diesem Codelab entwickeln Sie einen digitalen Agenten für Business Messages für ein fiktives Unternehmen namens Bonjour Meal. Dieser digitale Kundenservicemitarbeiter wird ein paar einfache Fragen wie „Um wie viel Uhr schließen Sie?“ beantworten. oder „Kann ich online etwas kaufen?“.

In diesem Codelab können Nutzer Artikel über den digitalen Agent kaufen, sie an einen Zahlungsabwickler verweisen, der sie um Geld bitten kann, und dann eine Abholung ihrer fiktiven Artikel im Geschäft vereinbaren.

In diesem Codelab wird Ihre App

Fragen über einen Vorschlags-Chip beantworten
Leite den Nutzer dazu an, Fragen zu stellen, die dein digitaler Kundenservicemitarbeiter beantworten kann.
Umfassende Konversationsfunktionen bereitstellen, um das Interesse des Nutzers an der Unterhaltung aufrechtzuerhalten

Aufgaben in diesem Lab

Hier erfahren Sie, wie Sie eine Webanwendung in App Engine auf der Google Cloud Platform bereitstellen. Alternativ können Sie Ihre lokale Anwendung mit ngrok öffentlich testen.
Business Messages-Konto mit einem Webhook für Webanwendungen konfigurieren, um Nachrichten von Nutzern zu empfangen
Mit der Business Messages API Rich-Funktionen wie Karten, Karussells und Konversationsvorschläge senden
So sendet Business Messages Ihre Nachrichten

In diesem Codelab geht es vorrangig um das Erstellen Ihres ersten digitalen Kundenservicemitarbeiters.

Voraussetzungen

Für ein kostenloses Business Communications-Entwicklerkonto registrieren
Auf unserer Entwicklerwebsite finden Sie eine Anleitung dazu,
Ein Android-Gerät mit Version 5 oder höher ODER ein iOS-Gerät mit der Google Maps App
Erfahrung in der Programmierung von Webanwendungen
Eine Internetverbindung!

2. Einrichtung

APIs aktivieren

Da wir mit einer Django-Anwendung arbeiten, verwenden wir für dieses Codelab die Cloud Build API, um die Anwendung in App Engine bereitzustellen. Wenn Sie ngrok verwenden, müssen Sie die Cloud Build API nicht aktivieren.

So aktivieren Sie die Cloud Build API:

Öffnen Sie die Cloud Build API in der Google Cloud Console.
Klicken Sie auf Aktivieren.

Dienstkonto erstellen

Sie müssen ein Dienstkonto erstellen, um auf die Business Communications und die Business Messages APIs zugreifen zu können. Folgen Sie der Anleitung in der Dokumentation zum Erstellen eines Dienstkontos in der Business Communications Developer Console.

Python EchoBot-Startcode von Django bereitstellen

Klonen Sie in einem Terminal das Beispiel für den Django Echo-Bot mit dem folgenden Befehl in das Arbeitsverzeichnis Ihres Projekts:

$ git clone https://github.com/google-business-communications/bm-bonjour-meal-django-starter-code

Kopieren Sie die für das Dienstkonto erstellte JSON-Anmeldedatendatei in den Ressourcenordner des Beispiels und benennen Sie die Anmeldedaten in „bm-agent-service-account-credentials.json“ um.

bm-bonjour-meal-django-starter-code/bonjourmeal-codelab/step-1/resources/bm-agent-service-account-credentials.json

Rufen Sie in einem Terminal das Verzeichnis „step-1“ des Beispiels auf.

Führen Sie die folgenden Befehle in einem Terminal aus, um das Beispiel bereitzustellen:

$ gcloud config set project PROJECT_ID*
$ gcloud app create
$ gcloud app deploy

PROJECT_ID ist die Projekt-ID des Projekts, mit dem Sie sich bei den APIs registriert haben.

Notieren Sie sich die URL der bereitgestellten Anwendung in der Ausgabe des letzten Befehls:

Deployed service [default] to [https://PROJECT_ID.appspot.com]

Der gerade bereitgestellte Startcode enthält eine Webanwendung mit einem Webhook, über den Nachrichten von Business Messages empfangen werden können. Die Anwendung gibt Nachrichten an den Nutzer zurück und kann einige der umfangreichen Funktionen der Konversationsoberfläche präsentieren.

Webook konfigurieren

Nachdem der Dienst bereitgestellt wurde, legen Sie die Webhook-URL mithilfe der URL der Anwendung auf der Seite Kontoeinstellungen in der Business Communications Developer Console fest.

Die Webhook-URL ist die URL der Anwendung + „/callback/“. Beispiel: https://PROJECT_ID.appspot.com/callback/

Rufen Sie die Seite mit den Kontoeinstellungen der Business Communications Console auf. In der oberen rechten Ecke unter der Navigationsleiste sollten Sie den Namen Ihres GCP-Projekts sehen. Wenn ein Drop-down-Menü angezeigt wird, müssen Sie Ihr GCP-Projekt auswählen.

Geben Sie die Informationen unter Technischer Ansprechpartner ein und aktualisieren Sie dann den Webhook mit der Webhook-URL für Ihre bereitgestellte Anwendung.

Klicken Sie neben dem Verweis auf Ihr GCP-Projekt auf Save (Speichern).

3. Ersten Agent erstellen

Business Communications Developer Console verwenden

Klicken Sie in der Business Communications Console auf das Logo links oben, um zum Dashboard der Konsole zurückzukehren, und klicken Sie dann auf Create agent (Agent erstellen). Die Marke wird gleichzeitig mit dem Agent erstellt. Wählen Sie Business Messages als Agent-Typ aus und prüfen Sie, ob die Partnerinformationen korrekt sind.

Geben Sie unter Brand den Namen der Marke ein, mit der Sie zusammenarbeiten.Die Marke ist das Unternehmen, mit dem Sie zusammenarbeiten, und Nutzer können mit dem Agent interagieren. Geben Sie im Feld Agent-Name an, was die Nutzer in der Unterhaltung in Business Messages sehen sollen. Im Fall des fiktiven Bonjour Meal ist Bonjour Rail das Eisenbahnunternehmen, das die Restaurants von Bonjour Meal verwaltet. Also gebe ich Bonjour Rail als Marke und Bonjour Meal als Agent an.

Der Agent ist die dialogorientierte Entität, die die Marke repräsentiert.

Klicken Sie auf Create agent (Agent erstellen) und erledigen Sie den Rest. Es dauert einige Sekunden, bis mehrere Anfragen zum Erstellen der Marke und des Agents an die Business Communications API gesendet werden. Sie können die Business Communications API direkt verwenden, um einen Agent und eine Marke zu erstellen. In der Dokumentation finden Sie Informationen dazu, wie eine curl-Anfrage wie die Konsole aussehen würde.

Erstes Gespräch führen

Öffnen Sie den Agent, den Sie gerade erstellt haben. Die Seite Übersicht wird angezeigt, auf der Sie die Details Ihres Agents prüfen können. Sehen Sie sich die Agent-Test-URLs an. Diese URLs werden verwendet, um die Konversationsoberfläche auf Ihrem Gerät aufzurufen.

Sie können die Test-URL kopieren, indem Sie auf einen der Chips klicken. Kopieren Sie selbstverständlich die Test-URL für das Gerät, das Sie für den Test zur Verfügung haben. Sie können die kopierte Nachricht auf beliebige Weise an Ihr Gerät senden.

Wenn Sie auf Ihrem Mobilgerät auf den Link tippen, wird der Business Messages Agent Launcher mit der Agent-Test-URL aufgerufen.

Tippen Sie auf Starten, um die Konversationsoberfläche des Agents aufzurufen.

Interagieren Sie mit dem Agenten und bekommen Sie ein Gefühl dafür, was er kann. In den meisten Fällen werden Sie feststellen, dass die Konversationsoberfläche nur Ihre Nachrichten wiederholt. Senden Sie in etwa „Hallo Welt!“ Sie werden sehen, dass der Kundenservicemitarbeiter dieselbe Nachricht an Sie zurücksendet.

Die bereitgestellte Anwendung enthält auch einige Logik, um die umfangreichen Funktionen zu präsentieren, die in Business Messages verfügbar sind.

Wenn du „Karte“ sendest, wird eine interaktive Chat-Nachricht aufgerufen
Wenn Sie „Chips“ senden, rufen Sie Vorschlags-Chips auf
Wenn Sie „Karussell“ senden, rufen Sie ein Karussell mit Rich Cards auf

Glückwunsch! Dies ist die erste Unterhaltung Ihres Agents mit Ihnen.

Jede der umfangreichen Funktionen kann verwendet werden, um der mit dem Agent kommunizierenden Person einen besseren Kontext zu liefern. Senden Sie grafische Assets in Rich Cards, um Ideen besser zu kommunizieren, oder verwenden Sie Vorschlags-Chips, um die Unterhaltung zu lenken.

Willkommensnachricht aktualisieren und Unterhaltungs-Chips verwenden

In dieser Lektion lernen Sie die Developer Console kennen und sehen uns an, wie Sie die Willkommensnachricht des Kundenservicemitarbeiters bearbeiten und mithilfe von Chips für Vorschläge besser kommunizieren können.

Rufen Sie die Seite Übersicht für den Agent auf und wählen Sie Agent-Informationen aus. Scrollen Sie nach unten zum Abschnitt „Willkommensnachricht“ und „Gesprächseinstiege“.

Aktualisieren Sie die Willkommensnachricht (das gelbe Eingabefeld) so:

Willkommen beim Bonjour-Meal-Starter-Agent. Ich kann Ihre Nachrichten wiederholen und Ihnen einige der umfangreichen Funktionen zeigen, die auf der Plattform unterstützt werden. Probieren Sie diese Vorschläge aus!

Klicken Sie auf + Unterhaltungseinstieg hinzufügen, wie im lila Feld im Bild oben angegeben, um Unterhaltungseinstiege hinzuzufügen und so Chips mit Vorschlägen, ein Karussell und eine Karte aufzurufen. Die Gesprächseinstiege, die Sie hinzufügen, benötigen eine Text- und eine PostbackData-Komponente. Der Text wird dem Nutzer angezeigt, während die PostBack-Daten an den Webhook Ihres Agents gesendet werden. Der Webhook parst die Postback-Daten und sendet die entsprechende Antwort an den Nutzer.

Die Agent-Informationen in der Konsole sehen nach der Änderung so aus:

Auf der rechten Seite der Konsole sehen Sie eine Vorschau des Agents. Sehen Sie, wie in der Begrüßungsnachricht der geänderte Text angezeigt wird und welche Vorschlags-Chips darunter angezeigt werden?

Dies ist ein großartiges Tool, um eine Vorstellung von der User Experience zu bekommen. Sie können sie verwenden, während Sie Ihren Agent erstellen und die Nutzerpfade planen, die Sie unterstützen möchten.

Leider können wir diese Änderungen nicht sofort in der Unterhaltung sehen, da die vorherigen Daten in der Business Messages-Infrastruktur im Cache gespeichert werden. Der Cache wird etwa alle zwei Stunden geleert. Sie sollten die Funktion also morgen ausprobieren können.

Sehen wir uns in der Zwischenzeit an, wie alles funktioniert.

4. Startcode analysieren

Eine Ansicht des Quellcodes aus 3.000 Metern

Der von Ihnen bereitgestellte Startcode gibt Nachrichten an die Nutzer zurück und kann eine Rich Card, ein Karussell oder Vorschlags-Chips anzeigen. Werfen wir nun einen genaueren Blick auf den Quellcode, um die Funktionsweise zu verstehen. Dann überlegen wir, was wir ändern müssen.

Der Startcode ist ein Django-Projekt. In einem späteren Teil dieser Codelab-Serie verwenden wir Google Datastore, um Daten wie Einkaufswagen und zugehörige Unterhaltungen dauerhaft zu speichern. Machen Sie sich keine Sorgen, wenn Sie Django noch nicht verwendet haben. Es ist ziemlich einfach und am Ende dieses Codelabs werden Sie bereits wissen, wie es funktioniert.

Auf übergeordneter Ebene leitet Django URLs an Ansichten weiter und die Ansichtslogik erzeugt eine Vorlage, die im Browser gerendert wird. Sehen wir uns die urls.py des Projekts an.

bm-django-echo-bot/bmcodelab/urls.py [Zeilen 31–37]

from django.urls import include, path
import bopis.views as bopis_views

urlpatterns = [
    path('', bopis_views.landing_placeholder),
    path('callback/', bopis_views.callback),
]

Hier sind zwei Routen definiert, sodass Django Logik ausführen kann, wenn diese beiden URLs erkannt werden. Wenn die Projekt-URL https://PROJECT_ID.appspot.com/ lautet, werden dem Projekt folgende Routen erkannt:

https://PROJECT_ID.appspot.com/
https://PROJECT_ID.appspot.com/callback/

Beide URL-Routen verweisen auf bopis_views, das aus bopis/views.py stammt. Sehen wir uns an, was in dieser Datei vor sich geht. Sehen wir uns zuerst bopis_views.landing_placeholder an.

bm-django-echo-bot/bonjourmeal-codelab/step-1/bopis/views.py [Zeilen 302–309]

... 
def landing_placeholder(request):
    return HttpResponse("<h1>Welcome to the Bonjour Meal Codelab</h1>
    <br/><br/>
    To message your Bonjour Meal agent, go to the Developer Console and retrieve
    the Test URLs for the agent you have created as described in the codelab
    <a href='https://codelabs.developers.google.com/codelabs/'>here</a>.")
...

Diese Logik wird von Ihrem Webserver ausgeführt, wenn er eine Webanfrage empfängt, die auf das Stammverzeichnis des Projekts verweist. Hier geht nichts zu Ausgefallenem Content: Wir geben einfach eine HTTPResponse mit HTML-Code an den Browser zurück, der die Anfrage gestellt hat. Sie können zwar die Stamm-URL des Projekts öffnen, aber es gibt dort nicht viel zu tun, da Sie zu diesem Codelab zurückkehren.

Die andere URL leitet an eine Funktion namens callback weiter, die sich ebenfalls in bopis/views.py befindet. Sehen wir uns diese Funktion an.

bm-django-echo-bot/bopis/views.py [Lines 60-101]

...
def callback(request):
    """
    Callback URL. Processes messages sent from user.
    """
    if request.method == "POST":
        request_data = request.body.decode('utf8').replace("'", '"')
        request_body = json.loads(request_data)

        print('request_body: %s', request_body)

        # Extract the conversation id and message text
        conversation_id = request_body.get('conversationId')
        print('conversation_id: %s', conversation_id)

        # Check that the message and text body exist

        if 'message' in request_body and 'text' in request_body['message']:
            message = request_body['message']['text']

            print('message: %s', message)
            route_message(message, conversation_id)
        elif 'suggestionResponse' in request_body:
            message = request_body['suggestionResponse']['postbackData']

            print('message: %s', message)
            route_message(message, conversation_id)
        elif 'userStatus' in request_body:
            if 'isTyping' in request_body['userStatus']:
                print('User is typing')
            elif 'requestedLiveAgent' in request_body['userStatus']:
                print('User requested transfer to live agent')

        return HttpResponse("Response.")

    elif request.method == "GET":
        return HttpResponse("This webhook expects a POST request.")
...

Die Logik parst hier den Anfragetext für eine message oder suggestionResponse und übergibt diese Informationen an eine Funktion namens route_message. Anschließend wird eine HttpResponse zurück an die Business Messages-Infrastruktur zurückgegeben, um den Empfang der Nachricht zu bestätigen.

Dies ist eine wichtige Funktion. Diese Logik ist der Webhook Ihrer Webanwendung, der Nachrichten von Nutzern empfängt, die mit Ihrem Agent interagieren. Sie können den Webhook so erweitern, dass Nachrichten an ein Automatisierungstool wie Dialogflow gesendet werden, um zu verstehen, was ein Nutzer sagt, und auf dieser Inferenz eine Antwort zu generieren. Sie können die Nachricht auch weiterleiten, damit der Nutzer sich mit einem Kundenservicemitarbeiter verbinden kann. Siehe folgendes Diagramm:

Business Messages sendet die Nachrichteninhalte als JSON-Nutzlast an Ihren Webhook, wo sie dann an einen Live-Agent oder an eine bestimmte Logik weitergeleitet wird, um als Bot zu antworten. Dieser Weiterleitungsmechanismus ist in unserem Fall route_message. Werfen wir mal einen Blick darauf.

bm-django-echo-bot/bopis/views.py [Lines 105-122]

...
def route_message(message, conversation_id):
    '''
    Routes the message received from the user to create a response.

    Args:
        message (str): The message text received from the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    normalized_message = message.lower()

    if normalized_message == CMD_RICH_CARD:
        send_rich_card(conversation_id)
    elif normalized_message == CMD_CAROUSEL_CARD:
        send_carousel(conversation_id)
    elif normalized_message == CMD_SUGGESTIONS:
        send_message_with_suggestions(conversation_id)
    else:
        echo_message(message, conversation_id)
...

Diese Logik beginnt, die vom Nutzer empfangene Nachricht zu untersuchen. Zunächst wird die Nachricht normalisiert, indem alle Zeichen herabgesetzt werden. Nach der Normalisierung wird geprüft, ob die Meldung eine der oben in der Datei definierten Konstanten ist.

bm-django-echo-bot/bopis/views.py [Zeilen 40–42]

...
# Set of commands the bot understands
CMD_RICH_CARD = 'card'
CMD_CAROUSEL_CARD = 'carousel'
CMD_SUGGESTIONS = 'chips'
...

Das heißt, der Bot parst nach Nachrichten, die speziell einen String enthalten, den wir in der postback_data der Gesprächseinstiege aus dem vorherigen Schritt in diesem Codelab eingefügt haben. Wenn keiner dieser Strings angezeigt wird, wird die Nachricht einfach an eine Funktion namens echo_message übergeben, bei der das Echo von Nachrichten ausgelöst wird.

Nachrichten senden

Sie sollten bereits eine Vorstellung davon haben, wie Nachrichten von der Webanwendung empfangen werden. Alles wird vom Webhook erledigt.

Aber wie sendet die Anwendung mit Business Messages eine ausgehende Nachricht an einen Nutzer?

Wenn Ihre Infrastruktur dem Nutzer antwortet, senden Sie die Antwort an die Business Messages API, die die Nachricht an den Nutzer sendet.

Die Business Messages API bietet Bibliotheken in Python, Node.js und Java. Es gibt auch eine REST API, an die Sie direkt Anfragen stellen können, wenn Ihre Infrastruktur nicht in einer Sprache vorliegt, für die wir eine Bibliothek haben. Unter Nachrichten senden erfahren Sie, wie cURL zum Senden einer Nachricht an eine bestimmte Unterhaltungs-ID verwendet wird.

In diesem Codelab konzentrieren wir uns auf die Verwendung der Python-Clientbibliothek, die bereits in den Bonjour Meal-Startcode integriert ist, der in Ihrem GCP-Projekt in App Engine bereitgestellt wurde oder lokal über ngrok ausgeführt wird.

Sehen wir uns die Funktion echo_message an und sehen wir uns an, wie wir mit der API interagieren, um die Nachricht an Business Messages zu senden.

bm-django-echo-bot/bopis/views.py [Lines 199–212]

...
def echo_message(message, conversation_id):
    '''
    Sends the message received from the user back to the user.

    Args:
        message (str): The message text received from the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        text=message)

    send_message(message_obj, conversation_id)
...

In dieser Funktion wird eine BusinessMessagesMessage instanziiert. Dabei wird die Nachrichtenvariable an die Funktion echo_message übergeben. Nach der Instanziierung wird das Objekt zusammen mit der Unterhaltungs-ID an send_message übergeben.

bm-django-echo-bot/bopis/views.py [Lines 214-236]

...
def send_message(message, conversation_id):
    '''
    Posts a message to the Business Messages API, first sending
    a typing indicator event and sending a stop typing event after
    the message has been sent.

    Args:
        message (obj): The message object payload to send to the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    credentials = ServiceAccountCredentials.from_json_keyfile_name(
        SERVICE_ACCOUNT_LOCATION,
        scopes=['https://www.googleapis.com/auth/businessmessages'])

    client = bm_client.BusinessmessagesV1(credentials=credentials)

    # Create the message request
    create_request = BusinessmessagesConversationsMessagesCreateRequest(
        businessMessagesMessage=message,
        parent='conversations/' + conversation_id)

    bm_client.BusinessmessagesV1.ConversationsMessagesService(
        client=client).Create(request=create_request)
...

Bei der Funktion „send_message“ werden die Anmeldedaten Ihres Dienstkontos verwendet, um zu prüfen, ob Sie Nachrichten an diese Unterhaltung senden können, einen Business Messages-Client instanziieren und eine Anfrage zum Senden der Nachricht an die angegebene conversation ID erstellen.

Die Rich-Funktionen nutzen ebenfalls diese send_message-Funktion, aber die von ihnen erstellten Nachrichten sind spezifisch für Rich Cards, Karussells und Vorschlags-Chips. Rich Cards und Karussells können grafische Assets enthalten, während Vorschlags-Chips über postback_data verfügen, sodass die Callback-Logik diese entsprechend parsen kann.

Nachdem Sie nun wissen, wie Nachrichten gesendet werden, untersuchen Sie, wie das Beispiel Rich Cards, Karussells und Vorschlags-Chips sendet. Im folgenden Abschnitt ändern wir den Quellcode so, dass Nachrichten mit einigen dieser umfangreichen Funktionen gesendet werden.

Wenn Sie bereit sind, passen wir den Bonjour-Meal-Agent an.

5. Agent anpassen

Wenn Sie das Codelab bis jetzt durchgegangen sind, sollten wir unseren schönen Agent sehen.

Okay, nicht so schön. Es sieht tatsächlich etwas nüchtern aus und repräsentiert unser Unternehmen nicht sehr gut. Glücklicherweise haben wir grundlegende Kenntnisse über den Code, der den Agent unterstützt, und verfügen über die Tools, die wir benötigen, um den Agent nach Bedarf anzupassen.

Im restlichen Codelab erweitern wir den Agent um Folgendes:

Tatsächliches Logo einfügen
Verbesserte Willkommensnachricht
Informationen zu Öffnungszeiten angeben
Nutzer darüber informieren, dass der Onlinekauf von Artikeln bald verfügbar ist
Chips für Vorschläge für Konversation, um die Unterhaltung zu erleichtern

Wir nutzen die Business Communications Console, um das Logo, die Willkommensnachricht, zu aktualisieren. Sie haben aber immer die Möglichkeit, die Business Communications APIs direkt dazu zu verwenden. Dann müssen wir den Quellcode aktualisieren, um entsprechende Nachrichten mit Informationen zu Öffnungszeiten zu senden, und dass Bonjour Meal bald eine Online-Shopping-Funktion anbieten wird. Wenn das erledigt ist, kehren wir zur Business Communications Console zurück und erstellen Chips für dialogorientierte Vorschläge, um die Unterhaltung zu den Happy Path-Erlebnissen zu lenken, die der digitale Kundenservicemitarbeiter unterstützt.

Ein Logo einfügen

Wählen Sie in der Business Communications Console Ihren Agent aus und gehen Sie zu Agent-Informationen. Wir möchten das Firmenlogo aktualisieren, wie unten gelb gekennzeichnet.

Klicken Sie auf Hochladen. Nun können Sie ein Bild auswählen, das hochgeladen oder über eine URL importiert werden soll.

In den Richtlinien zur Logogestaltung in der Dokumentation erhalten Sie Informationen zu den Best Practices, die wir für die Verwendung Ihrer eigenen Logos empfehlen.

Laden wir das Logo hoch, das sich im Quellcode befindet, den Sie zu Beginn dieses Codelabs geklont haben. Sie befindet sich im Verzeichnis „./assets/“ des Repositorys. Die Datei heißt „bonjour_meal-logo.png“. Sie können die Datei in das modale Fenster im Webbrowser ziehen. Ein Tool zur leichten Bearbeitung wird angezeigt, um die Bildqualität zu ändern und zuzuschneiden. Passen Sie die Bildauflösung an und schneiden Sie sie so zu, dass das Bild kleiner oder gleich der 50-KB-Beschränkung ist. Wenn Sie mit dem Bild zufrieden sind, klicken Sie zur Bestätigung auf das Häkchen im blauen Kreis und dann unten im Dialogfenster auf Auswählen.

Klicken Sie abschließend rechts oben auf der Seite Agent information (Agent-Informationen) auf Save (Speichern). Es kann einige Zeit dauern, bis diese Änderung auf Ihrem Gerät sichtbar wird, da die Agent-Informationen auf unseren Servern zwischengespeichert werden. Sie sollte innerhalb von zwei Stunden nach der Änderung sichtbar sein.

Willkommensnachricht aktualisieren

In diesem Codelab haben wir die Willkommensnachricht bereits aktualisiert. Wiederholen wir das, aber konfigurieren Sie diesmal eine Willkommensnachricht, die besser auf die User Journey von Bonjour Meal abgestimmt ist.

Wählen Sie in der Business Communications Console Ihren Agent aus und gehen Sie zu Agent-Informationen. Scrollen Sie nach unten zum Eingabefeld Willkommensnachricht. Dort können Sie die Nachricht aktualisieren.

Da wir wissen, dass wir Gesprächseinstiege hinzufügen werden, können wir sie in unserer Willkommensnachricht erwähnen. Ersetzen Sie im Eingabefeld den Text durch den folgenden Text:

„Willkommen bei Bonjour Meal. Ich bin ein Assistent und helfe Ihnen bei Fragen zu Bonjour Meal. Probieren Sie einige der folgenden Optionen aus.“

Klicken Sie abschließend rechts oben auf der Seite Agent information (Agent-Informationen) auf Save (Speichern). Dank unseres Caching-Mechanismus wird es noch eine Weile dauern, bis diese Änderung wirksam wird.

Öffnungszeiten angeben

Um Nutzern diese Informationen zur Verfügung zu stellen, senden wir über die Business Messages API eine benutzerdefinierte Nachricht an den Nutzer.

Sie erinnern sich, dass Nachrichten in der route_message-Funktion von views.py geparst werden. Die Funktion normalisiert zuerst den String und beginnt dann zu prüfen, ob die normalisierte Nachricht mit einem der hartcodierten Parameter übereinstimmt. Der Einfachheit halber fügen wir eine zusätzliche Bedingung hinzu, mit der wir prüfen, ob die normalisierte Nachricht einer neuen Konstante entspricht, die wir als CMD_BUSINESS_HOURS_INQUIRY aufrufen und den Wert „business-hours-inquiry“ enthalten. Wenn die Bedingung als wahr ausgewertet wird, wird eine Funktion namens send_message_with_business_hours aufgerufen.

Die Funktion route_message sieht jetzt so aus:

bm-django-echo-bot/bopis/views.py

...
def route_message(message, conversation_id):
    '''
    Routes the message received from the user to create a response.

    Args:
        message (str): The message text received from the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    normalized_message = message.lower()

    if normalized_message == CMD_RICH_CARD:
        send_rich_card(conversation_id)
    elif normalized_message == CMD_CAROUSEL_CARD:
        send_carousel(conversation_id)
    elif normalized_message == CMD_SUGGESTIONS:
        send_message_with_suggestions(conversation_id)
    elif normalized_message == CMD_BUSINESS_HOURS_INQUIRY:
        send_message_with_business_hours(conversation_id)
    else:
        echo_message(message, conversation_id)
...

Damit der Code funktioniert, sind zwei weitere Änderungen erforderlich: Die erste besteht darin, CMD_BUSINESS_HOURS_INQUIRY zusammen mit den anderen Konstanten zu definieren, die zweite darin, die Funktion send_message_with_business_hours zu definieren und eine Nachricht mit der Business Messages API zu senden.

Lassen Sie uns zunächst die Konstante oben in der Datei mit den anderen Konstantendeklarationen definieren:

bm-django-echo-bot/bopis/views.py

...
# Set of commands the bot understands
CMD_RICH_CARD = 'card'
CMD_CAROUSEL_CARD = 'carousel'
CMD_SUGGESTIONS = 'chips'
CMD_BUSINESS_HOURS_INQUIRY = 'business-hours-inquiry'
...

Nun zur Definition von send_message_with_business_hours. Sie können diese Funktion überall in der Datei unter Einhaltung der entsprechenden Python-Syntax definieren. Da mit dieser Funktion einfach eine Nachricht gesendet wird, ähnlich wie echo_message, können Sie sie als Vorlage verwenden, um diese Funktion zu definieren.

bm-django-echo-bot/bopis/views.py

...
def send_message_with_business_hours(conversation_id):

    message = '''Thanks for contacting us! The hours for the store are:\n
    MON 8am - 8pm\n
    TUE 8am - 8pm\n
    WED 8am - 8pm\n
    THU 8am - 8pm\n
    FRI 8am - 8pm\n
    SAT 8am - 8pm\n
    SUN 8am - 8pm
    '''

    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        text=message)

    send_message(message_obj, conversation_id)
...

Damit sollte unser Bot in der Lage sein, dem Nutzer diese Öffnungszeiten mitzuteilen, wenn er die folgende Nachricht sendet: „business-hours-inquiry“. Sie können in etwa Folgendes erwarten:

Sobald Sie den Quellcode in Google Cloud bereitgestellt haben, sind die Änderungen sofort sichtbar. Die Webanwendung wird nicht auf die gleiche Weise in der Google Cloud Platform wie Agent-Informationen im Cache gespeichert, sodass Sie diese Funktion sofort testen können.

Auch wenn die Änderungen an der Quelle bereits eine gewisse Dynamik haben, lassen Sie uns eine weitere Änderung vornehmen, die es einem Nutzer ermöglicht, sich nach Online-Shopping zu erkundigen. Der Kundenservicemitarbeiter antwortet, dass die Funktion noch nicht verfügbar ist. Kommt aber später noch einmal vorbei, um nachzusehen.

Den Nutzer über das baldige Onlineshopping informieren

Wir nehmen eine ähnliche Änderung vor wie wir, um den Nutzer über die Öffnungszeiten zu informieren. Dieses Mal platzieren wir die Informationen in einer Rich Card zusammen mit einem ansprechenden Bild.

Parsen Sie die normalisierte Nachricht und prüfen Sie eine Bedingung auf eine Konstante mit dem Namen CMD_ONLINE_SHOPPING_INQUIRY, deren Wert auf „online-shopping-inquiry“ gesetzt ist Dadurch wird send_online_shopping_info_message aufgerufen, wenn die Bedingung erfüllt ist.

bm-django-echo-bot/bopis/views.py

...
# Set of commands the bot understands
CMD_RICH_CARD = 'card'
CMD_CAROUSEL_CARD = 'carousel'
CMD_SUGGESTIONS = 'chips'
CMD_BUSINESS_HOURS_INQUIRY = 'business-hours-inquiry'
CMD_ONLINE_SHOPPING_INQUIRY = 'online-shopping-inquiry'
...
...
...
def route_message(message, conversation_id):
    '''
    Routes the message received from the user to create a response.

    Args:
        message (str): The message text received from the user.
        conversation_id (str): The unique id for this user and agent.
    '''
    normalized_message = message.lower()

    if normalized_message == CMD_RICH_CARD:
        send_rich_card(conversation_id)
    elif normalized_message == CMD_CAROUSEL_CARD:
        send_carousel(conversation_id)
    elif normalized_message == CMD_SUGGESTIONS:
        send_message_with_suggestions(conversation_id)
    elif normalized_message == CMD_BUSINESS_HOURS_INQUIRY:
        send_message_with_business_hours(conversation_id)
    elif normalized_message == CMD_ONLINE_SHOPPING_INQUIRY:
        send_online_shopping_info_message(conversation_id)
    else:
        echo_message(message, conversation_id)
...

Zur Definition von send_online_shopping_info_message. Diese Nachricht soll in einer Rich Card mit einem Bild gesendet werden. Kopieren Sie deshalb die Funktion send_rich_card, um sie als Vorlage zum Definieren von send_online_shopping_info_message zu verwenden.

Zunächst sollten wir den Fallback-Text so aktualisieren, dass er eine entsprechende Nachricht enthält. Der Fallback-Text wird verwendet, wenn das Gerät aus irgendeinem Grund keine Rich Card empfangen kann. Als Nächstes sollten wir BusinessMessagesRichCard mit einem relevanten Titel, einer Beschreibung, Vorschlägen und einem Medienfeld aktualisieren. Unsere Funktion sollte wie folgt aussehen:

bm-django-echo-bot/bopis/views.py

...
def send_online_shopping_info_message(conversation_id):
    fallback_text = ('Online shopping will be available soon!')

    rich_card = BusinessMessagesRichCard(
        standaloneCard=BusinessMessagesStandaloneCard(
            cardContent=BusinessMessagesCardContent(
                title='Online shopping info!',
                description='Thanks for your business, we are located in SF near the Golden Gate Bridge. Online shopping is not yet available, please check back with us in a few days.',
                suggestions=[],
                media=BusinessMessagesMedia(
                    height=BusinessMessagesMedia.HeightValueValuesEnum.MEDIUM,
                    contentInfo=BusinessMessagesContentInfo(
                        fileUrl=SAMPLE_IMAGES[4],
                        forceRefresh=False
                    ))
                )))

    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        richCard=rich_card,
        fallback=fallback_text)

    send_message(message_obj, conversation_id)
...

Endlich! Unser digitaler Kundenservicemitarbeiter kann jetzt auf Nutzeranfragen zum Online-Shopping reagieren. Derzeit unterstützt unser Kundenservicemitarbeiter das Online-Shopping noch nicht. Wir senden dem Nutzer eine Nachricht, in der wir ihn darüber informieren, dass die Funktion bald verfügbar ist. So sieht unser digitaler Kundenservicemitarbeiter aus, wenn sich der Nutzer nach dem Online-Shopping erkundigt.

Genau wie die vorherige Änderung, die wir vorgenommen haben, damit Nutzer sich nach den Öffnungszeiten erkundigen können, ist diese Änderung sofort sichtbar, wenn Sie ngrok verwenden oder wenn Sie den Code in Google Cloud App Engine bereitstellen.

Im nächsten Teil verwenden wir Gesprächseinstiege und Vorschlags-Chips, um das Gespräch zum Happy Path zu führen.

Chips zur Gesprächsführung

Wir haben einige Änderungen am Quellcode vorgenommen und den aktualisierten digitalen Agenten bereitgestellt, aber wir würden nicht erwarten, dass Nutzer „Geschäftszeiten-Anfrage“ eingeben müssen. oder „online-shopping-infos“ um sich nach dem Unternehmen zu erkundigen. Aktualisieren wir die Gesprächseinstiege so, dass die Nutzenden beim Öffnen der Unterhaltung nicht nur mit einer netten Willkommensnachricht begrüßt werden, sondern auch einen Gesprächseinstieg erhalten.

Rufen Sie die Business Communications Console auf und greifen Sie auf die Seite Agent-Informationen des Agents zu. Wir haben zuvor Gesprächseinstiege für „Chips“, „Karte“ und „Karussell“ definiert. Auch wenn diese noch funktionieren, sind sie für unsere Geschäftsfunktion nicht mehr relevant. Sie können sie lassen, um diese umfangreichen Funktionen weiter zu präsentieren, oder sie entfernen, damit Ihr digitaler Kundenservicemitarbeiter Gesprächseinstiege speziell für das Bonjour-Meal-Geschäft zeigt.

Wir erstellen zwei neue Gesprächseinstiege. Wählen Sie für den ersten Text die Option „Wie lauten Ihre Öffnungszeiten?“ aus. und legen Sie für Postback data (Postback-Daten) die Option „business-hours-inquiry“ (Geschäftszeitanfragen) fest. Lege für den zweiten Gesprächseinstieg den Text auf „Kann ich hier etwas kaufen?“ fest. und legen Sie das Postback-Daten auf „online-shopping-info“ fest.

Das Ergebnis sollte die Konfiguration wie im folgenden Screenshot sein:

Wie bei anderen Änderungen in der Business Communications Console dauert es eine Weile, bis sie wirksam werden und Sie sie auf Ihrem Mobilgerät sehen können.

Nachdem wir nun mit dem Gesprächseinstieg fertig sind, möchten wir die Nutzenden auch auf einen Happy Path führen, sobald das Gespräch begonnen hat. Es ist möglich, Chips nach dem Senden einer Nachricht zu verwenden, um den Nutzer zu anderen Funktionen zu führen, die der digitale Agent unterstützen kann. Wenn sich der Nutzer nach den Öffnungszeiten oder dem Onlineshopping erkundigt, senden wir also eine Nachricht mit der Empfehlung, etwas anderes mit dem Agent zu tun.

Fügen Sie am Ende der Funktion Folgendes hinzu:

bm-django-echo-bot/bopis/views.py

...
def send_online_shopping_info_message(conversation_id):
...
    # at the end of the function, send a message with suggestions
    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        text='Let us know how else we can help you:',
        fallback='Please let us know how else we can help you.',
        suggestions=[
            BusinessMessagesSuggestion(
                reply=BusinessMessagesSuggestedReply(
                text='Business hours',
                postbackData='business-hours-inquiry')
            ),
        ])

    send_message(message_obj, conversation_id)
...

# Let's do the same with the business hours
def send_message_with_business_hours(conversation_id):
...
    # at the end of the function, send a message with suggestions
    message_obj = BusinessMessagesMessage(
        messageId=str(uuid.uuid4().int),
        representative=BOT_REPRESENTATIVE,
        text='Let us know how else we can help you:',
        fallback='Please let us know how else we can help you.',
        suggestions=[
            BusinessMessagesSuggestion(
                reply=BusinessMessagesSuggestedReply(
                text='Can I purchase online?',
                postbackData='online-shopping-inquiry')
            ),
        ])

    send_message(message_obj, conversation_id)
...

Beachten Sie, dass das Textfeld in einem BusinessMessagesSuggestion auf 25 Zeichen beschränkt ist (siehe Dokumentation).

Hier sind einige Screenshots der erwarteten Nutzererfahrung mit aktualisierten Gesprächseinstiegen und der strategischen Verwendung von Vorschlags-Chips.

6. Glückwunsch

Herzlichen Glückwunsch, Sie haben Ihren ersten digitalen Business Messages-Agent erstellt.

Sie haben eine Webanwendung bereitgestellt, um Ihren digitalen Agent in Business Messages zu unterstützen, haben die Business Communications Console verwendet, um den Agent zu ändern, und die Nutzererfahrung mit einem digitalen Agent durch Änderungen am Quellcode verändert.

Sie kennen jetzt die wichtigsten Schritte zum Erstellen interaktiver Business Messages-Funktionen und die Möglichkeiten, die sich daraus ab jetzt ergeben, sind aufregend. Ihr Agent kann so erweitert werden, dass er die Inventarsuche unterstützt oder einen Einkaufswagen einführt, um nachzuverfolgen, was der Nutzer interessiert. Sie könnten ein Karussell verwenden, um Menüelemente zu präsentieren, und Vorschläge verwenden, um es den Nutzern zu ermöglichen, Elemente auszuwählen, die für sie interessant sind.

Hier ist eine Vorschau, wie das aussehen könnte.

Wie schaffe ich einen angenehmen Dialog?

Die besten Kundenservicemitarbeiter stellen den Nutzern Kontextinformationen zur Verfügung und bieten ihnen während des Gesprächs zusätzliche Funktionen, damit sie wie üblich am Telefon oder sogar persönlich mit dem Unternehmen interagieren können. Überlegen Sie, wie sich die folgenden Themen auf ein Gespräch mit einem Unternehmen, mit dem Sie zusammenarbeiten möchten, auswirken könnten.

Kontext bereitstellen und Erwartungen wecken

Kontext kann alles sein – von expliziten Angaben, wie Sie den Nutzenden helfen können, bis hin zu einer Persona, mit der sich die Nutzenden identifizieren können. Erfolgreiche Kundenservicemitarbeiter in Business Messages verwenden den repräsentativen Avatar, um dem Nutzer zu zeigen, mit wem er spricht.

Das Festlegen von Erwartungen hängt von der User Experience ab, die Sie entwickeln. Wenn Ihr Agent beispielsweise die Inventarsuche unterstützt, informieren Sie den Nutzer zuerst darüber, dass die Verfügbarkeit gering sein könnte, bevor Sie die Antwort geben.

Nutzern Funktionen bereitstellen

Verbraucher treten ständig mit Unternehmen in Kontakt. Von Anfragen wie dem Prüfen des Status einer Bestellung bis hin zur Prüfung, ob ein Artikel auf Lager ist – Business Messages unterstützt komplexe Nutzerinteraktionen. Viele Nutzer rufen Unternehmen weiterhin an, um Antworten auf ihre Fragen zu erhalten, auch wenn die Antworten auf der Unternehmenswebsite verfügbar sind. Das hat zur Folge, dass Unternehmen mehr Ressourcen investieren müssen, um das Anrufvolumen bewältigen zu können – insbesondere während der Feiertage.

Nutzer bei Laune halten

Bieten Sie dialogorientierte Touchpoints, um das Interesse der Nutzer an der Unterhaltung aufrechtzuerhalten. Zwischen Nachrichten können Sie Eingabeanzeigen aufrufen, um den Nutzer darüber zu informieren, dass Sie eine Antwort für den Nutzer verarbeiten.

Mit Rich-Funktionen wie Eingabeanzeigen, Vorschlags-Chips, Rich Cards und Karussells können Sie die Nutzenden durch Happy Path führen und bestimmte Aufgaben erledigen, z. B. das Bestellen aus einem Menü mit Elementen. Ziel ist es, die Zahl der Anrufe bei der Telefonleitung eines Unternehmens zu reduzieren.

Es ist wichtig, dass eine Unterhaltung dem Nutzer Funktionen bietet. Nutzer, die per Messaging mit einem Unternehmen Kontakt aufnehmen, erwarten, dass ihre Fragen schnell beantwortet werden. In einer nicht idealen Situation kann der digitale Kundenservicemitarbeiter das Gespräch nicht fördern, was zu einer schlechten Nutzererfahrung führen kann. Glücklicherweise gibt es Möglichkeiten, dies zu umgehen, z. B. durch Übertragen der Unterhaltung an einen Kundenservicemitarbeiter. Mehr dazu erfahren Sie in einem zukünftigen Codelab.

Was liegt als Nächstes an?

Wenn Sie bereit sind, können Sie sich einige der folgenden Themen ansehen, um mehr über die komplexeren Interaktionen zu erfahren, die Sie in Business Messages umsetzen können

Referenzdokumente

SuggestedReply
Referenzdokument zu Business Messages-Nachrichten
JSON-Definition für RichCard