Cette section décrit les problèmes courants que vous pouvez rencontrer lorsque vous créez et testez des applications Chat.
Un message de fiche, une boîte de dialogue ou un aperçu de lien ne s'affiche pas ou ne fonctionne pas comme prévu
Pour obtenir de l'aide concernant la résolution des erreurs de cartes, consultez Résoudre les problèmes liés aux 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 la configuration de l'application Chat:
Dans la console Google Cloud, cliquez sur Menu > Plus de produits > Google Workspace > Bibliothèque de produits > API Google Chat > Gérer > Configuration.
Sous État de l'application, assurez-vous d'avoir sélectionné En ligne - disponible pour les utilisateurs.
Sous Fonctionnalités interactives, assurez-vous que les paramètres sont adaptés au fonctionnement de votre application. Si votre application Chat interagit avec les utilisateurs, veillez à activer l'option Activer les fonctionnalités interactives:
- Si l'application répond aux messages, veillez à sélectionner Recevoir des messages privés.
- Sous Paramètres de connexion, assurez-vous que l'URL de l'application, 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 qu'ils sont déployés.
- Sous Visibilité, assurez-vous que les utilisateurs appropriés ont accès à l'application depuis une adresse e-mail ou un groupe du domaine Google Workspace. Si l'application est déployée avec le SDK Google Workspace Marketplace, 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, vérifiez les paramètres de Google Workspace Marketplace.
Cliquez sur Enregistrer.
Réessayez d'envoyer des messages à l'application.
L'API Google Chat n'est disponible que pour les utilisateurs de Google Workspace.
Lors de la configuration de l'application Chat, l'erreur Google Chat API is only available to Google Workspace users peut s'afficher. 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 Google Chat peuvent se servir des applications Chat sans compte Google Workspace. Pour en savoir plus sur la manière dont les utilisateurs découvrent et installent des applications Chat, consultez Publier des applications Google Chat.
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 qu'ils ne puissent pas rejoindre ou rester dans un espace en raison d'un conflit entre un paramètre au niveau de l'utilisateur qui force l'activation ou 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 activé d'office un paramètre d'historique des discussions et qu'un espace est désactivé d'office, cet utilisateur ne pourra peut-être pas rejoindre l'espace. De plus, cet utilisateur peut être exclu de l'espace s'il a rejoint l'espace avant le conflit, puis y publier un message après le conflit.
Dans ce scénario et dans d'autres cas de conflit entre les paramètres d'historique, il se peut que l'API Chat ne puisse pas créer d'adhésion ou que la création d'un message avec authentification de l'utilisateur entraîne l'exclusion de l'utilisateur authentifié dont le paramètre d'historique des discussions est en conflit.
Pour en savoir plus, consultez Les utilisateurs peuvent être exclus des espaces dans le centre d'aide Administrateur Google Workspace.
Résoudre les problèmes liés au service de chat avancé dans Google Apps Script
Consultez la page Apps Script concernant le service Chat avancé.
Impossible pour les utilisateurs d'ajouter une 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 à sa liste d'autorisation.
Si un utilisateur rencontre ce message d'erreur lorsqu'il tente d'interagir avec une application Chat, cela peut être dû au fait que l'organisation accorde 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.
Résoudre les 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 de la fonction Cloud
Dans un premier temps, recherchez les erreurs dans les journaux Cloud Functions.
Dans la console Google Cloud, 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 ouvre et exécute une requête affichant les journaux de la fonction Cloud, y compris les erreurs.
Si les informations par défaut consignées ne sont pas suffisantes pour déboguer votre application, vous pouvez ajouter une journalisation supplémentaire à partir du code de votre fonction Cloud. Consultez la section Afficher et écrire les journaux d'une fonction Cloud.
Vérifier les erreurs de la fonction Cloud
Outre les journaux, la fonction Cloud peut également signaler des erreurs rencontrées lors de l'exécution.
Dans la console Google Cloud, accédez à la page "Cloud Functions" :
Cliquez sur la fonction Cloud de votre application Chat.
Sur la page d'informations de la fonction, les erreurs sont répertoriées sous Erreurs.
Pour résoudre le problème, cliquez dessus.
Corriger les erreurs courantes dans Cloud Functions
Les erreurs suivantes peuvent se produire lors de la création d'une application Chat avec Cloud Functions.
La fonction ChatApp existe déjà dans la région REGION_NAME du projet PROJECT_NAME
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 et déployez à nouveau la fonction. Vérifiez que l'application Chat utilise l'URL de 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 cette erreur s'affiche, puis que vous envoyez un message à l'application Chat, vous recevez un message d'erreur indiquant que l'application ne répond pas, car Google Chat ne peut pas accéder au serveur hébergeant la fonction Cloud. Ce message signifie qu'un utilisateur nommé "allUsers" n'est pas autorisé à appeler la fonction Cloud.
L'attribution du rôle "Demandeur Cloud Functions" à "allUsers" signifie que la fonction Cloud qui alimente l'application est accessible au public et accessible sans authentification. Pour savoir comment attribuer un rôle, consultez Attribuer un seul rôle.
Cette erreur peut signifier que le projet Google Cloud est limité au domaine. Pour en savoir plus sur les contraintes de restriction de domaine, consultez la page 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 la page Autoriser l'accès public (non authentifié).