Chat-App mit anderen Diensten und Tools verbinden

Auf dieser Seite wird beschrieben, wie Sie eine Google Chat-App mit einem Dienst verbinden. oder ein Tool außerhalb von Google Chat. Während Chat-Apps sie arbeiten oft mit anderen Systemen zusammen und benötigen Companion-Anwendungen zum Verbinden von Konten, Autorisieren des Datenzugriffs, Anzeigen oder Nutzereinstellungen konfigurieren.

Konfiguration der Chat-App von einem Nutzer anfordern

Wenn für das Ausführen einer Anfrage eine zusätzliche Konfiguration erforderlich ist, die nicht Chat-App ausgeführt haben, geben Sie eine Konfigurations-URL als Teil einer normalen Antwort an den Nutzer senden oder sie privat präsentieren, im folgenden Format:

{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "CONFIGURATION_URL"
  }
}

Dadurch wird dem Nutzer in Google Chat eine private Aufforderung angezeigt, in der CONFIGURATION_URL ist ein Link auf die der Nutzer zur zusätzlichen Authentifizierung, Autorisierung oder Konfiguration. Eine REQUEST_CONFIG-Antwort schließt sich mit einem regulären Antwortnachricht. Text, Karten und andere Attribute werden ignoriert.

Konfigurationsanfrage abschließen

Jeden MESSAGE Interaktionsereignis die Ihre Chat-App empfängt, enthält auch ein configCompleteRedirectUrl-Parameter. Diese URL sollte im Konfigurations-URL, die nach Abschluss des Vorgangs verwendet werden soll. Du wirst weitergeleitet URL signalisiert Google Chat, dass die Konfigurationsanfrage erfüllt wurde.

Wenn die Chat-App gestartet wird, hängt der Ablauf davon ab, bestimmte Nachricht empfangen. Als Antwort auf eine Nachricht wie @app help wurde ein Die Chat-App sollte mit einer Nachricht antworten, und erfordert eine zusätzliche Konfiguration.

Wenn ein Nutzer erfolgreich zu configCompleteRedirectUrl weitergeleitet wird in der ursprünglichen Nachricht enthalten, führt Google Chat die folgenden Schritte aus:

  1. Löschen Sie die Aufforderung, die dem initiierenden Nutzer angezeigt wurde.
  2. Die ursprüngliche Nachricht öffentlich machen, damit sie für andere Mitglieder von sichtbar ist den Gruppenbereich.
  3. Originalnachricht an dieselbe Chat-App senden ein zweites Mal.

Das Aufrufen einer configCompleteRedirectUrl wirkt sich nur auf eine einzelne Nutzernachricht aus. Wenn ein Nutzer mehrmals versucht hat, einer Chat-App eine Nachricht zu senden und so mehrere Prompts erhielten, Die Eingabeaufforderung und das Abschließen der Authentifizierung und Konfiguration wirkt sich nur auf Nachricht senden. Andere Nachrichten werden nicht geändert.

Wenn ein MESSAGE-Interaktionsereignis auf diese Weise noch einmal gesendet wird, muss es identisch sein. mit dem ursprünglichen Ereignis verknüpft. Es gibt jedoch Situationen, in denen MESSAGE Interaktionsereignisse variieren. Wenn in einer Nachricht beispielsweise sowohl Chat-App A und Chat-App B, Der Nutzer kann die Nachricht bearbeiten, wenn die Chat-App A mit einer regulären Nachricht antwortet, bevor sie sich mit Chat-App B. In diesem Fall Chat-App B empfängt den bearbeiteten Nachrichtentext nach dem Der Nutzer führt die Authentifizierung und Konfiguration durch.

Chat-Nutzer außerhalb von Google Chat authentifizieren

In einigen Fällen, etwa beim Anfordern der OAuth-Autorisierung für eine API, muss Ihre Anwendung um auf eine URL außerhalb von Chat zu verlinken, während der Nutzer Identität. Der beste Weg, Nutzer zu identifizieren, besteht darin, Ziel-App mit Google Log-in.

Verwenden Sie die Methode Identitätstoken die bei der Anmeldung ausgestellt wurden, um die Nutzer-ID zu erhalten. Die sub-Anforderung enthält die eindeutige ID und kann mit der User-ID aus Google Chat in Beziehung gesetzt werden.

Obwohl die beiden IDs nicht genau identisch sind, können sie erzwungen werden. Bis Erzwingen Sie den Wert der sub-Anforderung in eine Google Chat-users/{user}. den Wert mit users/. Der Anforderungswert von 123 ist beispielsweise äquivalent. an den Nutzernamen users/123 in Nachrichten an Ihre Chat-App.