Ligue o Smartsupp ao Google Gemini e trabalhe com os dados do seu chat ao vivo apenas perguntando. Em vez de clicar no painel de controlo, escreva uma frase simples — o Gemini encontra a informação, resume-a ou executa a ação por si.

O Gemini não tem uma secção de conectores na 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 que é executado no terminal. Mesmo que nunca tenha usado um terminal: a configuração são apenas alguns comandos de copiar-colar e é feita uma única vez.

Dividimos o artigo em algumas secções:

Antes de começar
Configurar a ligação
O que é possível fazer
Informações úteis
Resolução de problemas
O que se segue?

Antes de começar

Será necessário:

Node.js 20 ou mais recente instalado no computador. Verifique executando node -v no terminal ou descarregue 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 dados de login do Smartsupp — durante a configuração irá iniciar sessão na conta Smartsupp para aprovar a ligação.

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

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 chave de API Gemini. Aceda ao Google AI Studio, inicie sessão com a conta Google e clique em Create API key. Copie a chave — será necessária no passo seguinte.

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

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

4. Adicionar a ligação 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 for perguntado como pretende iniciar sessão, escolha Use Gemini API Key.

6. Verificar a ligação. Dentro do Gemini, escreva /mcp. Deverá ver:

🟢 smartsupp – Ready (19 tools)

7. Autorizar a ligação. Na primeira vez que perguntar pelos dados Smartsupp, será aberta uma página de login Smartsupp no navegador. Inicie sessão para aprovar o acesso — a ligação é aprovada ao iniciar sessão e o Gemini nunca vê a senha do Smartsupp.

⚠️ Nota: A autorização utiliza automaticamente a conta Smartsupp em que estiver com sessão iniciada no navegador. Se gerir mais do que uma conta Smartsupp, verifique cuidadosamente se a sessão está iniciada na conta correta antes de autorizar.

8. Verificar se funciona. Experimente um pedido simples, por exemplo "Listar todos os agentes na minha conta Smartsupp." Se o Gemini responder com a lista de agentes, a ligação está ativa.

O que é possível fazer

Depois de ligado, o Gemini pode ler os dados do Smartsupp e gerir a caixa de entrada mediante instruções. Basta escrever o que é necessário em frase normal:

Visão geral de conversas

"Mostrar as conversas da última semana."
"Resumir esta conversa em três frases."
"Que conversas ainda estão abertas?"

Estatísticas

"Quantas novas conversas tivemos na semana passada?"
"Dividir as novas conversas dia a dia."

Contactos

"Encontrar o contato com o email jan@example.com."
"Que etiquetas tem este cliente?"

Gestão de conversas

"Atribuir esta conversa à agente Marie."
"Fechar esta conversa."

Respostas ao chat

"Enviar para esta conversa: Obrigado pela sua paciência, estamos a tratar do assunto."

💡 Ideias a experimentar: Um resumo matinal ("Resumir as conversas de ontem e destacar as que precisam de resposta"), ou um relatório rápido ("Comparar o número de novas conversas desta semana com o da semana passada").

Informações úteis

O Gemini trabalha com os dados reais do Smartsupp. O acesso é aprovado ao iniciar sessão (OAuth) — o Gemini nunca vê a sua senha.
A leitura (visões gerais, estatísticas, contactos) está totalmente disponível. As ações (respostas, etiquetas, atribuições) só são executadas quando solicitadas — e o Gemini pede confirmação antes de as executar.
Alternar entre contas Smartsupp: feche o Gemini, apague a pasta ~/.mcp-auth (execute rm -rf ~/.mcp-auth), volte a iniciar o Gemini e inicie sessão com a outra conta.

Resolução de problemas

Erro 401 ao começar a conversar: o Gemini CLI lê o ficheiro .env da pasta onde é executado. Se essa pasta tiver o seu próprio .env sem GEMINI_API_KEY, a chave não é utilizada. Adicione a chave também a esse ficheiro ou inicie o Gemini a partir da pasta pessoal (home).
smartsupp aparece como Disconnected: escreva /mcp auth smartsupp dentro do Gemini. Se não resultar, apague ~/.mcp-auth e tente novamente.
npm install falha com um erro de permissões (EACCES): ignore a instalação e execute o Gemini diretamente com npx @google/gemini-cli.

O que se segue?

Ligar o Smartsupp ao ChatGPT — o mesmo conector para utilizadores ChatGPT.
Ligar o Smartsupp ao Claude — o mesmo conector para utilizadores Claude.
Visão geral do painel de controlo — conheça o painel de controlo Smartsupp e as suas principais secções.

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

Ligar o Smartsupp ao Google Gemini