Questa sezione descrive i problemi comuni che puoi riscontrare durante la creazione e il test delle app di chat.
Il messaggio di una scheda, una finestra di dialogo o l'anteprima del link non vengono visualizzati o non funzionano come previsto
Per ricevere assistenza per la risoluzione degli errori delle schede, consulta la sezione Risolvere i problemi e correggere le schede.
L'app non risponde
Se invii un messaggio all'app Chat e ricevi la risposta "L'app non risponde", verifica la configurazione dell'app di Chat:
Nella console Google Cloud, fai clic su Menu. > Altri prodotti > Google Workspace > Libreria prodotti > API Google Chat > Gestisci > Configurazione.
In Stato app, assicurati di aver selezionato Dal vivo - Disponibile per gli utenti.
Nella sezione Funzionalità interattive, assicurati che le impostazioni siano appropriate per le funzionalità dell'app. Se la tua app di Chat interagisce con gli utenti, assicurati di attivare l'opzione Attiva le funzionalità interattive:
- Se la tua app risponde ai messaggi, assicurati di selezionare Ricevi messaggi 1:1.
- In Impostazioni di connessione, assicurati che l'URL dell'app, l'ID deployment del progetto Apps Script, il Nome argomento di Cloud Pub/Sub o l'agente Dialogflow siano impostati correttamente e che ne sia stato eseguito il deployment.
- In Visibilità, assicurati che gli utenti appropriati abbiano accesso all'app con un indirizzo email o un gruppo nel dominio Google Workspace. Se il deployment dell'app viene eseguito con l'SDK Google Workspace Marketplace, le impostazioni di visibilità non sono necessarie perché le impostazioni di Google Workspace Marketplace hanno la precedenza.
Se l'app viene pubblicata con l'SDK Google Workspace Marketplace, rivedi le impostazioni di Google Workspace Marketplace.
Fai clic su Salva.
Prova a inviare di nuovo i messaggi all'app.
L'API Google Chat è disponibile solo per gli utenti di Google Workspace
Quando configuri l'app Chat, potresti ricevere
errore Google Chat API is only available to Google Workspace users. Questo messaggio
indica che l'Account Google che hai utilizzato per configurare
L'API Chat non fa parte di un'organizzazione Google Workspace. Per creare un
app Chat o l'API Chat, devi utilizzare una
Google Workspace
Google Cloud.
Tieni presente che gli utenti di Google Chat possono utilizzare le app di chat senza un Account Google Workspace. Per scoprire di più su come gli utenti scoprono e installano App di chat, visita la pagina relativa alla pubblicazione App Google Chat.
Gli utenti possono essere esclusi dagli spazi
Se un amministratore di Google Workspace non consente agli utenti di attivare o disattivare la cronologia chat, in alcuni casi gli utenti potrebbero non essere in grado di partecipare o di restare in uno spazio a causa di un conflitto tra un'impostazione a livello di utente che forza l'attivazione o la disattivazione della cronologia chat e uno spazio che eredita l'impostazione forzata a livello di organizzazione.
Ad esempio, se per un utente è stata attivata l'impostazione della cronologia chat, e se per uno spazio è stata attivata l'impostazione della cronologia chat, l'utente potrebbe non riuscire a partecipare allo spazio. Inoltre, l'utente in questione potrebbe essere rimosso dallo spazio se partecipa prima del conflitto e poi pubblica un messaggio nello spazio dopo il conflitto.
In questo scenario e in altri scenari in cui esistono conflitti tra le impostazioni della cronologia, l'API Chat potrebbe non essere in grado di creare un'iscrizione oppure la creazione di un messaggio con autenticazione utente potrebbe rimuovere dallo spazio l'utente autenticato con un'impostazione della cronologia chat in conflitto.
Per saperne di più, consulta Gli utenti possono essere esclusi dagli spazi nel Centro assistenza per amministratori di Google Workspace.
Risolvere i problemi del servizio Advanced Chat in Google Apps Script
Consulta la pagina di Apps Script sulla Servizio Chat avanzato.
Gli utenti non riescono ad aggiungere un'app di Chat a uno spazio
Se gli utenti vedono il messaggio di errore
This organization's administrator must allow users to install this Chat app
quando provi ad aggiungere un'app di Chat a uno spazio, questo errore
potrebbe essere dovuto a uno dei seguenti motivi:
- L'organizzazione ha disattivato le app di chat.
- L'organizzazione non ha aggiunto questo elemento specifico app di Chat alla lista consentita dell'organizzazione.
Se un utente visualizza questo messaggio di errore quando tenta di interagire con un dall'app Chat, potrebbe essere dovuto all'organizzazione concedere l'accesso a un'unità organizzativa secondaria, senza abilitarla per nell'unità organizzativa principale.
Per informazioni su come risolvere questo problema, consulta Consentire agli utenti di installare app di chat.
Risolvi gli errori di funzione Cloud Functions
Se l'app di chat è implementata con Cloud Functions e non funziona, le sezioni seguenti aiutano a risolvere il problema.
Controlla i log delle funzioni Cloud Functions
Come primo passaggio, verifica la presenza di errori nei log di Cloud Functions.
Nella console Google Cloud, vai alla pagina Cloud Functions:
Per aprire i log, trova il cluster Funzione, poi fai clic su Mostra azioni > Visualizza i log.
Esplora log apre ed esegue una query che mostra i log della funzione Cloud Functions, tra cui errori.
Se le informazioni predefinite registrate non sono sufficienti per eseguire il debug della tua app, puoi aggiungere log aggiuntivo dal codice della funzione Cloud Functions. Vedi Visualizzare e scrivere Cloud Log delle funzioni.
Controlla gli errori di funzione Cloud Functions
Oltre ai log, la funzione Cloud Functions potrebbe anche segnalare errori riscontrati durante in esecuzione.
Nella console Google Cloud, vai alla pagina Cloud Functions:
Fai clic sulla funzione Cloud Functions dell'app di chat.
Nella pagina Dettagli funzione, gli errori sono elencati in Errori.
Fai clic sull'errore per risolverlo ulteriormente.
Correggere gli errori comuni della funzione Cloud Functions
Durante la creazione di un oggetto, a volte si verificano i seguenti errori App di chat con Cloud Functions.
La funzione ChatApp esiste già nella regione REGION_NAME nel progetto PROJECT_NAME
Quando esegui il deployment di una funzione Cloud Functions, potresti ricevere l'errore Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists. Questo messaggio indica che un'altra funzione Cloud Functions ha lo stesso nome della funzione
quella di cui stai eseguendo il deployment. Cambia il nome e
eseguire di nuovo il deployment della funzione. Verifica che l'app Chat utilizzi l'URL trigger per
della funzione Cloud Functions, non l'URL trigger della funzione Cloud Functions preesistente.
Uno o più utenti indicati nel criterio non appartengono a un cliente autorizzato
Quando esegui il deployment di una funzione Cloud Functions, potresti ricevere l'errore The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer.". Se visualizzi questo errore e poi invii un messaggio
Chat, viene visualizzato un errore che indica che l'app non risponde perché Google
Chat non riesce a raggiungere il server che ospita la funzione Cloud Functions. Questo messaggio indica che
un utente denominato "allUsers" non dispone dell'autorizzazione per chiamare la funzione Cloud Functions.
Assegnazione di "Tutti gli utenti" l'"Invoker di Cloud Functions" significa che Cloud Functions
La funzione alla base dell'app è disponibile pubblicamente e accessibile senza
autenticazione. Per informazioni su come assegnare un ruolo, consulta
Assegna un singolo ruolo.
Questo errore potrebbe significare che il progetto Google Cloud è limitato al dominio. Per per ulteriori informazioni sui vincoli delle restrizioni di dominio, consulta Limitazione delle identità in base al dominio.
Per risolvere il problema, verifica che la funzione Cloud Functions consenta i nomi non autenticati per le chiamate. Per scoprire come consentire chiamate non autenticate per una chiamata esistente funzione Cloud Functions, consulta Consentire l'accesso pubblico (non autenticato).