Passer au contenu principal

Connecter Smartsupp à Google Gemini

Connectez votre compte Smartsupp à Google Gemini et travaillez avec vos données de chat en direct en utilisant des phrases normales.

Connectez Smartsupp à Google Gemini et travaillez avec vos données de chat en direct simplement en posant une question. Au lieu de cliquer dans le tableau de bord, vous écrivez une phrase normale — Gemini trouve l'information, la résume ou effectue l'action pour vous.

Gemini n'a pas de section connecteurs dans son application web (contrairement à ChatGPT ou Claude) ; la connexion passe donc par Gemini CLI — une application officielle gratuite de Google qui s'exécute dans le terminal. Pas d'inquiétude si vous n'avez jamais utilisé de terminal : la configuration se résume à quelques commandes à copier-coller, et une seule fois.

Nous avons divisé l'article en plusieurs sections :


Avant de commencer

Vous aurez besoin de :

  • Node.js 20 ou plus récent installé sur votre ordinateur. Vérifiez avec node -v dans le terminal, ou téléchargez-le sur nodejs.org.

  • Un compte Google pour créer une clé API Gemini gratuite. Contrairement à ChatGPT, aucun plan payant n'est nécessaire.

  • Vos identifiants Smartsupp — pendant la configuration, vous vous connecterez à votre compte Smartsupp pour approuver la connexion.


Configurer la connexion

1. Installez Gemini CLI. Ouvrez votre terminal (Mac : application Terminal, Windows : PowerShell) et exécutez :

npm install -g @google/gemini-cli

2. Créez votre clé API Gemini. Rendez-vous sur Google AI Studio, connectez-vous avec votre compte Google et cliquez sur Create API key. Copiez la clé — vous en aurez besoin à l'étape suivante.

3. Enregistrez la clé API. Exécutez cette commande dans le terminal (remplacez your-key-here par la clé copiée) :

mkdir -p ~/.gemini && echo 'GEMINI_API_KEY=your-key-here' >> ~/.gemini/.env

4. Ajoutez la connexion Smartsupp. Ouvrez le fichier ~/.gemini/settings.json dans un éditeur de texte (créez-le s'il n'existe pas) et collez :

{
  "mcpServers": {
    "smartsupp": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.smartsupp.com/mcp"],
      "timeout": 30000
    }
  },
  "security": {
    "auth": { "selectedType": "gemini-api-key" }
  }
}

5. Démarrez Gemini. Exécutez gemini dans le terminal. S'il vous demande comment vous connecter, choisissez Use Gemini API Key.

6. Vérifiez la connexion. Dans Gemini, tapez /mcp. Vous devriez voir :

🟢 smartsupp – Ready (19 tools)

7. Autorisez la connexion. La première fois que vous interrogez vos données Smartsupp, une page de connexion Smartsupp s'ouvre dans votre navigateur. Connectez-vous pour approuver l'accès — Gemini ne voit jamais votre mot de passe Smartsupp.

⚠️ Remarque : L'autorisation utilise automatiquement le compte Smartsupp auquel vous êtes connecté dans votre navigateur. Si vous gérez plusieurs comptes Smartsupp, vérifiez avant d'autoriser que vous êtes connecté au bon compte.

8. Vérifiez que tout fonctionne. Essayez une requête simple, par exemple "Liste tous les agents de mon compte Smartsupp." Si Gemini répond avec votre liste d'agents, la connexion est opérationnelle.


Ce que vous pouvez faire

Une fois connecté, Gemini peut lire vos données Smartsupp et gérer votre boîte de réception sur votre instruction. Écrivez simplement ce dont vous avez besoin comme une phrase normale :

Aperçu des conversations

  • "Montre-moi les conversations de la semaine dernière."

  • "Résume cette conversation en trois phrases."

  • "Quelles conversations sont encore ouvertes ?"

Statistiques

  • "Combien de nouvelles conversations avons-nous eues la semaine dernière ?"

  • "Détaille les nouvelles conversations jour par jour."

Contacts

  • "Find the contact with the email jan@example.com."

  • "Quels tags ce client a-t-il ?"

Tags

  • "Tague cette conversation avec Réclamation."

  • "Crée un nouveau tag nommé VIP."

Gestion des conversations

  • "Assigne cette conversation à l'agente Marie."

  • "Ferme cette conversation."

Réponses dans le chat

  • "Envoie dans cette conversation : Merci pour votre patience, nous nous en occupons."

💡 Idées à essayer : Un récapitulatif matinal ("Résume les conversations d'hier et mets en avant celles qui nécessitent une réponse") ou un rapport rapide ("Compare le nombre de nouvelles conversations cette semaine et la semaine dernière").


Bon à savoir

  • Gemini travaille avec vos données Smartsupp réelles. Vous approuvez l'accès en vous connectant (OAuth) — Gemini ne voit jamais votre mot de passe.

  • La lecture (aperçus, statistiques, contacts) est entièrement disponible. Les actions (réponses, tags, assignations) ne sont effectuées que lorsque vous les demandez — et Gemini vous demande confirmation avant de les exécuter.

  • Changer de compte Smartsupp : fermez Gemini, supprimez le dossier ~/.mcp-auth (commande rm -rf ~/.mcp-auth), redémarrez Gemini et connectez-vous avec l'autre compte.


Quand quelque chose ne fonctionne pas

  • Erreur 401 au début de la conversation : Gemini CLI lit le fichier .env du dossier depuis lequel vous le lancez. Si ce dossier a son propre .env sans GEMINI_API_KEY, la clé n'est pas prise en compte. Ajoutez la clé à ce fichier aussi, ou lancez Gemini depuis votre dossier personnel.

  • smartsupp affiche Disconnected : tapez /mcp auth smartsupp dans Gemini. Si cela ne suffit pas, supprimez ~/.mcp-auth et réessayez.

  • npm install échoue avec une erreur de permission (EACCES) : passez l'installation et lancez Gemini directement avec npx @google/gemini-cli.


Et ensuite ?

💡 Besoin d'aide supplémentaire ? Contact our équipe d'assistance — nous serons ravis de vous aider !

Avez-vous trouvé la réponse à votre question ?