Siirry pääsisältöön

Yhdistä Smartsupp Google Geminiin

Yhdistä Smartsupp-tilisi Google Geminiin ja työskentele live chat -tietojesi kanssa tavallisilla kielikomennoilla.

Yhdistä Smartsupp Google Geminiin ja työskentele live chat -tietojesi kanssa pelkästään kysymällä. Sen sijaan että klikkaisit hallintapaneelin läpi, kirjoitat tavallisen lauseen — Gemini löytää tiedot, tiivistää ne tai suorittaa toiminnon puolestasi.

Geminin verkkosovelluksessa ei ole liitinosiota (toisin kuin ChatGPT:ssä tai Claudessa), joten yhdistäminen tehdään Gemini CLI:n kautta — ilmainen Googlen virallinen sovellus, joka pyörii terminaalissa. Älä huoli, jos et ole käyttänyt terminaalia aiemmin: käyttöönotto on muutama kopioi–liitä-komento ja teet sen vain kerran.

Olemme jakaneet tämän ohjeen muutamaan osioon:


Ennen kuin aloitat

Tarvitset:

  • Node.js 20 tai uudempi asennettuna tietokoneellesi. Tarkista ajamalla komento node -v terminaalissasi tai lataa osoitteesta nodejs.org.

  • Google-tili jonka avulla luot ilmaisen Gemini API -avaimen. Toisin kuin ChatGPT:ssä, et tarvitse mitään maksettua pakettia.

  • Smartsupp-kirjautumistietosi — käyttöönoton aikana kirjaudut Smartsupp-tilillesi ja hyväksyt yhdistämisen.

🟡 Vaatimus: Smartsupp MCP -palvelin on saatavilla Plus -paketissa ja sitä korkeammissa.


Yhdistä yhteys

1. Asenna Gemini CLI. Avaa terminaali (Mac: Terminal-sovellus, Windows: PowerShell) ja suorita:

npm install -g @google/gemini-cli

2. Luo Gemini API -avain. Siirry sivulle Google AI Studio, kirjaudu sisään Google-tililläsi ja klikkaa Luo API-avain. Kopioi avain — tarvitset sitä seuraavassa vaiheessa.

3. Tallenna API-avain. Suorita tämä komento terminaalissa (korvaa your-key-here kopioimallasi avaimella):

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

4. Lisää Smartsupp-yhteys. Avaa tiedosto ~/.gemini/settings.json millä tahansa tekstieditorilla (luo se, jos sitä ei ole) ja liitä:

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

5. Käynnistä Gemini. Suorita gemini terminaalissa. Jos se kysyy, miten haluat kirjautua sisään, valitse Käytä Gemini API -avainta.

6. Tarkista yhteys. Kirjoita Geminissä /mcp. Sinun pitäisi nähdä:

🟢 smartsupp – Ready (19 tools)


7. Valtuuta yhteys. Kun kysyt ensimmäistä kertaa Smartsupp-dataasi liittyvän kysymyksen, selain avaa Smartsupp-kirjautumissivun. Kirjaudu sisään hyväksyäksesi pääsyn — hyväksyt yhteyden kirjautumalla sisään, eikä Gemini näe Smartsupp-salasanaasi.

⚠️ Huomio: Valtuutus käyttää automaattisesti sitä Smartsupp-tiliä, jolla olet juuri nyt kirjautuneena selaimeen. Jos hallinnoit useampaa kuin yhtä Smartsupp-tiliä, tarkista, että olet kirjautunut oikealle tilille ennen valtuutusta.

8. Varmista, että se toimii. Kokeile yksinkertaista pyyntöä, esimerkiksi "Listaa kaikki agentit Smartsupp-tililtäni." Jos Gemini vastaa agenttilistallasi, yhteys toimii.


Mitä voit tehdä

Kun yhteys on muodostettu, Gemini voi lukea Smartsupp-tietosi ja hallita postilaatikkoasi ohjeidesi mukaan. Kirjoita vain, mitä tarvitset, tavallisena lauseena:

Keskustelujen yleiskatsaus

  • "Näytä minulle viime viikon keskustelut."

  • "Tiivistä tämä keskustelu kolmeen lauseeseen."

  • "Mitkä keskustelut ovat vielä avoinna?"

Tilastot

  • "Kuinka monta uutta keskustelua meillä oli viime viikolla?"

  • "Erittele uudet keskustelut päiväkohtaisesti."

Yhteystiedot

  • "Etsi yhteystieto, jonka sähköposti on jan@example.com."

  • "Mitkä tunnisteet tällä asiakkaalla on?"

Tunnisteet

  • "Merkitse tämä keskustelu tunnisteella Valitus."

  • "Luo uusi tunniste nimeltä VIP."

Keskustelujen hallinta

  • "Siirrä tämä keskustelu agentille Marie."

  • "Sulje tämä keskustelu."

Vastaukset chattiin

  • "Lähetä tähän keskusteluun: Kiitos kärsivällisyydestäsi, hoidamme asiaa."

💡 Ideoita kokeiltavaksi: Aamukooste ("Tiivistä eiliset keskustelut ja nosta esiin ne, jotka kaipaavat vastausta"), tai nopea raportti ("Vertaa uusien keskustelujen määrää tällä ja viime viikolla").


Hyvä tietää

  • Gemini toimii sinun oikeilla Smartsupp-tiedoillasi. Hyväksyt pääsyn kirjautumalla sisään (OAuth) – Gemini ei näe salasanaasi koskaan.

  • Luku (yleiskatsaus, tilastot, kontaktit) on käytettävissä kokonaan. Toiminnot (vastaukset, tunnisteet, tehtävien määritykset) suoritetaan vain, kun pyydät niitä — ja Gemini pyytää sinua vahvistamaan ennen niiden suorittamista.

  • Smartsupp-tilien vaihtaminen: sulje Gemini, poista kansio ~/.mcp-auth (suorita rm -rf ~/.mcp-auth), käynnistä Gemini uudelleen ja kirjaudu sisään toisella tilillä.


Vianmääritys

  • 401-virhe, kun aloitat chatin: Gemini CLI lukee .env .env-tiedoston kansiosta, josta ajat sen. Jos kyseisessä kansiossa on oma .env ilman GEMINI_API_KEY, avainta ei poimita. Lisää avain myös siihen tiedostoon tai käynnistä Gemini kotikansiostasi.

  • Smartsupp näyttää tilaksi Disconnected: kirjoita /mcp auth smartsupp Geminin sisällä. Jos tämä ei auta, poista ~/.mcp-auth ja yritä uudelleen.

  • npm install epäonnistuu oikeusvirheellä (EACCES): ohita asennus ja aja Gemini suoraan komennolla npx @google/gemini-cli.


Mitä seuraavaksi?

💡 Tarvitsetko lisää apua? Ota yhteyttä tukeemme tukitiimiin — autamme mielellämme!

Vastasiko tämä kysymykseesi?