Auf dieser Seite wird erläutert, wie Sie Slash-Befehle für Ihr Google Chat App.
Ein Slash-Befehl ist eine gängige Methode, mit der Nutzer ein Objekt aufrufen und mit ihm interagieren. Chat-App. Außerdem helfen Slash-Befehle, die wichtigsten Funktionen einer Chat-App nutzen.
Um einen Slash-Befehl zu verwenden, geben Nutzer einen Schrägstrich (/
) und dann einen kurzen Textbefehl ein.
wie /about
, um Informationen zur Chat App zu erhalten.
Nutzer können verfügbare Slash-Befehle finden, indem sie
Google Chat, das ein Fenster mit den verfügbaren Befehlen für den
Chat-App:
![Slash-Befehlsfenster](https://developers.google.com/static/workspace/chat/images/slash-command-window.png?hl=de)
um zu entscheiden, ob Sie Slash-Befehle einrichten sollten Nutzungsinteraktionen gestalten, siehe Definieren Sie alle Kaufprozesse.
Slash-Befehle mit privaten Antworten
Wenn ein Nutzer eine Nachricht sendet, die einen Slash-Befehl enthält, wird die Nachricht für den Nutzer und die Chat App sichtbar. Wenn Sie haben die Chat-App so konfiguriert, dass sie zu Gruppenbereichen hinzugefügt wird mit mehreren Personen arbeiten, können Sie auf den Slash-Befehl um die Interaktion zwischen dem Nutzer und dem Chat-App.
Um mehr über eine Chat-App zu erfahren,
in einem Bereich entdecken können, können Nutzer Befehle wie /about
oder /help
verwenden.
Damit nicht alle anderen Personen im Gruppenbereich benachrichtigt werden,
Die Chat-App kann privat mit Informationen zu folgenden Themen antworten:
wie Sie die Chat App verwenden und Support anfordern.
Vorbereitung
Node.js
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein Chat-App mit einem HTTP-Dienst verwenden können, führen Sie diese Kurzanleitung aus.
Apps Script
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein interaktive Chat-App in Apps Script verwenden möchten, führen Sie diese Kurzanleitung aus.
Python
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein Chat-App mit einem HTTP-Dienst verwenden können, führen Sie diese Kurzanleitung aus.
Java
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein Chat-App mit einem HTTP-Dienst verwenden können, führen Sie diese Kurzanleitung aus.
Slash-Befehl einrichten
In diesem Abschnitt wird erläutert, wie Sie mit den folgenden Schritten einen Schrägstrich einrichten. Befehl:
- Geben Sie einen Namen für den Slash-Befehl ein.
- Konfigurieren Sie den Slash-Befehl in der Google Chat API.
Slash-Befehl benennen
Der Name eines Slash-Befehls ist das, was Nutzer in eine Chatnachricht eingeben zum Aufrufen der Chat-App. Eine kurze Beschreibung erscheint unter dem Namen, um die Nutzer zur Verwendung des Befehls aufzufordern:
<ph type="x-smartling-placeholder">![Name und Beschreibung des Slash-Befehls](https://developers.google.com/static/workspace/chat/images/slash-command-description.png?hl=de)
Berücksichtigen Sie bei der Auswahl eines Namens und einer Beschreibung für Ihren Slash-Befehl Empfehlungen:
So benennen Sie den Slash-Befehl:
- Verwenden Sie kurze, aussagekräftige und umsetzbare Wörter oder Wortgruppen, um
Befehle einfach und verständlich. Anstatt beispielsweise zu sagen,
/createAReminder
,/remindMe
verwenden. - Wenn Ihr Befehl mehr als ein Wort enthält, helfen Sie Nutzern, den Befehl zu lesen
indem Sie für das erste Wort nur Kleinbuchstaben verwenden und dann das erste großschreiben.
Buchstaben zusätzlicher Wörter. So wird beispielsweise anstelle von
/updatecontact
/updateContact
verwenden. - Überlegen Sie, ob Sie einen eindeutigen oder einen allgemeinen Namen für Ihren Befehl verwenden möchten. Wenn
eine typische Interaktion oder Funktion beschreibt, können Sie
allgemeinen Namen, den Nutzer erkennen und erwarten, z. B.
/settings
oder/feedback
. Verwenden Sie andernfalls eindeutige Befehlsnamen. derselbe Befehlsname für andere Chat-Apps ist, muss der Nutzer Filtere ähnliche Befehle, um deine zu finden und zu verwenden.
- Verwenden Sie kurze, aussagekräftige und umsetzbare Wörter oder Wortgruppen, um
Befehle einfach und verständlich. Anstatt beispielsweise zu sagen,
So beschreiben Sie den Slash-Befehl:
- Die Beschreibung sollte kurz und klar sein, damit Nutzer wissen, was sie erwartet wenn der Befehl aufgerufen wird.
- Teilen Sie den Nutzern mit, ob es Formatierungsanforderungen für den Befehl gibt.
Wenn Sie beispielsweise einen
/remindMe
-Befehl erstellen, für den ein Argument erforderlich ist, Text eingeben, legen Sie die Beschreibung auf etwaRemind me to do [something] at [time]
fest. - Lassen Sie Nutzer wissen, ob die Chat-App auf
oder privat für den Nutzer, der den Befehl aufruft.
Für den Slash-Befehl
/about
könnten Sie ihn beispielsweise so beschreiben:Learn about this app (Only visible to you)
. Um privat auf eine Slash-Befehl verwenden, finden Sie im Abschnitt Mit einer privaten Nachricht antworten.
Slash-Befehl in der Google Chat API konfigurieren
Um einen Slash-Befehl zu erstellen, müssen Sie Informationen über den Befehl in Konfiguration Ihrer Chat-App für die Google Chat API konfigurieren.
So konfigurieren Sie einen Slash-Befehl in der Google Chat API: Schritte:
Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü > APIs und Dienste > Aktivierte APIs und Dienste > Google Chat API
Klicken Sie auf Konfiguration.
Klicken Sie unter Slash-Befehle auf Slash-Befehl hinzufügen.
Geben Sie einen Namen, eine Befehls-ID und eine Beschreibung für den Befehl ein:
- Name:Der Anzeigename für den Befehl und die Nutzereingabe zum Aufrufen Ihrer Anwendung. Muss mit einem Schrägstrich beginnen, darf nur Text enthalten und darf darf maximal 50 Zeichen lang sein.
- Beschreibung:Der Text zur Beschreibung der Verwendung und Formatierung. den Befehl. Beschreibungen dürfen maximal 50 Zeichen lang sein.
- Befehls-ID:Eine Zahl zwischen 1 und 1.000, die in Ihrem Die Chat-App verwendet, um den Slash-Befehl zu erkennen und eine Antwort zurückgeben.
Optional: Wenn Sie möchten, dass Ihre Chat-App auf über ein Dialogfeld den Befehl Kästchen Dialogfeld öffnen
Klicken Sie auf Speichern.
Der Slash-Befehl ist jetzt für die Chat-App konfiguriert.
Auf einen Slash-Befehl antworten
<ph type="x-smartling-placeholder">
Wenn Nutzer eine Chatnachricht erstellen, die einen Slash-Befehl enthält,
Ihre Chat-App empfängt ein MESSAGE
-Interaktionsereignis.
Die Ereignisnutzlast enthält das Objekt slashCommand
.
und slashCommandMetadata
Objekte. Diese Objekte enthalten Details zu dem in der Nachricht verwendeten Befehl
einschließlich der Befehls-ID, damit Sie eine entsprechende Antwort zurückgeben können.
![Private Nachricht für die
Chat-App von Cymbal Labs. Die Meldung besagt, dass das
Die Chat-App wurde von Cymbal Labs erstellt und teilt einen Link
und einen Link zur Kontaktaufnahme mit dem Supportteam.](https://developers.google.com/static/workspace/chat/images/private-message.png?hl=de)
/help
ein, um zu erklären, wie Sie Support erhalten.Der folgende Code zeigt ein Beispiel für eine Chat-App.
die auf den Slash-Befehl /about
antwortet, indem er Folgendes verarbeitet:
MESSAGE
Interaktionsereignisse und die Erkennung
Gibt an, ob die Nachricht die entsprechende Befehls-ID enthält. Wenn die Nachricht Folgendes enthält:
der Befehls-ID gibt die Chat-App eine private Nachricht zurück:
Node.js
Apps Script
Python
Java
Legen Sie für ABOUT_COMMAND_ID
die Befehls-ID fest, die Sie
angegeben, wenn Sie
den Slash-Befehl in der Chat API konfiguriert haben.
Informationen zum Testen dieses Codes finden Sie unter
Interaktive Funktionen für Google Chat-Apps testen
Weitere Informationen
- Beispiele für Chat-Apps mit Slash-Befehlen
- Nachricht senden
- Private Nachrichten senden
- Interaktive Dialogfelder öffnen