Passar para o conteúdo principal

Conectar o Smartsupp ao Google Gemini

Conecte sua conta Smartsupp ao Google Gemini e trabalhe com os dados do seu chat ao vivo usando comandos em linguagem natural.

Conecte o Smartsupp ao Google Gemini e trabalhe com os dados do seu chat ao vivo apenas fazendo perguntas. Em vez de clicar pelo painel de controle, você digita uma frase simples — o Gemini encontra as informações, as resume ou executa a ação para você.

O Gemini não tem uma seção de conectores no aplicativo web (diferentemente do ChatGPT ou do Claude), então a conexão é feita pelo Gemini CLI — um aplicativo oficial e gratuito do Google que roda no terminal. Não se preocupe se você nunca usou um terminal antes: a configuração envolve alguns comandos de copiar e colar e você só precisa fazer isso uma vez.

Dividimos o artigo em algumas seções:

Antes de começar

Você vai precisar:

  • Node.js 20 ou mais recente instalado no seu computador. Verifique executando node -v no seu terminal, ou faça o download em nodejs.org.

  • Uma conta Google para criar uma chave de API do Gemini gratuita. Diferentemente do ChatGPT, você não precisa de nenhum plano pago.

  • Seus dados de login do Smartsupp — durante a configuração você fará login na sua conta Smartsupp para aprovar a conexão.

🟡 Requisito: O servidor MCP do Smartsupp está disponível no plano PLUS e superiores.

Configurar a conexão

1. Instalar o Gemini CLI. Abra o terminal (no Mac: aplicativo Terminal, no Windows: PowerShell) e execute:

npm install -g @google/gemini-cli

2. Crie sua chave de API do Gemini. Vá para Google AI Studio, faça login com sua conta Google e clique em Criar chave de API. Copie a chave — você vai precisar dela na próxima etapa.

3. Salve a chave de API. Execute este comando no seu terminal (substitua your-key-here pela chave que você copiou):

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

4. Adicione a conexão do Smartsupp. Abra o arquivo ~/.gemini/settings.json em qualquer editor de texto (crie-o se ele não existir) e cole:

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

5. Inicie o Gemini. Execute gemini no seu terminal. Se ele perguntar como você quer fazer login, escolha Usar chave de API do Gemini.

6. Verifique a conexão. Dentro do Gemini, digite /mcp. Você deve ver:

🟢 smartsupp – Ready (19 tools)


​7. Autorize a conexão. Na primeira vez que você perguntar sobre seus dados do Smartsupp, uma página de login do Smartsupp será aberta no seu navegador. Faça login para aprovar o acesso — você aprova a conexão ao fazer login, e o Gemini nunca vê sua senha do Smartsupp.

⚠️ Observação: A autorização usa automaticamente a conta do Smartsupp na qual você está logado no momento no seu navegador. Se você gerencia mais de uma conta do Smartsupp, confira se você está logado na conta correta antes de autorizar.

8. Verifique se está funcionando. Tente uma solicitação simples, por exemplo "Liste todos os agentes na minha conta Smartsupp." Se o Gemini responder com a sua lista de agentes, a conexão está ativa e funcionando.

O que você pode fazer

Depois de conectar, o Gemini pode ler seus dados do Smartsupp e gerenciar sua caixa de entrada seguindo suas instruções. É só escrever o que você precisa em uma frase normal:

Visão geral da conversa

  • "Mostre as conversas da última semana."

  • "Resuma esta conversa em três frases."

  • "Quais conversas ainda estão abertas?"

Estatísticas

  • "Quantas novas conversas nós tivemos na semana passada?"

  • "Mostre as novas conversas dia a dia."

Contatos

  • "Encontre o contato com o email jan@example.com."

  • "Quais tags este cliente tem?"

Tags

  • "Marque esta conversa com a tag Reclamação."

  • "Crie uma nova tag chamada VIP."

Gerenciamento de conversas

  • "Atribua esta conversa à agente Marie."

  • "Feche esta conversa."

Respostas no chat

  • "Envie para esta conversa: Obrigado pela sua paciência, já estamos cuidando disso."

💡 Ideias para testar: Um resumo matinal ("Resuma as conversas de ontem e destaque as que precisam de resposta"), ou um relatório rápido ("Compare o número de novas conversas desta semana com o da semana passada").

Importante saber

  • O Gemini trabalha com seus dados reais do Smartsupp. Você aprova o acesso fazendo login (OAuth) — o Gemini nunca vê a sua senha.

  • Leitura (visão geral, estatísticas, contatos) está totalmente disponível. Ações (respostas, tags, atribuições) só são executadas quando você pede — e o Gemini pede sua confirmação antes de executá-las.

  • Trocando de contas Smartsupp: feche o Gemini, exclua a pasta ~/.mcp-auth (execute rm -rf ~/.mcp-auth), inicie o Gemini novamente e faça login com a outra conta.

Solução de problemas

  • erro 401 quando você começa a conversar: o Gemini CLI lê o arquivo .env da pasta onde você o executa. Se essa pasta tiver seu próprio .env sem GEMINI_API_KEY, a chave não é carregada. Adicione a chave também nesse arquivo ou inicie o Gemini a partir da sua pasta home.

  • Smartsupp mostra Desconectado: digite /mcp auth smartsupp dentro do Gemini. Se isso não ajudar, exclua ~/.mcp-auth e tente novamente.

  • npm install falha com um erro de permissão (EACCES): pule a instalação e execute o Gemini diretamente com npx @google/gemini-cli.

O que vem depois?

💡 Precisa de mais ajuda? Entre em contato com a nossa equipe de suporte — teremos prazer em ajudar!

Artigos relacionados
Respondeu à sua pergunta?