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

Свързване на 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. Уверете се, че работи. Изпробвайте проста заявка, например „List all agents on my Smartsupp account.“ Ако Gemini отговори със списък на Вашите агенти, свързването работи коректно.

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

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

Преглед на разговори

  • „Show me the conversations from the last week.“

  • „Summarize this conversation in three sentences.“

  • „Which conversations are still open?“

Статистика

  • „How many new conversations did we have last week?“

  • „Break down the new conversations day by day.“

Контакти

  • „Find the contact with the email jan@example.com.“

  • „What tags does this customer have?“

Тагове

  • „Tag this conversation with Complaint.“

  • „Create a new tag called VIP.“

Управление на разговори

  • „Assign this conversation to the agent Marie.“

  • „Close this conversation.“

Отговори в чата

  • „Send to this conversation: Thank you for your patience, we're on it.“

💡 Идеи за изпробване: сутрешен дайджест („Summarize yesterday's conversations and highlight the ones that need a reply“), или кратък отчет („Compare the number of new conversations this week and last week“).

Полезна информация

  • 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.

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

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

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