Passar para o conteúdo principal

Conectar Smartsupp ao Google Gemini

Conecte sua conta Smartsupp ao Google Gemini e use seus dados do chat ao vivo com comandos em linguagem natural.

Escrito por Michal Jindra

Conecte o Smartsupp ao Google Gemini e trabalhe com os dados do seu chat ao vivo apenas escrevendo o que você precisa. Esqueça o trabalho de ficar procurando no painel — basta digitar normalmente e o Gemini encontra a informação, resume ou executa ações pra você.

O Gemini não tem uma seção de conectores no app web (diferente do ChatGPT ou Claude), então a integração é feita pelo Gemini CLI — um aplicativo oficial e gratuito do Google que você executa no terminal. Se nunca usou um terminal, não tem problema: é só copiar e colar alguns comandos e pronto, você só faz isso uma vez.

Dividimos este guia em algumas partes:


Antes de começar

Você vai precisar de:

  • Node.js 20 ou superior instalado no seu computador. Confira digitando node -v no terminal, ou baixe em nodejs.org.

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

  • Seus dados de login do Smartsupp — durante a configuração, você vai acessar sua conta Smartsupp para aprovar a conexão.

🟡 Requisito: O servidor Smartsupp MCP está disponível no plano Plus ou superior.


Configurar a conexão

1. Instale o Gemini CLI. Abra o terminal (no Mac: aplicativo Terminal; no Windows: PowerShell) e digite:

npm install -g @google/gemini-cli

2. Gere sua chave de API Gemini. Entre em Google AI Studio, faça login com sua conta Google e clique em Criar chave API. Copie a chave — você vai usar no próximo passo.

3. Salve a chave da API. No terminal, digite este comando (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 um editor de texto (crie se 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. Digite gemini no terminal. Se perguntar como você quer fazer login, escolha Usar Gemini API Key.

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

🟢 smartsupp – Pronto (19 ferramentas)


​7. Autorize a conexão. Na primeira vez que você pedir algo sobre seus dados do Smartsupp, uma tela de login vai abrir no navegador. Faça login para liberar o acesso — ao fazer isso, você autoriza a conexão, e o Gemini nunca tem acesso à sua senha.

⚠️ Atenção: A autorização usa a conta Smartsupp que já está logada no seu navegador. Se você acessa mais de uma conta Smartsupp, confira se está na certa antes de liberar o acesso.

8. Veja se deu certo. Peça algo simples, como "Listar todos os agentes da minha conta Smartsupp." Se o Gemini responder com a lista de agentes, está tudo funcionando!


O que você pode fazer

Depois de conectar, o Gemini pode acessar os dados do seu Smartsupp e gerenciar sua caixa de entrada do jeito que você pedir. É só digitar normalmente o que você quer fazer:

  • "Resumir as conversas de ontem e mostrar quais ainda precisam de resposta."

  • "Quais conversas ainda estão abertas?"

  • "Quantas novas conversas tivemos na semana passada em comparação com a anterior?"

Alguns usos comuns (com exemplos de comandos):

⚠️ Respostas e ações são de verdade. Uma mensagem enviada pelo seu assistente de IA aparece direto no chat do cliente e fechar, atribuir ou marcar conversas muda a caixa de entrada de toda a equipe. Sempre leia com atenção o que o assistente vai fazer antes de confirmar, principalmente ao agir em várias conversas de uma vez.

💡 Mais exemplos, o que permanece no Smartsupp e como seus dados são tratados: Trabalhe com sua caixa de entrada do Smartsupp pelo seu assistente de IA.


Bom saber

  • O Gemini acessa seus dados reais do Smartsupp. O acesso é liberado quando você faz login (OAuth) — o Gemini não vê sua senha.

  • Ler (visão geral, estatísticas, contatos) está sempre liberado. Ações (responder, marcar, atribuir) só acontecem quando você pedir — e o Gemini sempre confirma antes de executar.

  • Para trocar de conta Smartsupp: feche o Gemini, apague a pasta ~/.mcp-auth (digite rm -rf ~/.mcp-auth), reabra o Gemini e faça login na outra conta.


Solução de problemas

  • Erro 401 ao iniciar o chat: O Gemini CLI procura o arquivo .env na pasta em que foi executado. Se essa pasta tiver seu próprio .env sem o GEMINI_API_KEY, a chave não é carregada. Adicione a chave nesse arquivo também ou inicie o Gemini a partir da sua pasta pessoal.

  • smartsupp aparece como Desconectado: digite /mcp auth smartsupp dentro do Gemini. Se não funcionar, apague ~/.mcp-auth e tente de novo.

  • npm install dá erro de permissão (EACCES): pule a instalação e rode o Gemini usando npx @google/gemini-cli.


E agora?

💡 Precisa de mais ajuda? Fale com a nossa equipe de suporte — estamos por aqui pra ajudar você!

Respondeu à sua pergunta?