In diesem Abschnitt werden häufige Probleme beschrieben, die beim Erstellen und Testen von Chat-Apps auftreten können.
Eine Kartennachricht, ein Dialogfeld oder eine Linkvorschau wird nicht wie erwartet gerendert oder funktioniert nicht wie erwartet.
Hilfe zur Behebung von Kartenfehlern findest du unter Kartenfehler beheben.
App reagiert nicht
Wenn Sie die Nachricht an die Chat-App senden und diese mit „App antwortet nicht“ antwortet, prüfen Sie die Konfiguration der Chat-App:
Klicken Sie in der Google Cloud Console auf Menü > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API > Verwalten > Konfiguration.
Wählen Sie unter App-Status die Option Live – für Nutzer verfügbar aus.
Prüfen Sie unter Interaktive Funktionen, ob die Einstellungen für die Funktionen Ihrer App geeignet sind. Wenn die Chat-App mit Nutzern interagiert, muss die Option Interaktive Funktionen aktivieren aktiviert sein:
- 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 und bereitgestellt wurde.
- Prüfen Sie unter Sichtbarkeit, ob die entsprechenden Nutzer mit einer E-Mail-Adresse oder einer Gruppe in der Google Workspace-Domain Zugriff auf die App haben. Wenn die Anwendung 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
Beim Konfigurieren der Chat-Anwendung wird möglicherweise der Fehler Google Chat API is only available to Google Workspace users angezeigt. Diese Nachricht bedeutet, dass das Google-Konto, mit dem Sie die Chat API konfiguriert haben, nicht zu einer Google Workspace-Organisation gehört. Wenn Sie eine Chat-App erstellen oder die Chat API verwenden möchten, benötigen Sie ein Google Workspace-Konto.
Beachten Sie, dass Google Chat-Nutzer Chat-Apps ohne Google Workspace-Konto verwenden können. Weitere Informationen dazu, wie Nutzer Chat-Apps erkennen und installieren, finden Sie unter Google Chat-Apps veröffentlichen.
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 nicht beitreten oder dort bleiben können. Grund dafür ist der Konflikt zwischen einer Einstellung auf Nutzerebene, die die Aktivierung oder Deaktivierung des Chatprotokolls erzwingt, und einem Gruppenbereich, für den die auf Organisationsebene erzwungene Einstellung übernommen wird.
Wenn für einen Nutzer beispielsweise die Einstellung für das Chatprotokoll aktiviert und für einen Gruppenbereich die Einstellung deaktiviert ist, kann dieser Nutzer dem Gruppenbereich möglicherweise nicht beitreten. Außerdem wird dieser Nutzer möglicherweise aus dem Gruppenbereich entfernt, wenn er vor dem Konflikt beigetreten ist und nach dem Konflikt eine Nachricht in dem Gruppenbereich postet.
In diesem Szenario und in anderen Szenarien, in denen es Konflikte zwischen den Einstellungen für das Chatprotokoll gibt, kann die Chat API möglicherweise keine Mitgliedschaft erstellen. Wenn eine Nachricht mit Nutzerauthentifizierung erstellt wird, wird der authentifizierte Nutzer mit einer in Konflikt stehenden Chatprotokolleinstellung möglicherweise aus dem Gruppenbereich entfernt.
Weitere Informationen finden Sie in der Google Workspace-Admin-Hilfe unter Nutzer können aus Gruppenbereichen ausgeschlossen werden.
Fehlerbehebung beim erweiterten Chat-Dienst in Google Apps Script
Weitere Informationen finden Sie auf der Apps Script-Seite zum erweiterten Chatdienst.
Nutzer können einem Gruppenbereich keine Chat-App hinzufügen
Wenn Nutzer beim Versuch, einem Gruppenbereich eine Chat-App hinzuzufügen, die Fehlermeldung This organization's administrator must allow users to install this Chat app erhalten, kann dieser Fehler einen der folgenden Gründe haben:
- Die Organisation hat Chat-Apps deaktiviert.
- Die Organisation hat diese Chat-App nicht auf die Zulassungsliste der Organisation gesetzt.
Wenn ein Nutzer diese Fehlermeldung bei der Interaktion mit einer Chat-App sieht, kann dies daran liegen, dass die Organisation Zugriff auf eine untergeordnete Organisationseinheit gewährt, ohne sie für die übergeordnete Organisationseinheit zu aktivieren.
Informationen zum Beheben dieses Problems finden Sie unter Nutzern erlauben, Chat-Apps zu installieren.
Fehler in Cloud Functions beheben
Wenn die Chat-App mit Cloud Functions implementiert ist und nicht funktioniert, finden Sie in den folgenden Abschnitten Informationen zur Fehlerbehebung.
Cloud Functions-Logs prüfen
Prüfen Sie zuerst die Cloud Functions-Logs auf Fehler.
Rufen Sie in der Google Cloud Console die Seite „Cloud Functions“ auf:
Zum Öffnen der Logs suchen Sie die Cloud Functions-Funktion Ihrer Chat-App und klicken dann auf Aktionen anzeigen > Logs ansehen.
Der Log-Explorer wird geöffnet und führt eine Abfrage aus, die Logs von Cloud Functions-Funktionen enthält, einschließlich Fehlern.
Wenn die protokollierten Standardinformationen nicht ausreichen, um die Anwendung zu debuggen, können Sie über den Code der Cloud Functions-Funktion zusätzliches Logging hinzufügen. Weitere Informationen finden Sie unter Cloud Functions-Logs ansehen und schreiben.
Cloud Functions-Fehler prüfen
Neben den Logs meldet Cloud Functions-Funktion möglicherweise auch Fehler, die während der Ausführung aufgetreten sind.
Rufen Sie in der Google Cloud Console die Seite „Cloud Functions“ auf:
Klicken Sie auf die Cloud Functions-Funktion Ihrer Chat-App.
Auf der Seite mit den Funktionsdetails werden die Fehler unter Fehler aufgeführt.
Klicken Sie auf den Fehler, um weitere Informationen zur Fehlerbehebung zu erhalten.
Häufige Fehler bei Cloud Functions beheben
Die folgenden Fehler können manchmal beim Erstellen einer Chat-App mit Cloud Functions auftreten.
Die ChatApp-Funktion in der 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 Meldung bedeutet, dass eine andere Cloud Functions-Funktion denselben Namen wie die von Ihnen bereitgestellte Funktion hat. Ändern Sie den Namen und stellen Sie die Funktion noch einmal bereit. Prüfen Sie, ob die Chat-App die Trigger-URL für Ihre Cloud Functions-Funktion verwendet und nicht die Trigger-URL der vorhandenen Cloud Functions-Funktion.
Mindestens ein in der Richtlinie genannter Nutzer gehört nicht zu einem zugelassenen 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 eine Nachricht an die Chat-App senden, erhalten Sie eine Fehlermeldung, die besagt, dass die Anwendung nicht reagiert, weil Google Chat den Server, auf dem die Cloud Functions-Funktion gehostet wird, nicht erreichen kann. Diese Meldung bedeutet, dass ein Nutzer mit dem Namen „allUsers“ nicht berechtigt ist, die Cloud Functions-Funktion aufzurufen.
Wenn Sie „allUsers“ die Rolle „Cloud Functions Invoker“ erhalten, ist die Cloud Functions-Funktion, die der Anwendung zugrunde liegt, öffentlich verfügbar und ohne Authentifizierung zugänglich. Informationen zum Zuweisen einer Rolle finden Sie unter Einzelne Rolle zuweisen.
Dieser Fehler kann bedeuten, dass das Google Cloud-Projekt auf eine Domain beschränkt ist. Weitere Informationen zu Domaineinschränkungen finden Sie unter Identitäten nach Domain einschränken.
Prüfen Sie, ob Ihre Cloud Functions-Funktion nicht authentifizierte Aufrufe zulässt, um dieses Problem zu beheben. Informationen dazu, wie Sie nicht authentifizierte Aufrufe für eine vorhandene Cloud Functions-Funktion zulassen, finden Sie unter Öffentlichen (nicht authentifizierten) Zugriff zulassen.