Перейти до основного контенту

Підключення Smartsupp до Google Gemini

Підключіть свій обліковий запис Smartsupp до Google Gemini і працюйте з даними живого чату за допомогою запитів звичайною мовою.

Підключіть Smartsupp до Google Gemini і працюйте з даними живого чату, просто ставлячи запитання. Замість того щоб клацати по панелі управління, ви вводите просте речення — Gemini знаходить інформацію, підсумовує її або виконує дію за вас.

У вебдодатку Gemini немає розділу з конекторами (на відміну від ChatGPT або Claude), тому підключення виконується через Gemini CLI — безкоштовний офіційний додаток від Google, який працює в терміналі. Не хвилюйтеся, якщо ви раніше не користувалися терміналом: налаштування зводиться до кількох команд копіювання-вставлення, і ви робите це лише один раз.

Ми розбили статтю на кілька розділів:


Перш ніж почати

Вам знадобиться:

  • Node.js 20 або новіша версія, встановлена на вашому комп’ютері. Перевірте, виконавши в терміналі команду node -v, або завантажте на сайті nodejs.org.

  • Обліковий запис Google для створення безкоштовного ключа Gemini API. На відміну від ChatGPT, жоден платний пакет не потрібен.

  • Ваші дані для входу в Smartsupp — під час налаштування ви ввійдете у свій обліковий запис Smartsupp, щоб підтвердити підключення.

🟡 Вимога: сервер Smartsupp MCP доступний у пакеті PLUS і вище.


Налаштувати підключення

1. Встановіть Gemini CLI. Відкрийте термінал (на Mac: додаток Terminal, у Windows: PowerShell) і виконайте:

npm install -g @google/gemini-cli

2. Створіть свій ключ Gemini API. Перейдіть до Google AI Studio, увійдіть за допомогою облікового запису Google і натисніть Create API key. Скопіюйте ключ — він знадобиться в наступному кроці.

3. Збережіть ключ API. Виконайте цю команду в терміналі (замініть your-key-here на скопійований ключ):

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

4. Додайте підключення Smartsupp. Відкрийте файл ~/.gemini/settings.json у будь-якому текстовому редакторі (створіть його, якщо його не існує) і вставте:

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

5. Запустіть Gemini. Виконайте gemini у вашому терміналі. Якщо з’явиться запит, як ви хочете ввійти, виберіть Use Gemini API Key.

6. Перевірте підключення. У Gemini введіть /mcp. Ви повинні побачити:

🟢 smartsupp – Ready (19 tools)


7. Авторизуйте підключення. Коли ви вперше запитаєте про свої дані Smartsupp, у браузері відкриється сторінка входу Smartsupp. Увійдіть, щоб підтвердити доступ — ви підтверджуєте підключення, виконуючи вхід, і Gemini ніколи не бачить ваш пароль від Smartsupp.

⚠️ Примітка: авторизація автоматично використовує обліковий запис Smartsupp, у який ви зараз увійшли у своєму браузері. Якщо ви керуєте кількома обліковими записами Smartsupp, перед авторизацією ще раз перевірте, що ви ввійшли в потрібний.

8. Переконайтеся, що все працює. Спробуйте простий запит, наприклад "Переліч усіх агентів у моєму обліковому записі Smartsupp." Якщо Gemini відповість списком ваших агентів, підключення працює.


Що ви можете робити

Після підключення Gemini може читати дані Smartsupp і керувати вашою скринькою вхідних за вашим дорученням. Просто напишіть, що вам потрібно, звичайним реченням:

Огляд розмов

  • "Покажи мені розмови за останній тиждень."

  • "Підсумуй цю розмову в трьох реченнях."

  • "Які розмови досі відкриті?"

Статистика

  • "Скільки нових розмов у нас було минулого тижня?"

  • "Розбий нові розмови за днями."

Контакти

  • "Знайди контакт з ел. поштою jan@example.com."

  • "Які теги має цей клієнт?"

Теги

  • "Познач цю розмову тегом Complaint."

  • "Створи новий тег із назвою VIP."

Керування розмовами

  • "Признач цю розмову агенту Marie."

  • "Закрий цю розмову."

Відповіді в чат

  • "Надішли в цю розмову: Дякуємо за терпіння, ми вже працюємо над цим."

💡 Ідеї для спроб: ранковий дайджест ("Підсумуй учорашні розмови й виділи ті, які потребують відповіді") або швидкий звіт ("Порівняй кількість нових розмов цього тижня та минулого тижня").


Корисно знати

  • Gemini працює з вашими реальними даними Smartsupp. Ви підтверджуєте доступ, виконуючи вхід (OAuth) — Gemini ніколи не бачить ваш пароль.

  • Читання (огляди, статистика, контакти) доступне повністю. Дії (відповіді, теги, призначення) виконуються лише тоді, коли ви про це просите — і Gemini спершу просить вас підтвердити їх виконання.

  • Переключення облікових записів Smartsupp: закрийте Gemini, видаліть папку ~/.mcp-auth (виконайте rm -rf ~/.mcp-auth), знову запустіть Gemini і увійдіть з іншим обліковим записом.


Усунення несправностей

  • Помилка 401, коли ви починаєте спілкування: Gemini CLI читає файл .env з тієї папки, з якої ви його запускаєте. Якщо в цій папці є свій .env без змінної GEMINI_API_KEY, ключ не буде використано. Додайте ключ також у цей файл або запускайте Gemini з домашньої папки.

  • smartsupp показує Disconnected: введіть /mcp auth smartsupp у Gemini. Якщо це не допоможе, видаліть ~/.mcp-auth і спробуйте ще раз.

  • npm install завершується з помилкою доступу (EACCES): пропустіть встановлення і запустіть Gemini безпосередньо за допомогою npx @google/gemini-cli.


Що далі?

💡 Потрібна додаткова допомога? Зв’яжіться з нашою службою підтримки — ми будемо раді допомогти!

Ви отримали відповідь на своє запитання?