Google Chat-Nachrichten senden

Auf dieser Seite wird erläutert, wie Google Chat-Apps Nachrichten senden können, um auf Nutzerinteraktionen zu antworten.

  • Kontaktformular über Slash-Befehl
    Abbildung 1: Eine Chat-App antwortet auf einen Slash-Befehl mit einer Textnachricht und einer Schaltfläche.
  • Kontaktformular in einem Dialogfeld.
    Abbildung 2: A In einer Chat-App wird ein Dialogfeld geöffnet, in dem Nutzer Informationen eingeben können.
  • Kartenmitteilung mit Formulareingabe-Widgets.
    Abbildung 5: A Eine Chat-App sendet eine Nachricht mit Text und einer interaktiven Karte.

Vorbereitung

Node.js

Ein Google Workspace-Add‑on, das Google Chat erweitert. HTTP-Kurzanleitung

Apps Script

Ein Google Workspace-Add‑on, das Google Chat erweitert. Wenn Sie eine erstellen möchten, folgen Sie der Apps Script-Kurzanleitung.

Mitteilung gestalten

Chat-Apps können in einer Nachricht Folgendes enthalten:

  • Text mit Hyperlinks, @Erwähnungen und Emojis.
  • Eine oder mehrere Karten, die in einer Nachricht angezeigt oder als Dialogfeld in einem neuen Fenster geöffnet werden können.
  • Ein oder mehrere Zubehör-Widgets, die als Schaltflächen nach Text oder Karten in einer Nachricht angezeigt werden.

Weitere Informationen zum Entwerfen von Nachrichten finden Sie in der folgenden Google Chat API-Dokumentation:

Mit Nach­richt antworten

Chat-Apps können mit einer Nachricht auf die folgenden Trigger oder Interaktionen reagieren:

  • Nachrichtentrigger, z. B. wenn Nutzer eine Chat-App @erwähnen oder eine Direktnachricht an sie senden.
  • „Zum Gruppenbereich hinzugefügt“-Trigger, z. B. wenn Nutzer die Chat-App über den Google Workspace Marketplace installieren oder einem Gruppenbereich hinzufügen.
  • Schaltflächenklicks von Karten in Nachrichten oder Dialogfeldern. Das kann beispielsweise passieren, wenn Nutzer Informationen eingeben und auf „Senden“ klicken.

Andernfalls können Chat-Apps Nachrichten proaktiv senden, indem sie die Google Chat API aufrufen.

Wenn Sie mit einer Nachricht antworten möchten, geben Sie die Aktion DataActions mit einem CreateMessageAction-Objekt zurück:

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": MESSAGE
}}}

Ersetzen Sie MESSAGE durch eine Message-Ressource aus der Chat API. Weitere Informationen zur Funktionsweise von Aktionen finden Sie unter Chat-Aktionen.

Im folgenden Beispiel wird eine SMS von einer Chat-App erstellt und gesendet, sobald sie einem Gruppenbereich hinzugefügt wird. Wenn Sie eine SMS senden möchten, wenn ein Nutzer Ihre Chat-App einem Gruppenbereich hinzufügt, muss Ihre Chat-App auf den Trigger Added to space (Dem Gruppenbereich hinzugefügt) mit der Aktion DataActions reagieren:

Node.js

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} req The request object from Google Workspace add-on.
 * @param {Object} res The response object from the Chat app. An onboarding message that
 *                     introduces the app and helps people get started with it.
 */
exports.cymbalApp = function cymbalApp(req, res) {
  const chatEvent = req.body.chat;
  // Send an onboarding message when added to a Chat space
  if (chatEvent.addedToSpacePayload) {
    res.json({ hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
      text: 'Hi, Cymbal at your service. I help you manage your calendar' +
            'from Google Chat. Take a look at your schedule today by typing' +
            '`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn' +
            'what else I can do, type `/help`.'
    }}}}});
  }
};

Apps Script

/**
 * Sends an onboarding message when the Chat app is added to a space.
 *
 * @param {Object} event The event object from Chat API.
 * @return {Object} Response from the Chat app. An onboarding message that
 *                  introduces the app and helps people get started with it.
 */
function onAddedToSpace(event) {
  return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
    text: 'Hi, Cymbal at your service. I help you manage your calendar' +
          'from Google Chat. Take a look at your schedule today by typing' +
          '`/checkCalendar`, or schedule a meeting with `/scheduleMeeting`. To learn' +
          'what else I can do, type `/help`.'
  }}}}};
}

Das Codebeispiel gibt die folgende SMS zurück:

Beispiel für eine Onboarding-Mitteilung

Weitere Beispiele für das Antworten mit einer Nachricht finden Sie in den folgenden Anleitungen:

Nachricht aktualisieren

Chat-Apps können auch Nachrichten aktualisieren, die sie senden. Beispiel: Eine Nachricht aktualisieren, nachdem ein Nutzer ein Dialogfeld gesendet oder auf eine Schaltfläche in einer Nachricht geklickt hat.

Wenn Sie eine Chat-App-Nachricht aktualisieren möchten, geben Sie die Aktion DataActions mit einem UpdateMessageAction zurück, wie im folgenden Beispiel gezeigt:

{ "hostAppDataAction": { "chatDataAction": { "updateMessageAction": {
  "message": MESSAGE
}}}}

Ersetzen Sie MESSAGE durch eine Message-Ressource aus der Chat API.

Weitere Informationen zur Funktionsweise von Aktionen finden Sie unter Chat-Aktionen.

Chat-Apps können auch eine Nachricht eines Nutzers aktualisieren, um eine Vorschau eines von ihm gesendeten Links zurückzugeben. Weitere Informationen finden Sie im Hilfeartikel Vorschau von Links in Google Chat-Nachrichten.

Mit der Google Chat API auf Interaktionen antworten oder proaktive Nachrichten senden

Anstatt eine Add‑on-Aktion zurückzugeben, müssen Chat-Apps möglicherweise die Google Chat API verwenden, um auf eine Interaktion zu reagieren. Chat-Apps müssen beispielsweise die Google Chat API aufrufen, um Folgendes zu tun:

  • Nachrichten zu einem bestimmten Zeitpunkt oder zu Änderungen an externen Ressourcen senden Zum Beispiel Benachrichtigungen über ein neues Problem oder einen neuen Fall.
  • Antworten Sie mehr als 30 Sekunden nach der Interaktion. Zum Beispiel, um nach Abschluss einer langwierigen Aufgabe mit einer Nachricht zu antworten.
  • Eine Nachricht außerhalb des Gruppenbereichs senden, in dem die Interaktion stattgefunden hat.
  • Im Namen eines Chat-Nutzers eine Nachricht senden.

Wenn Sie eine Nachricht über die Chat API senden möchten, müssen Sie die Authentifizierung einrichten und die Methode create() für die Ressource Message aufrufen. Eine Anleitung dazu finden Sie unter Nachricht mit der Google Chat API senden.