Passar para o conteúdo principal

Conecte o Smartsupp ao Google Gemini

Conecte sua conta Smartsupp ao Google Gemini e trabalhe com seus dados de chat ao vivo usando prompts em linguagem natural.

Escrito por Michal Jindra

Conecte o Smartsupp ao Google Gemini e trabalhe com seus dados de chat ao vivo apenas fazendo pedidos. Em vez de navegar pelo painel de controle, você digita uma frase simples — o Gemini encontra as informações, faz um resumo ou executa a ação para você.

O Gemini não tem uma seção de conectores no aplicativo web (ao contrário do ChatGPT ou do Claude), então a conexão é feita pelo Gemini CLI — um aplicativo oficial gratuito do Google que funciona no terminal. Não se preocupe se você nunca usou um terminal: a configuração envolve alguns comandos para copiar e colar, e você só precisa fazê-la uma vez.

Dividimos o artigo em algumas seções:

Antes de começar

Você vai precisar de:

  • Node.js 20 ou mais recente instalado no seu computador. Confira executando node -v no terminal ou baixe em nodejs.org.

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

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

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

Configure a conexão

1. Instale 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. Acesse Google AI Studio, entre 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 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 com o 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 terminal. Se aparecer uma pergunta sobre como você quer entrar, escolha Usar chave de API do Gemini.

6. Confira a conexão. No 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 navegador. Entre 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 Smartsupp em que você está conectado no navegador. Se você gerencia mais de uma conta Smartsupp, confira se está conectado à conta certa antes de autorizar.

8. Verifique se funciona. Faça um pedido simples, por exemplo "Liste todos os operadores da minha conta Smartsupp." Se o Gemini responder com sua lista de operadores, a conexão está funcionando.

O que você pode fazer

Depois de conectado, o Gemini pode ler seus dados do Smartsupp e gerenciar seu Inbox conforme suas instruções. Basta escrever o que você precisa em uma frase comum:

  • "Resuma as conversas de ontem e destaque as que ainda precisam de uma resposta."

  • "Quais conversas ainda estão abertas?"

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

Usos comuns (com exemplos de prompts):

⚠️ As respostas e ações são reais. Uma mensagem enviada pelo seu assistente de IA chega ao chat do cliente, e fechar, atribuir ou adicionar tags altera o Inbox para toda a equipe. Leia o que seu assistente está prestes a fazer antes de ele prosseguir, principalmente quando ele atua em várias conversas ao mesmo tempo.

💡 Mais exemplos de prompts, o que fica no Smartsupp e como seus dados são tratados: Trabalhe com seu Inbox do Smartsupp pelo seu assistente de IA.

É bom saber

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

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

  • Para trocar de conta Smartsupp: feche o Gemini, exclua a pasta ~/.mcp-auth (execute rm -rf ~/.mcp-auth), inicie o Gemini novamente e entre com a outra conta.

Solução de problemas

  • Erro 401 ao começar a conversar: O Gemini CLI lê o arquivo .env da pasta em que você o executa. Se essa pasta tiver seu próprio .env sem GEMINI_API_KEY, a chave não será reconhecida. Adicione a chave a esse arquivo também ou inicie o Gemini a partir da sua pasta pessoal.

  • smartsupp aparece como Desconectado: digite /mcp auth smartsupp no 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.

Quais são os próximos passos?

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

Artigos relacionados
Respondeu à sua pergunta?