Configuration de la console Google
Avant que le module Google Workspace puisse communiquer avec les services Google, vous devez créer un projet Google Cloud, activer les API requises et générer des identifiants OAuth. Ce guide vous accompagne à chaque étape.
Étape 1 : Créer un projet Google Cloud
- Allez sur la Google API Console.
- Cliquez sur Select a project dans la barre de navigation supérieure, puis cliquez sur New Project.
- Saisissez un nom de projet (par ex., « Concord CRM Integration »).
- Cliquez sur Create et attendez que le projet soit provisionné.
- Assurez-vous que le nouveau projet est sélectionné dans le menu déroulant des projets.
Si vous avez déjà un projet Google Cloud que vous souhaitez réutiliser, sélectionnez-le dans la liste des projets au lieu d'en créer un nouveau.
Étape 2 : Activer les API requises
Avec votre projet sélectionné, activez chacune des API suivantes :
- Naviguez vers APIs & Services → Library.
- Recherchez et activez chaque API individuellement :
- Google Drive API
- Google Docs API
- Google Sheets API
- Google Slides API
Pour chaque API :
- Cliquez sur le nom de l'API dans les résultats de recherche.
- Cliquez sur Enable.
- Attendez la confirmation avant de passer à la suivante.
Les quatre API doivent être activées pour que le module fonctionne correctement. Si une API est manquante, le service Google correspondant ne sera pas accessible depuis le CRM.
Étape 3 : Configurer l'écran de consentement OAuth
- Naviguez vers APIs & Services → OAuth consent screen.
- Sélectionnez le type d'utilisateur :
- External -- Recommandé pour la plupart des configurations. Permet à tout compte Google de s'autoriser.
- Internal -- Disponible uniquement pour les comptes Google Workspace (payants). Limite l'accès aux utilisateurs de votre organisation.
- Cliquez sur Create.
- Remplissez les champs obligatoires :
- App Name -- Un nom que les utilisateurs verront lors de l'autorisation (par ex., « Concord CRM »).
- User Support Email -- Votre adresse e-mail de support.
- Developer Contact Information -- Votre adresse e-mail.
- Cliquez sur Save and Continue à travers les étapes Scopes et Test Users (aucune modification nécessaire pour une configuration de base).
- Cliquez sur Back to Dashboard depuis l'onglet Summary.
Statut de publication
| Statut | HTTPS requis | Notes |
|---|---|---|
| Testing | Non | Limité à 100 utilisateurs test ; affiche un avertissement de consentement supplémentaire |
| Production | Oui | Disponible pour tous les utilisateurs ; votre site doit utiliser HTTPS |
Pour la configuration et les tests initiaux, gardez l'application en mode Testing. Une fois que vous avez vérifié que tout fonctionne, passez en Production pour une expérience d'autorisation fluide.
Étape 4 : Créer les identifiants OAuth
- Naviguez vers APIs & Services → Credentials.
- Cliquez sur Create Credentials → OAuth client ID.
- Sélectionnez Web application comme type d'application.
- Saisissez un nom pour l'identifiant (par ex., « Concord CRM OAuth »).
- Sous Authorized redirect URIs, ajoutez l'URI suivante :
https://yourdomain.com/google-workspace/callback
Remplacez yourdomain.com par le domaine réel où votre Concord CRM est installé.
- Cliquez sur Create.
- Une boîte de dialogue affichera votre Client ID et Client Secret. Copiez les deux valeurs.
L'URI de redirection doit correspondre exactement à l'URL d'installation de votre Concord CRM, y compris le protocole (HTTPS) et le chemin. Une URI de redirection incorrecte entraînera un échec d'autorisation.
Étape 5 : Connecter à Concord CRM
- Connectez-vous à votre Concord CRM en tant qu'administrateur.
- Naviguez vers les paramètres du module Google Workspace.
- Collez le Client ID et le Client Secret de l'étape précédente.
- Cliquez sur Save & Authorize.
- Un écran de consentement Google apparaîtra. Sélectionnez votre compte Google et accordez les permissions demandées.
- Vous serez redirigé vers Concord CRM. Le statut de connexion devrait maintenant afficher Authorized.
Si votre application Google Cloud est en mode Testing, vous verrez un écran d'avertissement supplémentaire lors de l'autorisation. Cliquez sur Continue pour continuer. Cet avertissement n'apparaît pas en mode Production.
Dépannage
| Problème | Solution |
|---|---|
| « Error 400: redirect_uri_mismatch » | Vérifiez que l'URI de redirection dans Google Cloud correspond exactement à l'URL de votre CRM |
| L'autorisation échoue silencieusement | Assurez-vous que les quatre API sont activées dans le projet Google Cloud |
| « Access blocked: App not verified » | Passez en mode Production ou ajoutez votre compte comme utilisateur test |
| La connexion se coupe après un certain temps | Ré-autorisez depuis les paramètres du module ; vérifiez les paramètres de rafraîchissement du token |
Recommandations de sécurité
- Restreignez les identifiants OAuth à votre domaine spécifique en utilisant les URI de redirection autorisées.
- Utilisez HTTPS pour votre installation Concord CRM afin de protéger les tokens OAuth en transit.
- Révisez l'accès aux API périodiquement dans la Google Cloud Console pour vous assurer qu'aucune permission inutile n'est accordée.
- Effectuez une rotation des identifiants si vous suspectez qu'ils ont été compromis.
Si vous avez besoin d'aide pour configurer votre projet Google Cloud, visitez l'espace de support Themesic pour obtenir de l'assistance.