Ir al contenido principal

Conecte Smartsupp con Google Gemini

Conecte su cuenta de Smartsupp con Google Gemini y trabaje con sus datos del chat usando frases normales.

Conecte Smartsupp con Google Gemini y trabaje con sus datos del chat en vivo simplemente preguntando. En lugar de hacer clic por el panel, escribe una frase normal — Gemini encuentra la información, la resume o realiza la acción por usted.

Gemini no tiene una sección de conectores en su aplicación web (a diferencia de ChatGPT o Claude), así que la conexión funciona a través de Gemini CLI — una aplicación oficial gratuita de Google que se ejecuta en la terminal. No se preocupe si nunca ha usado una terminal: la configuración son unos pocos comandos de copiar y pegar y solo se hace una vez.

Hemos dividido el artículo en varias secciones:


Antes de empezar

Necesitará:

  • Node.js 20 o más reciente instalado en su ordenador. Compruébelo ejecutando node -v en la terminal, o descárguelo en nodejs.org.

  • Una cuenta de Google para crear una clave API de Gemini gratuita. A diferencia de ChatGPT, no necesita ningún plan de pago.

  • Sus datos de acceso a Smartsupp — durante la configuración iniciará sesión en su cuenta de Smartsupp para aprobar la conexión.


Configurar la conexión

1. Instale Gemini CLI. Abra su terminal (en Mac: aplicación Terminal, en Windows: PowerShell) y ejecute:

npm install -g @google/gemini-cli

2. Cree su clave API de Gemini. Vaya a Google AI Studio, inicie sesión con su cuenta de Google y haga clic en Create API key. Copie la clave — la necesitará en el siguiente paso.

3. Guarde la clave API. Ejecute este comando en su terminal (sustituya your-key-here por la clave copiada):

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

4. Añada la conexión con Smartsupp. Abra el archivo ~/.gemini/settings.json en cualquier editor de texto (créelo si no existe) y pegue:

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

5. Inicie Gemini. Ejecute gemini en su terminal. Si le pregunta cómo quiere iniciar sesión, elija Use Gemini API Key.

6. Compruebe la conexión. Dentro de Gemini, escriba /mcp. Debería ver:

🟢 smartsupp – Ready (19 tools)

7. Autorice la conexión. La primera vez que pregunte por sus datos de Smartsupp, se abrirá una página de inicio de sesión de Smartsupp en su navegador. Al iniciar sesión aprueba el acceso — Gemini nunca ve su contraseña de Smartsupp.

⚠️ Nota: La autorización usa automáticamente la cuenta de Smartsupp con la que está conectado en su navegador. Si gestiona más de una cuenta de Smartsupp, compruebe antes de autorizar que está conectado a la correcta.

8. Compruebe que funciona. Pruebe una petición sencilla, por ejemplo "Enumera todos los agentes de mi cuenta de Smartsupp." Si Gemini responde con su lista de agentes, la conexión está funcionando.


Qué puede hacer

Una vez conectado, Gemini puede leer sus datos de Smartsupp y gestionar su bandeja de entrada según sus instrucciones. Simplemente escriba lo que necesita como una frase normal:

Resumen de conversaciones

  • "Muéstrame las conversaciones de la última semana."

  • "Resume esta conversación en tres frases."

  • "¿Qué conversaciones siguen abiertas?"

Estadísticas

  • "¿Cuántas conversaciones nuevas tuvimos la semana pasada?"

  • "Desglosa las conversaciones nuevas día por día."

Contactos

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

  • "¿Qué etiquetas tiene este cliente?"

Etiquetas

  • "Etiqueta esta conversación con Reclamación."

  • "Crea una nueva etiqueta llamada VIP."

Gestión de conversaciones

  • "Asigna esta conversación a la agente Marie."

  • "Cierra esta conversación."

Respuestas al chat

  • "Envía a esta conversación: Gracias por su paciencia, ya lo estamos resolviendo."

💡 Ideas para probar: Un resumen matutino ("Resume las conversaciones de ayer y destaca las que necesitan respuesta") o un informe rápido ("Compara el número de conversaciones nuevas de esta semana y la anterior").


Conviene saber

  • Gemini trabaja con sus datos reales de Smartsupp. Usted aprueba el acceso iniciando sesión (OAuth) — Gemini nunca ve su contraseña.

  • La lectura (resúmenes, estadísticas, contactos) está totalmente disponible. Las acciones (respuestas, etiquetas, asignaciones) solo se realizan cuando usted las pide — y Gemini le pide confirmación antes de ejecutarlas.

  • Cambiar de cuenta de Smartsupp: cierre Gemini, elimine la carpeta ~/.mcp-auth (ejecute rm -rf ~/.mcp-auth), inicie Gemini de nuevo e inicie sesión con la otra cuenta.


Cuando algo no funciona

  • Error 401 al empezar a chatear: Gemini CLI lee el archivo .env de la carpeta desde la que lo ejecuta. Si esa carpeta tiene su propio .env sin GEMINI_API_KEY, la clave no se carga. Añada la clave también a ese archivo o inicie Gemini desde su carpeta personal.

  • smartsupp aparece como Disconnected: escriba /mcp auth smartsupp dentro de Gemini. Si no ayuda, elimine ~/.mcp-auth e inténtelo de nuevo.

  • npm install falla con un error de permisos (EACCES): omita la instalación y ejecute Gemini directamente con npx @google/gemini-cli.


¿Qué sigue?

💡 ¿Necesita más ayuda? Contact our equipo de soporte — ¡estaremos encantados de ayudarle!

¿Ha quedado contestada tu pregunta?