Questa sezione descrive i problemi comuni che potresti riscontrare durante la creazione e il test delle app di Chat.
Un messaggio con scheda, una finestra di dialogo o un'anteprima del link non viene visualizzato o non funziona come previsto
Per assistenza nella risoluzione dei problemi relativi alle schede, consulta Risolvere i problemi e correggere le schede.
L'app non risponde
Se invii un messaggio all'app di Chat e ricevi la risposta "L'app non risponde", verifica la configurazione dell'app di Chat:
Nella console API di Google, fai clic su Menu > API e servizi > API e servizi abilitati > API Google Chat > Configurazione.
In Stato dell'app, assicurati di aver selezionato Live - disponibile per gli utenti.
In Funzionalità interattive, assicurati che le impostazioni siano appropriate per la funzionalità dell'app. Se l'app di Chat interagisce con gli utenti, assicurati di attivare Abilita funzionalità interattive:
- Per impostazione predefinita, le app possono rispondere ai messaggi diretti degli utenti.
- Se l'app risponde ai messaggi negli spazi e nelle chat di gruppo, seleziona Unisciti a spazi e conversazioni di gruppo.
- In Impostazioni di connessione, assicurati che l'URL dell'endpoint HTTP, l'ID deployment del progetto Apps Script, il nome del topic 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 l'app viene sottoposta a deployment con l'SDK di 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 di Google Workspace Marketplace, esamina le impostazioni di Google Workspace Marketplace.
Fai clic su Salva.
Prova a inviare di nuovo un messaggio all'app.
L'API Google Chat è disponibile solo per gli utenti di Google Workspace
Quando configuri l'app di Chat, potresti ricevere l'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 di 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 scoprono e installano le app di Chat, consulta Creare app Google Chat interattive.
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 di restare in uno spazio a causa di un conflitto tra un'impostazione a livello 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 un utente ha un'impostazione della cronologia chat forzata su "on" e uno spazio ha un'impostazione della cronologia chat forzata su "off", l'utente potrebbe non essere in grado di entrare nello spazio. Inoltre, l'utente potrebbe essere rimosso dallo spazio se si è unito prima del conflitto e poi pubblica un messaggio nello spazio dopo il conflitto.
In questo scenario e in altri scenari in cui si verificano conflitti tra le impostazioni della cronologia, l'API Chat potrebbe non essere in grado di creare un'appartenenza oppure la creazione di un messaggio con l'autenticazione utente potrebbe rimuovere l'utente autenticato con un'impostazione della cronologia chat in conflitto 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 relativa al 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, questo errore
potrebbe essere dovuto a uno dei seguenti motivi:
- L'organizzazione ha disattivato le app di Chat.
- L'organizzazione non ha aggiunto questa specifica app di Chat all'elenco di elementi consentiti dell'organizzazione.
Se un utente visualizza questo messaggio di errore quando tenta di interagire con un'app di Chat, potrebbe essere dovuto al fatto che l'organizzazione ha concesso l'accesso a un'unità organizzativa secondaria, senza abilitarlo per l'unità organizzativa principale.
Per informazioni su come risolvere questo problema, consulta Consentire agli utenti di installare app di chat.
L'amministratore deve concedere all'app l'ambito di autorizzazione OAuth richiesto per questa azione
Quando esegui l'autenticazione come app di Chat, potresti ricevere il seguente errore:
<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">
Questo messaggio di errore indica che un amministratore di Google Workspace non ha ancora concesso l'approvazione una tantum all'app di Chat per utilizzare gli ambiti di autorizzazione che iniziano con il nome https://www.googleapis.com/auth/chat.app.*.
Per risolvere l'errore:
- Chiedi all'amministratore di Google Workspace di
concedere l'approvazione alla tua app di Chat.
Quando gestisci questo errore nella logica dell'app di Chat,
valuta la possibilità di inviare un messaggio che annuncia che
l'app di Chat richiede l'approvazione dell'amministratore per eseguire
l'azione richiesta, ad esempio:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - Se il metodo dell'API Chat supporta l'ambito di autorizzazione
https://www.googleapis.com/auth/chat.bot, che non richiede l'approvazione dell'amministratore, valuta la possibilità di utilizzarlo. Per verificare quali ambiti di autorizzazione supporta un metodo, consulta Autenticare e autorizzare le app Google Chat e le richieste API Google Chat.
Risolvere i problemi relativi agli errori di Cloud Functions
Se l'app di Chat è implementata con Cloud Functions e non funziona, le seguenti sezioni ti aiutano a risolvere il problema.
Controllare i log di Cloud Functions
Come primo passo, controlla i log di Cloud Functions per verificare la presenza di errori.
Nella console API di Google, vai alla pagina Cloud Functions:
Per aprire i log, trova la funzione Cloud Functions dell'app di Chat, quindi fai clic su Mostra azioni > Visualizza log.
Si apre Esplora log ed esegue una query che mostra i log di Cloud Functions, inclusi gli errori.
Se le informazioni predefinite registrate non sono sufficienti per eseguire il debug dell'app, puoi aggiungere log aggiuntivi dal codice di Cloud Functions. Consulta Visualizzare e scrivere log di Cloud Functions.
Controllare gli errori di Cloud Functions
Oltre ai log, Cloud Functions potrebbe anche segnalare gli errori riscontrati durante l'esecuzione.
Nella console API di Google, vai alla pagina Cloud Functions:
Fai clic sulla funzione Cloud Functions dell'app di Chat.
Nella pagina dei dettagli della funzione, gli errori sono elencati in Errori.
Per risolvere ulteriormente un errore, fai clic su di esso.
Correggere gli errori comuni di Cloud Functions
A volte si verificano i seguenti errori durante la creazione di un'app di Chat con Cloud Functions.
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. Modifica il nome ed esegui di nuovo il deployment della funzione. Verifica che l'app di Chat utilizzi l'URL trigger per 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 ricevi questo errore e poi invii un messaggio all'
app di Chat, ricevi un errore che indica che l'app non risponde perché Google
Chat non riesce a raggiungere il server che ospita Cloud Functions. Questo messaggio indica che un utente denominato "allUsers" non ha l'autorizzazione per chiamare Cloud Functions.
Se assegni il ruolo "Invoker di Cloud Functions" a "allUsers", la funzione Cloud Functions che alimenta l'app è disponibile pubblicamente e accessibile senza autenticazione. Per scoprire come assegnare un ruolo, consulta
Concedi un singolo ruolo.
Questo errore potrebbe indicare che il progetto Google Cloud è limitato al dominio. Per saperne di più sui vincoli di limitazione del dominio, consulta Limitazione delle identità per dominio.
Per risolvere il problema, verifica che Cloud Functions consenta le chiamate non autenticate. Per scoprire come consentire le chiamate non autenticate per una funzione Cloud Functions esistente, consulta Consentire l'accesso pubblico (non autenticato).