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:

"Resume as conversas de ontem e destaca as que ainda precisam de resposta."
"Que conversas continuam abertas?"
"Quantas conversas novas tivemos na semana passada em comparação com a semana anterior?"

⚠️ As respostas e as ações são reais. Uma mensagem enviada através do seu assistente de IA chega ao chat do cliente, e fechar, atribuir ou etiquetar altera a caixa de entrada para toda a sua equipa. Leia o que o seu assistente vai fazer antes de avançar, sobretudo quando atua em muitas conversas ao mesmo tempo.

💡 Mais exemplos de pedidos, o que fica no Smartsupp e como os seus dados são tratados: Trabalhe com a sua caixa de entrada Smartsupp a partir do seu assistente de IA.

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