Business Messages bietet eine Weboberfläche mit der Bezeichnung Business Communications Developer Console. Mit dieser Konsole können Sie Agents erstellen, verwalten und starten.
Die Business Communications Developer Console unterscheidet sich von der Google Cloud Platform. (GCP) Console. Mit der Business Communications Developer Console verwalten Sie Business Messages-Agents. Mit der GCP Console können Sie GCP-spezifische Einstellungen (z. B. für die Abrechnung und APIs) sowie andere GCP-Ressourcen verwalten.
Sie können mit der Business Communications Developer Console Agents erstellen und verwalten. Mit der Business Communications API können Sie Agents für erweiterte Szenarien wie die Einbindung in Ihr eigenes Produkt erstellen und verwalten.
In der Kurzanleitung und den Anleitungen wird Schritt für Schritt erklärt, wie Sie die Console und die APIs verwenden. Diese Seite bietet einen allgemeinen Überblick über das Layout der Benutzeroberfläche und die Verwendung der Konsole.
Konsole verwenden
Die Konsole wird zum Erstellen, Verwalten, Aktualisieren, Bestätigen und Starten von Agents verwendet. Damit können Sie
- Konfigurieren Sie den Webhook und andere Partnerkontoeinstellungen.
- Erstellen und verwalten Sie Agents, die alle Attribute und Daten enthalten, die die dialogorientierte Darstellung einer Marke definieren.
- Konfigurieren Sie nicht lokale Agent-Einstellungen und die Nachrichtenverfügbarkeit.
- Erstellen und verwalten Sie Standorte, die die physischen Standorte eines Unternehmens repräsentieren.
- Rufen Sie Test-URLs für Agents und Standorte ab, um zu sehen, wie eine Unterhaltung mit Ihrem Agent für Nutzer aussieht.
- Sie können in Dialogflow einbinden, um häufig gestellte Fragen zu beantworten.
- Überprüfen Sie den Agent und die Standorte.
- Starten Sie den Agent und die Standorte.
Startbildschirm der Konsole
Wenn Sie die Konsole zum ersten Mal laden, wird der Agent-Auswahlbildschirm angezeigt. Auf dieser Seite wird über den Link Partnerkontoeinstellungen die Seite mit den Kontoeinstellungen Ihres Partners geöffnet.
Darüber hinaus können Sie auf dem Startbildschirm Folgendes tun:
- Wählen Sie einen vorhandenen Agent aus.
- Neue Agents erstellen.
- Sortiere die Agents.
- Agents nach Partnerkonto filtern.
Standardmäßig werden Agents in einer Kartenansicht angezeigt. Agents werden nach der letzten Aktualisierung sortiert. Wenn Sie zu einer Listenansicht wechseln möchten, verwenden Sie die Optionen Anzeigen als rechts. In der Listenansicht können Agents nach Name, Typ, Status und Datum der letzten Aktualisierung sortiert werden.
Wenn Sie mehrere Partnerkonten haben, gibt es eine Drop-down-Auswahl für das Partnerkonto, in der Sie die Agent-Auswahl nach einem Partnerkonto filtern können.
Kontoeinstellungen
Auf der Seite „Einstellungen“ können Sie Folgendes aktualisieren:
- Name des Unternehmens
- Anzeigename
- Technischer Ansprechpartner
- Webhook
Im seitlichen Navigationsbereich können Sie auf die Marken- und Nutzerverwaltung sowie auf Ihre Dienstkonten zugreifen.
Markenmanagement
Eine Marke ist ein Unternehmen, eine Organisation oder eine Gruppe. Ein Agent ist die dialogorientierte Darstellung einer Marke.
Auf dieser Seite können Sie Marken hinzufügen, bearbeiten und entfernen. Wenn Sie eine Marke entfernen, werden auch alle zugehörigen Agents gelöscht. Eine Marke kann nicht entfernt werden, wenn sie mit einem gestarteten Agent verknüpft ist.
Nutzerverwaltung
Auf dieser Seite können Sie den Zugriff auf Ihre registrierten Partnerkonten hinzufügen und entfernen. Über das Drop-down-Menü in der oberen Navigationsleiste können Sie zwischen Konten wechseln.
Nutzer hinzufügen
Um einen Nutzer hinzuzufügen, geben Sie dessen E-Mail-Adresse in das Eingabefeld für die E-Mail-Adresse ein und wählen Sie die Rolle aus.
Neue Nutzer können die Rollen Manager oder Leser haben. Eine Managerrolle hat Zugriff auf alle Funktionen in der Console, während eine Leserrolle Lesezugriff auf Agent- und Standortinformationen bietet.
Wenn Sie einen neuen Nutzer hinzufügen, erhält der Nutzer eine E-Mail mit der Information, dass er jetzt Zugriff auf das Partnerkonto hat.
Die E-Mail-Adresse, mit der das Partnerkonto ursprünglich registriert wurde, hat die Rolle Inhaber.
Nutzer entfernen
So entfernen Sie Nutzer:
- Suchen Sie in der Liste nach dem Nutzer, den Sie entfernen möchten.
- Klicken Sie auf die Schaltfläche .
- Wählen Sie Nutzer entfernen aus.
- Bestätigen Sie das Entfernen.
Der entfernte Nutzer wird per E-Mail darüber benachrichtigt, dass er keinen Zugriff mehr auf das Konto hat.
Sie können einen Nutzer mit der Rolle „Inhaber“ nicht entfernen. Wenn Sie einen Inhaber ändern oder entfernen möchten, wenden Sie sich an den Support.
Nutzerrolle ändern
So aktualisieren Sie die Rolle eines Nutzers:
- Suche den Nutzer, dessen Rolle du aktualisieren möchtest.
- Klicken Sie auf die Schaltfläche .
- Wählen Sie Rolle bearbeiten aus.
- Wählen Sie im Drop-down-Menü eine neue Rolle aus.
- Klicken Sie auf Speichern.
Dienstkonten
Wenn Sie Aufrufe an die Business Communications API oder Business Messages API senden, authentifizieren Sie die Aufrufe mit einem Dienstkontoschlüssel. Mit Dienstkontoschlüsseln können Sie Marken, Agents und Standorte erstellen und verwalten sowie Nachrichten und Anfragen als Agent senden.
Wählen Sie in der seitlichen Navigationsleiste Dienstkonten aus, um einen Dienstkontoschlüssel zu generieren. Die GCP Console für das GCP-Projekt, das dem derzeit ausgewählten Partnerkonto zugeordnet ist, wird geöffnet.
So erstellen Sie ein Dienstkonto und eine Schlüsseldatei:
- Klicken Sie auf Dienstkonto erstellen.
- Geben Sie unter Dienstkontoname den Namen des Agents ein und klicken Sie auf Erstellen.
- Klicken Sie auf Fertig.
- Suchen Sie das neue Dienstkonto in der Tabelle und klicken Sie dann auf > Schlüssel erstellen.
- Wählen Sie JSON aus und klicken Sie dann auf Erstellen.
Ihr Browser lädt den Dienstkontoschlüssel herunter.
Agent-Auswahl
Nachdem Sie einen Agent ausgewählt haben, werden Sie zur Übersichtsseite für den ausgewählten Agent weitergeleitet.
Die Übersicht enthält Folgendes:
- Name der Marke
- Name des Agents
- Das Partnerkonto, in dem der Agent erstellt wurde
- Die Marken-ID
- Agent-ID
- Agent-Test-URLs, mit denen Sie sehen können, wie eine Unterhaltung mit diesem Agent Nutzern angezeigt wird, und wie Sie die Nachrichteninfrastruktur überprüfen können
- Status der Agent-Verifizierung
- Vorschau des Agents
- Standorte, die mit dem Agent verknüpft sind
- Links zur relevanten Dokumentation
Im linken Navigationsbereich können Sie auf Folgendes zugreifen:
- Informationen zum Agent
- Standorte
- Integrationen
- Fragen
- Fehlerbehebungsprotokolle
- Überprüfung
- Launch
- Dashboard für Messwerte
- Links zur relevanten Dokumentation
Informationen zum Agent
Auf der Informationsseite zum Agent können Sie die Attribute eines Agents aktualisieren.
Die Seite ist in zwei Spalten unterteilt. Verwenden Sie die Eingabefelder in der linken Spalte, um Agent-Felder wie den Namen des Agents, das Logo, die Willkommensnachricht, die Auslöser für Unterhaltungen und die Attribute für den Standort und nicht lokale Einstiegspunkte zu aktualisieren. Nach dem Starten des Agents können Sie einige Felder wie Agent-Name und Logo nicht mehr aktualisieren.
In der rechten Spalte können Sie die Test-URLs für Ihren Agent abrufen und sich eine Vorschau anzeigen lassen, wie Ihr Agent auf dem Gerät eines Nutzers aussieht.
Standortverwaltung
Auf dieser Seite können Sie Standorte hinzufügen, Test-URLs für Unternehmensstandorte abrufen und Standorte bestätigen, nachdem Sie den Agent bestätigt haben.
Integrationen
Auf dieser Seite können Sie Dialogflow integrieren und einen Bot einrichten, um häufig gestellte Fragen zu beantworten.
Umfragen
Auf dieser Seite können Sie die Kundenumfrage für Ihren Agent anpassen.
Protokolle
Auf dieser Seite erfahren Sie, wie Sie Probleme bei der Zustellung von Nachrichten beheben können. Logs sind 14 Tage lang verfügbar. Filtern Sie nach Unterhaltungs-ID, Nachrichten-ID, Zeitstempel, Anleitung oder Status, um die Logs zu finden, die für Nutzerprobleme relevant sind. Sie können auch auf dieser Seite prüfen, ob Sie versehentlich ungültige Nachrichten senden.
Logs enthalten die Nutzlast der Nachricht mit Ausnahme von entfernten sensiblen Feldern wie Nachrichtentext. Fehlgeschlagene und abgelehnte Nachrichten enthalten zusätzliche Fehlerdetails zur Fehlerbehebung.
Für einige Ereignisse (z. B. Eingabeanzeigen) gibt es keine Belege. Daher wird für ihren Status „Gesendet“ angezeigt.
Bestätigung
Auf dieser Seite können Sie den Agent zur Überprüfung einreichen.
Aktivieren
Auf dieser Seite können Sie den Agent für Standorte und nicht lokale Einstiegspunkte starten sowie einzelne Standorte aktivieren.
