Cette section décrit les problèmes courants que vous pouvez rencontrer lors de la création et du test d'applications Chat.
Un message de carte, une boîte de dialogue ou un aperçu de lien ne s'affichent pas ou ne fonctionnent pas comme prévu
Pour obtenir de l'aide sur la résolution des erreurs de carte, consultez Résoudre les problèmes et corriger les cartes.
L'application ne répond pas
Si vous envoyez un message à l'application Chat et qu'elle répond "L'application ne répond pas", vérifiez sa configuration :
Dans la console Google API, cliquez sur Menu > API et services > API et services activés > API Google Chat > Configuration.
Sous État de l'application, assurez-vous d'avoir sélectionné En cours – Disponible pour les utilisateurs.
Sous Fonctionnalités interactives, assurez-vous que les paramètres sont adaptés aux fonctionnalités de votre application. Si votre application Chat interagit avec les utilisateurs, assurez-vous d'activer Activer les fonctionnalités interactives :
- Par défaut, les applications peuvent répondre aux messages privés des utilisateurs.
- Si votre application répond aux messages dans les espaces et les discussions de groupe, sélectionnez Rejoindre des espaces et des conversations de groupe.
- Sous Paramètres de connexion, assurez-vous que l'URL du point de terminaison HTTP, l'ID de déploiement du projet Apps Script, le nom du sujet Cloud Pub/Sub ou l'agent Dialogflow sont correctement définis et déployés.
- Sous Visibilité, assurez-vous que les utilisateurs appropriés ont accès à l'application avec une adresse e-mail ou un groupe dans le domaine Google Workspace. Si l'application est déployée avec Google Workspace Marketplace SDK, les paramètres de visibilité ne sont pas nécessaires, car les paramètres Google Workspace Marketplace sont prioritaires.
Si l'application est publiée avec le SDK Google Workspace Marketplace, consultez les paramètres Google Workspace Marketplace.
Cliquez sur Enregistrer.
Essayez d'envoyer un message à l'application.
L'API Google Chat n'est disponible que pour les utilisateurs de Google Workspace
Lorsque vous configurez l'application Chat, vous pouvez recevoir l'erreur Google Chat API is only available to Google Workspace users. Ce message signifie que le compte Google que vous avez utilisé pour configurer l'API Chat ne fait pas partie d'une organisation Google Workspace. Pour créer une
application Chat ou utiliser l'API Chat, vous devez utiliser un
compte Google Workspace.
Notez que les utilisateurs de Google Chat peuvent utiliser des applications Chat sans compte Google Workspace. Pour savoir comment les utilisateurs découvrent et installent des applications Chat, consultez Créer des applications Google Chat interactives.
Les utilisateurs peuvent être exclus des espaces
Si un administrateur Google Workspace interdit aux utilisateurs d'activer ou de désactiver l'historique des discussions, il peut arriver que les utilisateurs ne puissent pas rejoindre un espace ou y rester en raison d'un conflit entre un paramètre au niveau de l'utilisateur qui force l'activation ou la désactivation de l'historique des discussions et un espace qui hérite du paramètre forcé au niveau de l'organisation.
Par exemple, si un utilisateur a un paramètre d'historique des discussions forcé sur "Activé" et qu'un espace a un paramètre d'historique des discussions forcé sur "Désactivé", il est possible que cet utilisateur ne puisse pas rejoindre l'espace. De plus, cet utilisateur peut être supprimé de l'espace s'il l'a rejoint avant le conflit, puis s'il publie un message dans l'espace après le conflit.
Dans ce scénario et dans d'autres scénarios où il existe des conflits entre les paramètres d'historique des discussions, l'API Chat peut ne pas être en mesure de créer une adhésion. La création d'un message avec authentification de l'utilisateur peut également supprimer l'utilisateur authentifié avec un paramètre d'historique des discussions Chat en conflit de l'espace.
Pour en savoir plus, consultez Les utilisateurs peuvent être exclus des espaces dans le centre d'aide pour les administrateurs Google Workspace.
Résoudre les problèmes liés au service Chat avancé dans Google Apps Script
Consultez la page Apps Script concernant le service Chat avancé.
Les utilisateurs ne peuvent pas ajouter d'application Chat à un espace
Si les utilisateurs reçoivent le message d'erreur
This organization's administrator must allow users to install this Chat app
lorsqu'ils tentent d'ajouter une application Chat à un espace, cette erreur
peut être due à l'une des raisons suivantes :
- L'organisation a désactivé les applications Chat.
- L'organisation n'a pas ajouté cette application Chat spécifique à la liste d'autorisation de l'organisation.
Si un utilisateur reçoit ce message d'erreur lorsqu'il tente d'interagir avec une application Chat, cela peut être dû au fait que l'organisation a accordé l'accès à une sous-unité organisationnelle sans l'activer pour l'unité organisationnelle parente.
Pour savoir comment résoudre ce problème, consultez Autoriser les utilisateurs à installer des applications Chat.
L'administrateur doit accorder à l'application le niveau d'accès d'autorisation OAuth requis pour cette action
Lorsque vous vous authentifiez en tant qu'application Chat, vous pouvez recevoir l'erreur suivante :
<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.">
Ce message d'erreur signifie qu'un administrateur Google Workspace n'a pas encore accordé d'approbation unique à l'application Chat pour utiliser les champs d'application d'autorisation qui commencent par le nom https://www.googleapis.com/auth/chat.app.*.
Pour résoudre l'erreur :
- Demandez à l'administrateur Google Workspace de
donner son approbation à votre application Chat.
Lorsque vous gérez cette erreur dans la logique de votre application Chat,
envisagez d'envoyer un message annonçant que
l'application Chat a besoin de l'approbation de l'administrateur pour effectuer
l'action demandée, par exemple :
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - Si la méthode de l'API Chat est compatible avec le champ d'application d'autorisation
https://www.googleapis.com/auth/chat.bot, qui ne nécessite pas l'approbation de l'administrateur, envisagez de l'utiliser à la place. Pour vérifier les champs d'application d'autorisation compatibles avec une méthode, consultez les informations suivantes : Authentifier et autoriser les applications Google Chat et les requêtes API Google Chat.
Résoudre les problèmes liés aux erreurs Cloud Functions
Si l'application Chat est implémentée avec Cloud Functions et qu'elle ne fonctionne pas, les sections suivantes vous aideront à résoudre le problème.
Vérifier les journaux Cloud Functions
Pour commencer, vérifiez les journaux Cloud Functions pour détecter les erreurs.
Dans la console Google API, accédez à la page Cloud Functions :
Pour ouvrir les journaux, recherchez la fonction Cloud de votre application Chat, puis cliquez sur Afficher les actions > Afficher les journaux.
L'explorateur de journaux s'ouvre et exécute une requête affichant les journaux Cloud Functions, y compris les erreurs.
Si les informations enregistrées par défaut ne suffisent pas à déboguer votre application, vous pouvez ajouter des journaux supplémentaires à partir du code de votre fonction Cloud. Consultez Afficher et écrire des journaux de fonction Cloud.
Vérifier les erreurs Cloud Functions
Outre les journaux, Cloud Functions peut également signaler les erreurs rencontrées lors de l'exécution.
Dans la console Google API, accédez à la page Cloud Functions :
Cliquez sur la fonction Cloud de votre application Chat.
Sur la page d'informations sur la fonction, les erreurs sont listées sous Erreurs.
Pour résoudre une erreur, cliquez dessus.
Corriger les erreurs courantes Cloud Functions
Les erreurs suivantes sont parfois rencontrées lors de la création d'une application Chat avec Cloud Functions.
La fonction ChatApp dans la région REGION_NAME du projet PROJECT_NAME existe déjà
Lorsque vous déployez une fonction Cloud, vous pouvez recevoir l'erreur Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists. Ce message signifie qu'une autre fonction Cloud porte le même nom que celle que vous déployez. Modifiez le nom, puis redéployez la fonction. Vérifiez que l'application Chat utilise l'URL du déclencheur de votre fonction Cloud, et non celle de la fonction Cloud préexistante.
Un ou plusieurs utilisateurs nommés dans la règle n'appartiennent pas à un client autorisé
Lorsque vous déployez une fonction Cloud, vous pouvez recevoir l'erreur The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer." Si vous recevez cette erreur, puis que vous envoyez un message à l'
application Chat, vous recevez un message indiquant que l'application ne répond pas, car Google
Chat ne peut pas joindre le serveur hébergeant la fonction Cloud. Ce message signifie qu'un utilisateur nommé "allUsers" n'est pas autorisé à appeler la fonction Cloud.
Attribuer le rôle "Demandeur Cloud Functions" à "allUsers" signifie que la fonction Cloud qui alimente l'application est disponible publiquement et accessible sans authentification. Pour savoir comment attribuer un rôle, consultez
Attribuer un rôle unique.
Cette erreur peut signifier que le projet Google Cloud est limité à un domaine. Pour en savoir plus sur les contraintes de restriction de domaine, consultez Restreindre les identités par domaine.
Pour résoudre ce problème, vérifiez que votre fonction Cloud autorise les appels non authentifiés. Pour savoir comment autoriser les appels non authentifiés pour une fonction Cloud existante, consultez Autoriser l'accès public (non authentifié).