Naar de hoofdinhoud

Smartsupp koppelen aan Google Gemini

Koppel je Smartsupp-account aan Google Gemini en werk met je live chat-gegevens via prompts in gewone taal.

Geschreven door Michal Jindra

Koppel Smartsupp aan Google Gemini en werk met je live chat-gegevens door er gewoon om te vragen. In plaats van door het dashboard te klikken, typ je een gewone zin – Gemini zoekt de informatie op, vat die samen of voert de actie voor je uit.

Gemini heeft in de webapp geen gedeelte voor connectors (anders dan ChatGPT of Claude), dus de koppeling loopt via Gemini CLI – een gratis officiële app van Google die in de terminal draait. Geen zorgen als je nog nooit een terminal hebt gebruikt: het instellen bestaat uit een paar opdrachten die je kopieert en plakt, en je doet het maar één keer.

We hebben dit artikel opgedeeld in een paar onderdelen:


Voordat je begint

Je hebt nodig:

  • Node.js 20 of nieuwer op je computer. Controleer dat met node -v in je terminal, of download het op nodejs.org.

  • Een Google-account om een gratis Gemini API-sleutel aan te maken. Anders dan bij ChatGPT heb je geen betaald abonnement nodig.

  • Je Smartsupp-inloggegevens – tijdens het instellen log je in op je Smartsupp-account om de koppeling goed te keuren.

🟡 Vereiste: De Smartsupp MCP-server is beschikbaar vanaf het PLUS-pakket.


De koppeling instellen

1. Installeer Gemini CLI. Open je terminal (op Mac: de app Terminal, op Windows: PowerShell) en voer uit:

npm install -g @google/gemini-cli

2. Maak je Gemini API-sleutel aan. Ga naar Google AI Studio, log in met je Google-account en klik op Create API key. Kopieer de sleutel – die heb je in de volgende stap nodig.

3. Sla de API-sleutel op. Voer deze opdracht uit in je terminal (vervang your-key-here door de sleutel die je hebt gekopieerd):

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

4. Voeg de Smartsupp-koppeling toe. Open het bestand ~/.gemini/settings.json in een teksteditor (maak het aan als het nog niet bestaat) en plak:

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

5. Start Gemini. Voer gemini uit in je terminal. Vraagt die hoe je wilt inloggen, kies dan Use Gemini API Key.

6. Controleer de koppeling. Typ in Gemini /mcp. Je zou dit moeten zien:

🟢 smartsupp – Ready (19 tools)


7. Keur de koppeling goed. De eerste keer dat je naar je Smartsupp-gegevens vraagt, opent er een Smartsupp-inlogpagina in je browser. Log in om de toegang goed te keuren – je keurt de koppeling goed door in te loggen, en Gemini ziet je Smartsupp-wachtwoord nooit.

⚠️ Let op: De autorisatie gebruikt automatisch het Smartsupp-account waarop je op dat moment in je browser bent ingelogd. Beheer je meerdere Smartsupp-accounts, controleer dan vóór het goedkeuren of je op het juiste account bent ingelogd.

8. Controleer of het werkt. Probeer een eenvoudig verzoek, bijvoorbeeld “Geef een lijst van alle agents in mijn Smartsupp-account.” Antwoordt Gemini met je lijst met agents, dan werkt de koppeling.


Wat je ermee kunt

Zodra de koppeling er is, kan Gemini je Smartsupp-gegevens lezen en je inbox beheren op jouw aanwijzing. Schrijf gewoon als een normale zin wat je nodig hebt:

Overzicht van gesprekken

  • “Laat me de gesprekken van de afgelopen week zien.”

  • “Vat dit gesprek samen in drie zinnen.”

  • “Welke gesprekken staan nog open?”

Statistieken

  • “Hoeveel nieuwe gesprekken hadden we vorige week?”

  • “Splits de nieuwe gesprekken uit per dag.”

Contacten

  • “Zoek het contact met het e-mailadres jan@example.com.”

  • “Welke tags heeft deze klant?”

Tags

  • “Tag dit gesprek met Klacht.”

  • “Maak een nieuwe tag met de naam VIP.”

Gesprekken beheren

  • “Wijs dit gesprek toe aan agent Marie.”

  • “Sluit dit gesprek.”

Antwoorden in de chat

  • “Stuur naar dit gesprek: Bedankt voor je geduld, we zijn ermee bezig.”

💡 Ideeën om te proberen: Een ochtendoverzicht (“Vat de gesprekken van gisteren samen en markeer de gesprekken die een antwoord nodig hebben”) of een snel rapport (“Vergelijk het aantal nieuwe gesprekken van deze week en vorige week”).


Goed om te weten

  • Gemini werkt met je echte Smartsupp-gegevens. Je keurt de toegang goed door in te loggen (OAuth) – Gemini ziet je wachtwoord nooit.

  • Lezen (overzichten, statistieken, contacten) is volledig beschikbaar. Acties (antwoorden, tags, toewijzingen) worden alleen uitgevoerd als je erom vraagt – en Gemini vraagt je die eerst te bevestigen.

  • Wisselen van Smartsupp-account: sluit Gemini, verwijder de map ~/.mcp-auth (voer rm -rf ~/.mcp-auth uit), start Gemini opnieuw en log in met het andere account.


Problemen oplossen

  • 401-fout zodra je begint te chatten: Gemini CLI leest het bestand .env uit de map waarin je het uitvoert. Heeft die map een eigen .env zonder GEMINI_API_KEY, dan wordt de sleutel niet opgepikt. Voeg de sleutel ook aan dat bestand toe, of start Gemini vanuit je thuismap.

  • smartsupp staat op Disconnected: typ in Gemini /mcp auth smartsupp. Helpt dat niet, verwijder dan ~/.mcp-auth en probeer het opnieuw.

  • npm install mislukt met een rechtenfout (EACCES): sla de installatie over en voer Gemini rechtstreeks uit met npx @google/gemini-cli.


Wat is de volgende stap?

💡 Meer hulp nodig? Neem contact op met ons supportteam – we helpen je graag!

Was dit een antwoord op uw vraag?