Към основното съдържание

Свържете Smartsupp с Google Gemini

Свържете акаунта си в Smartsupp с Google Gemini и работете с данните от чата на живо чрез заявки на естествен език.

Написано от Michal Jindra

Свържете Smartsupp с Google Gemini и работете с данните от чата на живо само като задавате заявки. Вместо да щраквате из таблото за управление, напишете обикновено изречение — Gemini намира информацията, обобщава я или извършва действието вместо Вас.

Gemini няма секция за конектори в уеб приложението си (за разлика от ChatGPT или Claude), затова свързването се осъществява чрез Gemini CLI — безплатно официално приложение на Google, което работи в терминала. Не се притеснявайте, ако досега не сте използвали терминал: настройката изисква само няколко команди, които да копирате и поставите, и се прави еднократно.

Разделихме статията на няколко секции:

Преди да започнете

Ще Ви трябват:

  • Node.js 20 или по-нова версия инсталирана на компютъра Ви. Проверете, като изпълните node -v в терминала, или я изтеглете от nodejs.org.

  • Акаунт в Google за създаване на безплатен API ключ за Gemini. За разлика от ChatGPT, не Ви е необходим платен план.

  • Данните Ви за вход в Smartsupp — по време на настройката ще влезете в акаунта си в Smartsupp, за да одобрите връзката.

🟡 Изискване: MCP сървърът на Smartsupp е наличен с план PLUS и по-високите планове.

Настройте връзката

1. Инсталирайте Gemini CLI. Отворете терминала (на Mac: приложението Terminal, на Windows: PowerShell) и изпълнете:

npm install -g @google/gemini-cli

2. Създайте своя API ключ за Gemini. Отидете в Google AI Studio, влезте с акаунта си в Google и щракнете върху Създаване на API ключ. Копирайте ключа — ще Ви трябва в следващата стъпка.

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 в терминала. Ако Ви попита как искате да влезете, изберете Използване на API ключ за Gemini.

6. Проверете връзката. В Gemini въведете /mcp. Трябва да видите:

🟢 smartsupp – Ready (19 tools)


​7. Разрешете връзката. Когато за първи път зададете въпрос за данните си в Smartsupp, в браузъра Ви се отваря страница за вход в Smartsupp. Влезте, за да одобрите достъпа — одобрявате връзката чрез влизане в акаунта, а Gemini никога не вижда паролата Ви за Smartsupp.

⚠️ Забележка: При разрешаването автоматично се използва акаунтът в Smartsupp, в който сте влезли в момента в браузъра си. Ако управлявате повече от един акаунт в Smartsupp, проверете внимателно дали сте влезли в правилния, преди да разрешите връзката.

8. Уверете се, че работи. Опитайте с проста заявка, например "Избройте всички оператори в моя акаунт в Smartsupp." Ако Gemini отговори със списъка на операторите Ви, връзката е установена и работи.

Какво можете да правите

След свързването Gemini може да чете данните Ви в Smartsupp и да управлява Вашия Inbox по Ваши указания. Просто напишете какво Ви е необходимо като обикновено изречение:

  • "Обобщете вчерашните разговори и откройте тези, които все още се нуждаят от отговор."

  • "Кои разговори все още са отворени?"

  • "Колко нови разговора имахме миналата седмица в сравнение с предходната?"

Типични приложения (с примерни заявки):

⚠️ Отговорите и действията са реални. Съобщението, което изпращате чрез своя AI асистент, се появява в чата на клиента, а затварянето, възлагането или добавянето на тагове променя Inbox за целия Ви екип. Прочетете какво възнамерява да направи асистентът Ви, преди да го изпълни, особено когато обработва много разговори едновременно.

💡 Още примерни заявки, какво остава в Smartsupp и как се обработват данните Ви: Работете с Вашия Inbox в Smartsupp чрез своя AI асистент.

Полезно е да знаете

  • Gemini работи с Вашите реални данни в Smartsupp. Одобрявате достъпа чрез влизане в акаунта (OAuth) — Gemini никога не вижда паролата Ви.

  • Четенето (прегледи, статистика, контакти) е напълно достъпно. Действията (отговори, тагове, възлагания) се извършват само когато ги поискате — и Gemini Ви пита за потвърждение, преди да ги изпълни.

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

Отстраняване на проблеми

  • Грешка 401, когато започнете да чатите: Gemini CLI чете файла .env от папката, в която го стартирате. Ако тази папка има собствен файл .env без GEMINI_API_KEY, ключът не се разпознава. Добавете ключа и в този файл или стартирайте Gemini от домашната си папка.

  • smartsupp показва „Няма връзка“: въведете /mcp auth smartsupp в Gemini. Ако това не помогне, изтрийте ~/.mcp-auth и опитайте отново.

  • npm install завършва с грешка за права за достъп (EACCES): пропуснете инсталацията и стартирайте Gemini директно с npx @google/gemini-cli.

Какво следва?

💡 Нуждаете се от още помощ? Свържете се с нашия Екип за поддръжка — с радост ще Ви помогнем!

Свързани статии
Това отговори ли на въпроса ви?