Przejdź do głównej zawartości

Połącz Smartsupp z Google Gemini

Połącz swoje konto Smartsupp z Google Gemini i pracuj z danymi live chatu za pomocą zwykłych zdań.

Połącz Smartsupp z Google Gemini i pracuj z danymi live chatu, po prostu pytając. Zamiast klikać po panelu, piszesz zwykłe zdanie — Gemini znajdzie informację, podsumuje ją albo od razu wykona akcję.

Gemini nie ma sekcji konektorów w aplikacji webowej (w przeciwieństwie do ChatGPT czy Claude), więc połączenie działa przez Gemini CLI — darmową oficjalną aplikację Google działającą w terminalu. Nie martw się, jeśli nigdy nie używałeś terminala: konfiguracja to kilka poleceń do skopiowania i robisz ją tylko raz.

Podzieliliśmy artykuł na kilka sekcji:


Zanim zaczniesz

Będziesz potrzebować:

  • Node.js 20 lub nowszy zainstalowany na komputerze. Sprawdź poleceniem node -v w terminalu lub pobierz go na nodejs.org.

  • Konto Google do utworzenia darmowego klucza API Gemini. W przeciwieństwie do ChatGPT nie potrzebujesz żadnego płatnego planu.

  • Dane logowania do Smartsuppa — podczas konfiguracji zalogujesz się na swoje konto Smartsupp i w ten sposób zatwierdzisz połączenie.


Konfiguracja połączenia

1. Zainstaluj Gemini CLI. Otwórz terminal (na Macu: aplikacja Terminal, na Windows: PowerShell) i uruchom:

npm install -g @google/gemini-cli

2. Utwórz klucz API Gemini. Przejdź do Google AI Studio, zaloguj się kontem Google i kliknij Create API key. Skopiuj klucz — będzie potrzebny w następnym kroku.

3. Zapisz klucz API. Uruchom w terminalu to polecenie (zamień your-key-here na skopiowany klucz):

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

4. Dodaj połączenie ze Smartsupp. Otwórz plik ~/.gemini/settings.json w dowolnym edytorze tekstu (utwórz go, jeśli nie istnieje) i wklej:

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

5. Uruchom Gemini. Uruchom w terminalu polecenie gemini. Jeśli zapyta, jak chcesz się zalogować, wybierz Use Gemini API Key.

6. Sprawdź połączenie. W Gemini wpisz /mcp. Powinieneś zobaczyć:

🟢 smartsupp – Ready (19 tools)

7. Autoryzuj połączenie. Przy pierwszym pytaniu o dane Smartsupp w przeglądarce otworzy się strona logowania Smartsupp. Logując się, zatwierdzasz dostęp — Gemini nigdy nie widzi Twojego hasła do Smartsuppa.

⚠️ Uwaga: Autoryzacja automatycznie użyje konta Smartsupp, na które jesteś aktualnie zalogowany w przeglądarce. Jeśli zarządzasz kilkoma kontami Smartsupp, przed autoryzacją upewnij się, że jesteś zalogowany na właściwe.

8. Sprawdź, czy działa. Wypróbuj proste polecenie, na przykład "Wypisz wszystkich agentów na moim koncie Smartsupp." Jeśli Gemini odpowie listą Twoich agentów, połączenie działa.


Co możesz zrobić

Po połączeniu Gemini może czytać Twoje dane Smartsupp i na Twoje polecenie zarządzać skrzynką odbiorczą. Po prostu napisz, czego potrzebujesz, jak zwykłe zdanie:

Przegląd rozmów

  • "Pokaż mi rozmowy z ostatniego tygodnia."

  • "Podsumuj tę rozmowę w trzech zdaniach."

  • "Które rozmowy są wciąż otwarte?"

Statystyki

  • "Ile nowych rozmów mieliśmy w zeszłym tygodniu?"

  • "Rozpisz nowe rozmowy dzień po dniu."

Kontakty

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

  • "Jakie tagi ma ten klient?"

Tagi

  • "Otaguj tę rozmowę tagiem Reklamacja."

  • "Utwórz nowy tag o nazwie VIP."

Zarządzanie rozmowami

  • "Przypisz tę rozmowę do agentki Marie."

  • "Zamknij tę rozmowę."

Odpowiedzi na czacie

  • "Wyślij do tej rozmowy: Dziękujemy za cierpliwość, już się tym zajmujemy."

💡 Pomysły do wypróbowania: Poranne podsumowanie ("Podsumuj wczorajsze rozmowy i wyróżnij te, które wymagają odpowiedzi") albo szybki raport ("Porównaj liczbę nowych rozmów w tym i zeszłym tygodniu").


Warto wiedzieć

  • Gemini pracuje na Twoich prawdziwych danych Smartsupp. Dostęp zatwierdzasz logowaniem (OAuth) — Gemini nigdy nie widzi Twojego hasła.

  • Odczyt (przeglądy, statystyki, kontakty) jest w pełni dostępny. Akcje (odpowiedzi, tagi, przypisania) są wykonywane tylko na Twoje polecenie — a Gemini prosi o potwierdzenie przed ich uruchomieniem.

  • Zmiana konta Smartsupp: zamknij Gemini, usuń folder ~/.mcp-auth (polecenie rm -rf ~/.mcp-auth), uruchom Gemini ponownie i zaloguj się na drugie konto.


Gdy coś nie działa

  • Błąd 401 na początku rozmowy: Gemini CLI czyta plik .env z folderu, z którego go uruchamiasz. Jeśli ten folder ma własny .env bez GEMINI_API_KEY, klucz nie zostanie wczytany. Dodaj klucz także do tego pliku albo uruchom Gemini z folderu domowego.

  • smartsupp pokazuje Disconnected: wpisz w Gemini /mcp auth smartsupp. Jeśli to nie pomoże, usuń ~/.mcp-auth i spróbuj ponownie.

  • npm install kończy się błędem uprawnień (EACCES): pomiń instalację i uruchom Gemini bezpośrednio przez npx @google/gemini-cli.


Co dalej?

💡 Potrzebujesz dalszej pomocy? Contact our zespołem wsparcia — chętnie pomożemy!

Czy to odpowiedziało na twoje pytanie?