In diesem Abschnitt werden häufige Probleme beschrieben, die beim Erstellen und Testen von Chat-Apps auftreten können.
Eine Kartenmeldung, ein Dialogfeld oder eine Linkvorschau wird nicht gerendert oder funktioniert nicht wie erwartet
Informationen zur Behebung von Kartenfehlern finden Sie unter Kartenfehler beheben.
App reagiert nicht
Wenn Sie eine Nachricht an die Chat-App senden und diese die Antwort „App reagiert nicht“ zurückgibt, Prüfen Sie die Konfiguration der Chat-App:
Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü. > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API > Verwalten > Konfiguration.
Achte darauf, dass unter App-Status die Option Live – für Nutzer verfügbar ausgewählt ist.
Prüfen Sie unter Interaktive Funktionen, ob die Einstellungen für die Funktionalität Ihrer App geeignet sind. Wenn Ihre Chat-App mit Nutzern interagiert, achten Sie darauf, dass die Option Interaktive Funktionen aktivieren aktiviert ist:
- Wenn Ihre App auf Nachrichten antwortet, wählen Sie 1:1-Nachrichten empfangen aus.
- Prüfen Sie unter Verbindungseinstellungen, ob die App-URL, die Bereitstellungs-ID des Apps Script-Projekts, der Name des Cloud Pub/Sub-Themas oder der Dialogflow-Agent richtig festgelegt ist und bereitgestellt wurde.
- Prüfen Sie unter Sichtbarkeit, ob die entsprechenden Nutzer über eine E-Mail-Adresse oder eine Gruppe in der Google Workspace-Domain Zugriff auf die App haben. Wenn die App mit dem Google Workspace Marketplace SDK bereitgestellt wird, sind keine Sichtbarkeitseinstellungen erforderlich, da die Google Workspace Marketplace-Einstellungen Vorrang haben.
Wenn die App mit dem Google Workspace Marketplace SDK veröffentlicht wurde, prüfen Sie die Google Workspace Marketplace-Einstellungen.
Klicken Sie auf Speichern.
Versuche noch einmal, der App eine Nachricht zu senden.
Die Google Chat API ist nur für Google Workspace-Nutzer verfügbar
Bei der Konfiguration der Chat-App erhalten Sie möglicherweise die Fehlermeldung
Fehler Google Chat API is only available to Google Workspace users
. Diese Nachricht
bedeutet, dass das Google-Konto, das Sie für die Konfiguration
Die Chat API gehört nicht zu einer Google Workspace-Organisation. Um eine
Chat-App oder die Chat API nutzen, müssen Sie eine
Google Workspace
Konto.
Beachten Sie, dass Google Chat-Nutzer Chat-Apps ohne Google Workspace-Konto. Weitere Informationen dazu, wie Nutzer die App entdecken und installieren Chat-Apps, siehe Veröffentlichen Google Chat-Apps
Nutzer können aus Gruppenbereichen ausgeschlossen werden
Wenn ein Google Workspace-Administrator Nutzern nicht erlaubt, das Chatprotokoll zu aktivieren oder zu deaktivieren, kann es vorkommen, dass Nutzer einem Gruppenbereich aufgrund eines Konflikts zwischen einer Einstellung auf Nutzerebene, die das Aktivieren oder Deaktivieren des Chatprotokolls erzwingt, und einem Gruppenbereich, der die erzwungene Einstellung auf Organisationsebene übernimmt, nicht beitreten oder nicht darin bleiben können.
Beispiel: Ein Nutzer hat die Einstellung „Ein“ für das Chatprotokoll aktiviert. und in einem Gruppenbereich das Chatprotokoll auf „Aus“ festgelegt ist, kann dieser Nutzer dem Gruppenbereich möglicherweise nicht beitreten. Außerdem kann dieser Nutzer aus dem Gruppenbereich entfernt werden, wenn er vor dem Konflikt beigetreten ist und nach dem Konflikt eine Nachricht im Gruppenbereich postet.
In diesem und anderen Fällen, in denen Konflikte zwischen den Einstellungen für das Chatprotokoll auftreten, kann die Chat API möglicherweise keine Mitgliedschaft erstellen. Oder Sie erstellen eine Nachricht mit Nutzerauthentifizierung, um den authentifizierten Nutzer mit einer in Konflikt stehenden Einstellung für das Chatprotokoll aus dem Gruppenbereich zu entfernen.
Weitere Informationen finden Sie in der Google Workspace-Admin-Hilfe unter Nutzer können aus Gruppenbereichen ausgeschlossen werden.
Fehlerbehebung für den erweiterten Chat in Google Apps Script
Auf der Apps Script-Seite finden Sie Erweiterter Chat-Dienst:
Nutzer können einem Gruppenbereich keine Chat-App hinzufügen
Wenn Nutzer die Fehlermeldung erhalten
This organization's administrator must allow users to install this Chat app
wenn Sie versuchen, einem Gruppenbereich eine Chat-App hinzuzufügen, wird diese Fehlermeldung
kann eine der folgenden Ursachen haben:
- Die Organisation hat Chat-Apps deaktiviert.
- Die Organisation hat diese spezifische Chat-App auf die Zulassungsliste der Organisation setzen.
Wenn Nutzende diese Fehlermeldung erhalten, wenn sie versuchen, mit einem Chat-App, kann dies durch die Organisation verursacht werden. Es wird Zugriff auf eine untergeordnete Organisationseinheit gewährt, ohne den Zugriff für die übergeordneten Organisationseinheit.
Informationen zur Behebung dieses Problems finden Sie unter Nutzern erlauben, Chat-Apps zu installieren
Fehler in Cloud Functions beheben
Wenn die Chat-App mit Cloud Functions und nicht funktioniert, helfen Ihnen die folgenden Abschnitte bei der Fehlerbehebung.
Cloud Functions-Logs prüfen
Prüfen Sie zuerst die Cloud Functions-Logs auf Fehler.
Wechseln Sie in der Google Cloud Console zur Seite Cloud Functions:
Suchen Sie zum Öffnen der Logs die Cloud Ihrer Chat-App Funktion und klicken Sie dann auf Aktionen anzeigen > Logs ansehen.
Der Log-Explorer wird geöffnet und führt eine Abfrage mit Cloud Functions-Logs aus, darunter: Fehler.
Wenn die protokollierten Standardinformationen für die Fehlerbehebung in Ihrer App nicht ausreichen, können Sie zusätzlichem Logging aus Ihrem Cloud Functions-Code. Weitere Informationen finden Sie unter Cloud aufrufen und schreiben Funktionslogs
Cloud Functions-Fehler prüfen
Neben den Logs meldet Cloud Functions auch Fehler, die beim ausgeführt wird.
Wechseln Sie in der Google Cloud Console zur Seite Cloud Functions:
Klicken Sie auf die Cloud Functions-Funktion Ihrer Chat-App.
Auf der Seite „Funktionsdetails“ werden Fehler unter Fehler aufgeführt.
Klicken Sie auf einen Fehler, um ihn weiter zu beheben.
Häufige Cloud Functions-Fehler beheben
Die folgenden Fehler treten manchmal beim Erstellen einer Chat-App mit Cloud Functions
Funktion ChatApp in Region REGION_NAME
im Projekt PROJECT_NAME
ist bereits vorhanden
Beim Bereitstellen einer Cloud Functions-Funktion wird möglicherweise der Fehler Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists
angezeigt. Diese Nachricht bedeutet, dass eine andere Cloud Functions-Funktion denselben Namen wie die
die Sie bereitstellen. Ändern Sie den Namen und
und stellen Sie die Funktion noch einmal bereit. Prüfen, ob die Chat-App die Trigger-URL für
Ihre Cloud Functions-Funktion und nicht die Trigger-URL der vorhandenen Cloud Functions-Funktion.
Mindestens ein in der Richtlinie genannter Nutzer gehört nicht zu einem zulässigen Kunden
Wenn Sie eine Cloud Functions-Funktion bereitstellen, wird möglicherweise der Fehler The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer."
angezeigt. Wenn Sie diesen Fehler erhalten und dann die
Chat-App erhalten Sie eine Fehlermeldung, die besagt, dass die App nicht reagiert, weil Google
Chat kann den Server nicht erreichen, auf dem die Cloud Functions-Funktion gehostet wird. Diese Meldung bedeutet, dass
einen Nutzer namens „allUsers“ keine Berechtigung zum Aufrufen der Cloud Functions-Funktion.
Für „allUsers“ angeben den „Cloud Functions-Aufrufer“ Rolle bedeutet, dass die Cloud
Die Funktion, die die App steuert, ist öffentlich verfügbar und zugänglich ohne
Authentifizierung. Informationen zum Zuweisen einer Rolle findest du unter
Eine einzelne Rolle zuweisen
Dieser Fehler kann bedeuten, dass das Google Cloud-Projekt auf eine Domain beschränkt ist. Für Weitere Informationen zu Domaineinschränkungen finden Sie unter Identitäten nach Domain einschränken
Prüfen Sie, ob Ihre Cloud Functions-Funktion nicht authentifizierte Berechtigungen zulässt, um dieses Problem zu beheben Aufrufe. Weitere Informationen zum Zulassen nicht authentifizierter Aufrufe für eine vorhandene Cloud Functions-Funktion, siehe Öffentlichen (nicht authentifizierten) Zugriff zulassen