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 les erreurs liées aux 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. > Autres 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, assurez-vous d'activer l'option Activer les fonctionnalités interactives:
- Si votre application répond aux messages, assurez-vous de 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 avec 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 Google Workspace Marketplace.
Cliquez sur Enregistrer.
Ré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, il se peut que vous receviez
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 un
application de chat ou l'API Chat, vous devez utiliser un
Google Workspace
compte.
Notez que les utilisateurs de Google Chat peuvent utiliser les applications Chat sans Google Workspace. Pour savoir comment les utilisateurs découvrent et installent les applications de chat, consultez la section Publier Applications Google Chat
Les utilisateurs peuvent être exclus des espaces
Si un administrateur Google Workspace n'autorise pas les utilisateurs à activer ou désactiver l'historique des discussions, il peut arriver que des utilisateurs ne puissent pas rejoindre ou rester dans un espace en raison d'un conflit entre un paramètre 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 l'historique des discussions d'un utilisateur est activé d'office et que le paramètre "Historique des discussions" d'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 l'a rejoint avant le conflit, puis qu'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, il est possible que l'API Chat ne puisse pas créer d'adhésion. La création d'un message avec authentification de l'utilisateur peut supprimer de l'espace l'utilisateur authentifié qui présente un paramètre d'historique des discussions en conflit.
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 Advanced Chat dans Google Apps Script
Consultez la page Apps Script concernant le Service de chat avancé.
Les utilisateurs ne peuvent pas ajouter d'application Chat à un espace
Si les utilisateurs rencontrent le message d'erreur
This organization's administrator must allow users to install this Chat app
lorsque vous essayez d'ajouter une application Chat à un espace, ce message d'erreur
peut avoir l'une des raisons suivantes:
- L'organisation a désactivé les applications Chat.
- L'organisation n'a pas ajouté cet élément l'application Chat à la liste d'autorisation de l'organisation.
Si un utilisateur rencontre ce message d'erreur lorsqu'il tente d'interagir avec un Application Chat, le problème peut être dû à l'organisation sans accorder l'accès à une sous-unité organisationnelle, sans l'activer pour unité organisationnelle parente.
Pour savoir comment résoudre ce problème, consultez Autorisez les utilisateurs à installer des applications Chat.
Résoudre les erreurs liées à la fonction Cloud
Si l'application Chat est implémentée avec Cloud Functions et cela ne fonctionne pas, les sections suivantes aident à résoudre le problème.
Vérifier les journaux de la fonction Cloud
Commencez par rechercher des erreurs dans les journaux Cloud Functions.
Dans la console Google Cloud, accédez à la page Cloud Functions.
Pour ouvrir les journaux, accédez au cloud de votre application Chat Fonction, puis cliquez sur Afficher les actions > Afficher les journaux.
L'explorateur de journaux s'ouvre et exécute une requête affichant les journaux de la fonction Cloud, y compris les erreurs.
Si les informations enregistrées par défaut ne suffisent pas à déboguer votre application, vous pouvez ajouter une journalisation supplémentaire à partir du code de votre fonction Cloud. Consultez la page Afficher et écrire des données Journaux des fonctions
Vérifier les erreurs de la fonction Cloud
Outre les journaux, la fonction Cloud peut également signaler les erreurs rencontrées en cours d'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étails de la fonction", les erreurs sont répertoriées sous Erreurs.
Pour résoudre un problème, cliquez dessus.
Corriger les erreurs courantes liées à la fonction Cloud
Les erreurs suivantes se produisent parfois lors de la création d'une Application de 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 la
celui que vous déployez. modifier son nom ;
déployer à nouveau la fonction. Vérifiez que l'application Chat utilise l'URL de déclenchement pour
votre fonction Cloud, et non l'URL de déclenchement de la fonction Cloud préexistante.
Un ou plusieurs utilisateurs nommés dans la règle n'appartiennent pas à un client autorisé
Lors du déploiement d'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 obtenez cette erreur, puis envoyez un message au
l'application de chat, vous recevez un message d'erreur indiquant que l'application ne répond pas, car Google
Chat ne peut pas atteindre le serveur qui héberge la fonction Cloud. Ce message signifie que
un utilisateur nommé "allUsers" ne dispose pas des autorisations nécessaires pour appeler la fonction Cloud.
Attribuer "allUsers" le "Demandeur Cloud Functions" signifie que le rôle d'administrateur
La fonction qui alimente l'application est accessible au public et accessible sans
l'authentification unique. Pour savoir comment attribuer un rôle, consultez
Accordez un seul rôle.
Cette erreur peut signifier que le projet Google Cloud est limité au domaine. Pour 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 l'accès non authentifié d'appels. Pour savoir comment autoriser les appels non authentifiés pour Cloud Functions, reportez-vous à Autoriser l'accès public (non authentifié)