In questa sezione vengono descritti i problemi comuni che puoi riscontrare durante la creazione e il test delle app di chat.
Un messaggio della scheda, una finestra di dialogo o l'anteprima di un link non viene visualizzato o funziona come previsto
Per assistenza sulla risoluzione degli errori delle schede, consulta l'articolo Risolvere i problemi e correggere le schede.
L'app non risponde
Se invii un messaggio all'app di Chat e risponde "L'app non risponde", verifica la configurazione dell'app:
Nella console Google Cloud, fai clic su Menu > Altri prodotti > Google Workspace > Libreria prodotti > API Google Chat > Gestisci > Configurazione.
In Stato dell'app, assicurati di aver selezionato Dal vivo - disponibile per gli utenti.
Nella sezione Funzionalità interattive, assicurati che le impostazioni siano appropriate per la funzionalità dell'app. Se la tua app di Chat interagisce con gli utenti, assicurati di attivare l'opzione Abilita le funzionalità interattive:
- Se la tua app risponde ai messaggi, assicurati di selezionare Ricevi messaggi 1:1.
- In Impostazioni connessione, assicurati che l'URL app, l'ID deployment del progetto Apps Script, il Nome argomento di Cloud Pub/Sub o l'agente Dialogflow siano impostati correttamente e che 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 è stato eseguito con l'SDK Google Workspace Marketplace, le impostazioni di visibilità non sono necessarie perché quelle di Google Workspace Marketplace hanno la precedenza.
Se l'app è stata pubblicata con l'SDK di Google Workspace Marketplace, controlla 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
Durante la configurazione dell'app Chat, potresti ricevere l'errore Google Chat API is only available to Google Workspace users. Questo messaggio
significa 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 utilizzare l'API Chat, devi utilizzare un account Google Workspace.
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 trovano e installano le app di Chat, consulta Pubblicare app di 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 entrare o 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 è attivata forzatamente l'impostazione della cronologia chat e l'impostazione della cronologia chat è disabilitata forzatamente per uno spazio, l'utente in questione potrebbe non essere in grado di partecipare allo spazio. Inoltre, questo utente potrebbe essere rimosso dallo spazio se si è unito prima del conflitto, per poi pubblicare un messaggio nello spazio dopo il conflitto.
In questo e in altri scenari in cui si verificano conflitti tra le impostazioni della cronologia, l'API Chat potrebbe non essere in grado di creare una sottoscrizione oppure, se si crea un messaggio con autenticazione utente, l'utente autenticato con un'impostazione della cronologia chat in conflitto potrebbe essere rimosso dallo spazio.
Per saperne di più, consulta Gli utenti possono essere esclusi dagli spazi nel Centro assistenza per amministratori di Google Workspace.
Risolvere i problemi relativi al servizio chat avanzato in Google Apps Script
Consulta la pagina di Apps Script sul servizio chat avanzato.
Gli utenti non riescono ad aggiungere un'app di chat a uno spazio
Se gli utenti visualizzano il messaggio di errore This organization's administrator must allow users to install this Chat app quando tentano di aggiungere un'app di Chat a uno spazio, l'errore potrebbe essere causato da uno dei seguenti motivi:
- L'organizzazione ha disattivato le app di Chat.
- L'organizzazione non ha aggiunto questa specifica app Chat alla lista consentita dell'organizzazione.
Se un utente visualizza questo messaggio di errore quando tenta di interagire con un'app di Chat, potrebbe essere causato dall'autorizzazione dell'organizzazione a concedere l'accesso a un'unità organizzativa secondaria, senza abilitarlo per l'unità organizzativa principale.
Per informazioni su come risolvere questo problema, vedi Consentire agli utenti di installare app di chat.
Risolvere gli errori delle funzioni 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
Per prima cosa, verifica la presenza di errori nei log di Cloud Functions.
Nella console Google Cloud, vai alla pagina Cloud Functions:
Per aprire i log, individua la funzione Cloud Functions dell'app di Chat, quindi fai clic su Mostra azioni > Visualizza log.
Esplora log apre ed esegue una query che mostra i log delle funzioni Cloud Functions, inclusi gli errori.
Se le informazioni predefinite registrate non sono sufficienti per eseguire il debug dell'app, puoi aggiungere un ulteriore logging dal codice della funzione Cloud Functions. Consulta Visualizzazione e scrittura dei log di Cloud Functions.
Controlla gli errori della funzione Cloud Functions
Oltre ai log, la funzione Cloud Functions potrebbe segnalare anche gli errori riscontrati durante l'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 su un errore per risolverlo.
Correggere gli errori comuni delle funzioni Cloud Functions
Durante la creazione di un'app di Chat con Cloud Functions, a volte si verificano i seguenti errori.
La funzione ChatApp nella regione REGION_NAME nel progetto PROJECT_NAME esiste già
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 di quella di cui stai eseguendo il deployment. Cambiate il nome ed
eseguite nuovamente il deployment della funzione. Verifica che l'app di Chat utilizzi l'URL di trigger per la funzione Cloud Functions, non l'URL di trigger della funzione Cloud Functions preesistente.
Uno o più utenti indicati nelle norme non appartengono a un cliente consentito
Quando esegui il deployment di una funzione Cloud Functions, potresti visualizzare 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 viene visualizzato questo errore e poi invii un messaggio all'app Chat, viene visualizzato un errore che indica che l'app non risponde perché Google Chat non è in grado di 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.
Se assegni a "allUsers" il ruolo "Invoker di Cloud Functions", la funzione Cloud Functions alla base dell'app è disponibile pubblicamente e accessibile senza autenticazione. Per scoprire come assegnare un ruolo, vedi
Concedere un singolo ruolo.
Questo errore potrebbe significare che il progetto Google Cloud è limitato al dominio. Per saperne di più sui vincoli relativi alle limitazioni dei domini, consulta Limitazione delle identità per dominio.
Per risolvere questo problema, verifica che la funzione Cloud Functions consenta le chiamate non autenticate. Per scoprire come consentire chiamate non autenticate per una funzione Cloud Functions esistente, consulta Consentire l'accesso pubblico (non autenticato).