Slash-Befehle in einer Google Chat-App beantworten

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, z. B. /about, um Informationen zur Chat-App zu erhalten. Nutzer können verfügbare Slash-Befehle finden, indem sie einen Schrägstrich in Google Chat eingeben. Daraufhin wird ein Fenster mit den verfügbaren Befehlen für die Chat-App angezeigt:

um zu entscheiden, ob Sie Slash-Befehle einrichten sollten und wie Sie 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 und in der Chat App sichtbar sind. 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

Slash-Befehl einrichten

In diesem Abschnitt wird erläutert, wie Sie mit den folgenden Schritten einen Schrägstrich einrichten. Befehl:

1. Erstellen Sie einen Namen für Ihren Slash-Befehl.
2. Konfigurieren Sie den Befehlsvorschlag in der Google Chat API.

Befehl benennen

Der Name eines Slash-Befehls ist das, was Nutzer in eine Chatnachricht eingeben zum Aufrufen der Chat-App. Eine kurze Beschreibung wird unter dem Namen angezeigt, um die Nutzer zur Verwendung des Befehls aufzufordern:

Beachte bei der Auswahl eines Namens und einer Beschreibung für deinen Slash-Befehl die folgenden Empfehlungen:

• So benennen Sie den Slash-Befehl:

  • Verwenden Sie kurze, beschreibende und umsetzbare Wörter oder Wortgruppen, damit die Befehle für die Nutzer klar und einfach sind. Verwenden Sie beispielsweise /remindMe anstelle von /createAReminder.
  • 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 Ihr Befehl eine typische Interaktion oder Funktion beschreibt, können Sie einen gängigen Namen verwenden, den Nutzer kennen und erwarten, z. B. /settings oder /feedback. Verwenden Sie ansonsten eindeutige Befehlsnamen. Wenn der Befehlsname für andere Chat-Apps identisch ist, muss der Nutzer ähnliche Befehle durchsuchen, um Ihren zu finden und zu verwenden.

• So beschreiben Sie den Slash-Befehl:

  • Die Beschreibung sollte kurz und klar sein, damit Nutzer wissen, was sie erwartet, wenn sie den Befehl aufrufen.
  • 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 etwa Remind me to do [something] at [time] fest.
  • Lassen Sie Nutzer wissen, wenn 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).

Befehlszeilen-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:

1. Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü menu > APIs und Dienste > Aktivierte APIs und Dienste > Google Chat API.

   Zur Seite „Google Chat API“

2. Klicken Sie auf Konfiguration.

3. Klicken Sie unter Slash-Befehle auf Slash-Befehl hinzufügen.

4. Geben Sie einen Namen, eine Befehls-ID und eine Beschreibung für den Befehl ein:

   1. 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.
   2. Beschreibung: Text, der beschreibt, wie der Befehl verwendet und formatiert wird. Beschreibungen dürfen maximal 50 Zeichen lang sein.
   3. 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.

5. Optional: Wenn Sie möchten, dass die Chat-App auf über ein Dialogfeld den Befehl Kästchen Dialogfeld öffnen

6. Klicken Sie auf Speichern.

Der Slash-Befehl ist jetzt für die Chat App konfiguriert.

Auf einen Slash-Befehl reagieren

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.

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 die Befehls-ID enthält, gibt die Chat App eine private Nachricht zurück:

// Checks for the presence of a slash command in the message.
if (event.message.slashCommand) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  switch (event.message.slashCommand.commandId) {
    case ABOUT_COMMAND_ID:
      return res.send({
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      });
  }
}

// Checks for the presence of a slash command in the message.
if (event.message.slashCommand) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  switch (event.message.slashCommand.commandId) {
    case ABOUT_COMMAND_ID:
      return {
        privateMessageViewer: event.user,
        text: 'The Avatar app replies to Google Chat messages.'
      };
  }
}

# Checks for the presence of a slash command in the message.
if "slashCommand" in request_json["message"]:
  # Executes the slash command logic based on its ID.
  # Slash command IDs are set in the Google Chat API configuration.
  if request_json["message"]["slashCommand"]["commandId"] == ABOUT_COMMAND_ID:
    return {
      "privateMessageViewer": request_json["user"],
      "text": 'The Avatar app replies to Google Chat messages.'
    }

// Checks for the presence of a slash command in the message.
if (body.getAsJsonObject("message").has("slashCommand")) {
  // Executes the slash command logic based on its ID.
  // Slash command IDs are set in the Google Chat API configuration.
  JsonObject slashCommand = body.getAsJsonObject("message").getAsJsonObject("slashCommand");
  switch (slashCommand.get("commandId").getAsString()) {
    case ABOUT_COMMAND_ID:
    JsonObject aboutMessage = new JsonObject();
    aboutMessage.addProperty("text", "The Avatar app replies to Google Chat messages.");
    aboutMessage.add("privateMessageViewer", body.getAsJsonObject("user"));
      response.getWriter().write(gson.toJson(aboutMessage));
      return;
  }
}

Legen Sie ABOUT_COMMAND_ID auf die Befehls-ID fest, die Sie beim Konfigurieren des Slash-Befehls in der Chat API angegeben 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 Dialoge öffnen