Conecte o Smartsupp ao Google Gemini e aceda rapidamente aos dados do chat ao vivo apenas fazendo perguntas. Em vez de navegar pelo painel de controlo, basta escrever uma frase simples — o Gemini encontra a informação, resume ou executa a ação para si.

O Gemini ainda não possui uma secção de conectores na sua aplicação web (ao contrário do ChatGPT ou Claude), por isso a ligação é feita através do Gemini CLI — um aplicativo oficial e gratuito da Google executado no terminal. Não se preocupe se nunca utilizou um terminal: o processo requer apenas alguns comandos simples de copiar e colar, feitos apenas uma vez.

Este artigo está organizado em secções:

Antes de começar
Como configurar a ligação
O que pode fazer
Informações úteis
Como resolver problemas
E agora?

Antes de começar

Vai precisar de:

Node.js 20 ou superior instalado no seu computador. Verifique executando node -v no terminal, ou transfira em nodejs.org.
Uma conta Google para criar uma chave de API Gemini gratuita. Ao contrário do ChatGPT, não é necessário nenhum plano pago.
Os seus dados de login do Smartsupp — durante a configuração vai iniciar sessão na sua conta Smartsupp para aprovar a ligação.

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

Como configurar a ligaçã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. Criar a sua chave de API Gemini. Aceda ao Google AI Studio, inicie sessão com a sua conta Google e clique em Criar chave de API. Copie a chave — vai precisar dela no próximo passo.

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

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

4. Adicionar a ligação do Smartsupp. Abra o ficheiro ~/.gemini/settings.json em qualquer editor de texto (crie-o 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. Iniciar o Gemini. Execute gemini no terminal. Se lhe for perguntado como pretende iniciar sessão, selecione Usar chave de API Gemini.

6. Verificar a ligação. Dentro do Gemini, digite /mcp. Deve ver:

🟢 smartsupp – Pronto (19 ferramentas)

7. Autorizar a ligação. Na primeira vez que perguntar sobre os seus dados Smartsupp, será aberta uma página de login do Smartsupp no seu navegador. Inicie sessão para aprovar o acesso — a aprovação é feita ao iniciar sessão e o Gemini nunca vê a sua palavra-passe do Smartsupp.

⚠️ Nota: A autorização usa automaticamente a conta do Smartsupp na qual já está autenticado no navegador. Se gerir mais do que uma conta Smartsupp, confirme que está com a correta antes de autorizar.

8. Confirme se está tudo a funcionar. Experimente um pedido simples, por exemplo "Listar todos os agentes na minha conta Smartsupp." Se o Gemini responder com a lista dos seus agentes, a ligação está pronta e funcional.

O que pode fazer

Assim que estiver ligado, o Gemini pode ler os seus dados do Smartsupp e gerir a sua inbox conforme as suas instruções. Basta escrever o que pretende como uma frase normal:

"Resuma as conversas de ontem e destaque aquelas que ainda precisam de resposta."
"Quais conversas ainda estão abertas?"
"Quantas conversas novas tivemos na semana passada em comparação com a anterior?"

Usos típicos (com exemplos de comandos):

⚠️ Respostas e ações são reais. Uma mensagem enviada pelo seu assistente de IA chega ao chat do cliente, e fechar, atribuir ou etiquetar altera a inbox de toda a equipa. Confirme sempre o que o assistente vai fazer antes de continuar, sobretudo ao atuar em várias conversas de uma vez.

💡 Mais exemplos de comandos, o que é guardado no Smartsupp e como os seus dados são tratados: Trabalhar com a sua inbox do Smartsupp através do assistente de IA.

Informações úteis

O Gemini trabalha com os seus dados reais do Smartsupp. Aprova o acesso ao iniciar sessão (OAuth) — o Gemini nunca vê a sua palavra-passe.
Leitura (visão geral, estatísticas, contactos) está sempre disponível. Ações (responder, etiquetas, atribuir) só são executadas quando solicitado — e o Gemini pede sempre confirmação antes.
Mudar de conta Smartsupp: feche o Gemini, apague a pasta ~/.mcp-auth (execute rm -rf ~/.mcp-auth), abra novamente o Gemini e entre com outra conta.

Como resolver problemas

Erro 401 ao iniciar o chat: O Gemini CLI lê o ficheiro .env da pasta onde o executa. Se essa pasta tiver também um .env sem GEMINI_API_KEY, a chave não será carregada. Adicione a chave a esse ficheiro 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 apresenta erro de permissões (EACCES): ignore a instalação e execute o Gemini diretamente com npx @google/gemini-cli.

E agora?

Conectar o Smartsupp ao ChatGPT — o mesmo conector para utilizadores do ChatGPT.
Conectar o Smartsupp ao Claude — o mesmo conector para utilizadores do Claude.
Visão geral do painel de controlo — conheça o painel de controlo do Smartsupp e as suas áreas principais.

💡 Precisa de ajuda? Contacte a nossa equipa de suporte — teremos todo o gosto em ajudar!

Conectar o Smartsupp ao Google Gemini