Como instalar e usar os Complementos na Magnar
Os Complementos reúnem em um só lugar as ferramentas que a Magnar pode usar por você: plugins para arquivos, e-mail, agendas e mensageria, conectores MCP, Skills, Playbooks e Templates. Aqui você os descobre, instala e conecta as suas contas, para depois selecioná-los no chat digitando /.
Antes de começar
Inicie sessão e selecione o espaço correto: Pessoal ou a sua organização. Os complementos e as contas são administrados por usuário e por espaço: conectar a sua conta dentro de uma organização não a conecta para os demais membros.
Tenha em mãos uma conta do fornecedor com acesso aos documentos, e-mails ou agendas que você quer consultar.
Você não precisa ser administrador. Alguns fornecedores, como a Microsoft, podem exigir o consentimento do administrador da sua empresa.
O que você encontra nos Complementos
Descobrir: o catálogo de ferramentas disponíveis para instalar.
Conectores: as suas conexões MCP com serviços externos.
Plugins: os plugins que você já instalou e as contas deles.
Skills, Playbooks e Templates: acesso direto a cada um.
Instalar um plugin
Na barra lateral, abra Complementos.
Entre em Descobrir.
Use Buscar complementos para encontrar o plugin.
Clique em Instalar no cartão dele, ou abra a ficha e clique em Instalar plugin.
Para administrá-lo depois, entre em Complementos → Plugins e abra-o.
Conectar uma conta
Abra a ficha do plugin instalado.
Em Conexões, clique em Adicionar conta.
Se aparecer Acesso, escolha o nível de permissões.
Clique em Conectar conta.
Inicie sessão no fornecedor e autorize o acesso.
De volta à Magnar, confira se a conta aparece como Conectado.
Para adicionar uma segunda conta do mesmo fornecedor, repita estes passos e escolha a outra conta ao autorizar. Google Drive, OneDrive, SharePoint, Dropbox, Google Mail, Outlook, Google Calendar e Outlook Calendar aceitam várias contas.
Administrar as suas contas
Alterar o nome: em Conexões, abra o menu da conta, selecione Alterar nome, preencha Nome (opcional) e clique em Salvar. Se deixar o campo vazio, volta o nome original.
Alterar as permissões: escolha o novo nível em Acesso e depois, no menu da conta, selecione Autenticar novamente. Alterar só o seletor não aplica a mudança.
Desconectar: no menu da conta, selecione Desconectar conta. O plugin continua instalado. Para removê-lo por completo, use Remover plugin no menu do plugin.
O que cada plugin permite
Google Drive, OneDrive e Dropbox: navegar, buscar, ler e importar arquivos e pastas. O que você importa é uma cópia: os originais não são alterados.
SharePoint: escolher bibliotecas ou pastas com Escolher bibliotecas, navegar, buscar e importar documentos. As alterações posteriores no original não se refletem na cópia importada.
NetDocuments: buscar e selecionar documentos para importá-los. Tem um fluxo próprio, explicado mais abaixo.
Google Mail: buscar e ler e-mails e anexos. Com Ler, editar e enviar, a Magnar também pode organizar mensagens, preparar rascunhos e enviar e-mails. A outra opção é Somente leitura.
Outlook: buscar e ler e-mails e anexos. Escolha entre Somente leitura, Ler, editar e salvar rascunhos (sem envio) ou Ler, editar e enviar.
Google Calendar: consultar agendas, eventos, detalhes e disponibilidade. Não cria, edita nem exclui eventos.
Outlook Calendar: consultar agendas, eventos, detalhes e disponibilidade com Somente leitura, que é o acesso padrão. Com Leitura e escrita, a Magnar também pode criar, editar e excluir eventos pelo chat. É instalado e autorizado separadamente do e-mail do Outlook.
Microsoft Teams: buscar e ler conversas de chats e canais, arquivos aos quais você tem acesso e conteúdo de reuniões. Escolha entre Somente leitura, Ler e enviar mensagens —que também permite criar chats e canais, e editar ou excluir as suas próprias mensagens— ou Ler, enviar mensagens e anexar arquivos. Para anexar arquivos você não precisa instalar também o OneDrive ou o SharePoint, e cada arquivo pode ter até 10 MiB. Você precisa de uma conta Microsoft corporativa ou educacional: contas pessoais não servem. A Microsoft exige o consentimento de um administrador para ler mensagens de canais, para criar ou modificar canais e para acessar transcrições e gravações de reuniões.
Slack: consultar os endereços de e-mail dos usuários do seu espaço no Slack. É o e-mail que consta nos perfis deles: não dá acesso às caixas de entrada. O plugin tem dois níveis em Acesso, e os dois aparecem em inglês mesmo com a interface em português: Public channels, que é o nível em que ficam as conexões já existentes, e Search, private channels and direct messages. Com o segundo, a Magnar também pode buscar mensagens e arquivos e ler canais privados, mensagens diretas e conversas em grupo aos quais essa conta tenha acesso: ela não abre conversas de terceiros nem o espaço de trabalho inteiro. O acesso ampliado não é adicionado sozinho a uma conexão que você já tinha — veja o ponto seguinte.
Conectar o e-mail não conecta a agenda nem os arquivos: cada plugin é instalado e autorizado separadamente.
Slack: autorizar a conexão novamente
Para que a Magnar possa consultar os endereços de e-mail dos usuários do Slack, ou para passar ao acesso ampliado com busca, canais privados e mensagens diretas, a conexão precisa incluir essa permissão. As conexões criadas antes não a têm e não a adquirem sozinhas.
Abra Complementos → Plugins → Slack.
Em Conexões, abra a conta e, em Acesso, escolha o nível de que você precisa.
No menu de ações da conta, selecione Autenticar novamente. Você também pode fazer isso pelo cartão de conexão que aparece no chat.
Se a conta aparecer desconectada, o botão é Conectar conta.
Conclua a autorização na janela do Slack.
Enquanto você não concluir esse passo, a conexão continua funcionando com o acesso que já tinha sido concedido: alterar só o seletor não modifica as permissões.
Se você voltar para a opção Public channels, a Magnar deixa de pedir o acesso ampliado, mas isso não garante que o Slack revogue as permissões já concedidas. Se quiser cortá-las, desconecte a conta e revise o aplicativo no seu espaço do Slack.
NetDocuments
Instale o NetDocuments em Complementos → Descobrir. Depois abra Meus arquivos → Contas → NetDocuments, inicie sessão na janela do fornecedor e selecione os documentos que quer importar. O NetDocuments gerencia a própria sessão: não usa Adicionar conta.
Usar um complemento no chat
Abra uma conversa no mesmo espaço onde você instalou o complemento.
No campo da mensagem, digite /.
Digite parte do nome para filtrar as sugestões.
Selecione o plugin, conector, Skill, Playbook ou Template.
Complete a sua instrução e envie a mensagem.
Essa seleção está disponível no chat web. No app para celular, está em fase de testes.
Se você já tinha contas conectadas
A antiga seção Configurações → Conexões não existe mais: tudo agora é administrado nos Complementos. As suas contas do Google Drive, OneDrive, SharePoint, Dropbox, Gmail, Outlook e agendas passam para os plugins correspondentes. Revise as suas conexões em Complementos → Plugins: se uma conta aparecer como Conexão pendente, autorize-a novamente. As suas conexões MCP continuam funcionando e agora ficam em Complementos → Conectores.
Resultado esperado
O plugin aparece em Complementos → Plugins.
A conta mostra Conectado em vez de Conexão pendente.
Ao digitar / no chat, o complemento aparece nas sugestões e fica incorporado à mensagem.
Se algo não funcionar
Está instalado, mas não responde: falta conectar a conta ou concluir a autorização.
Não aparece ao digitar /: confira se você está no mesmo espaço onde o instalou.
A Magnar não consegue enviar um e-mail: a sua conta está com Somente leitura. Altere o Acesso e use Autenticar novamente.
A Magnar não consegue criar um evento no Outlook Calendar nem enviar uma mensagem no Teams: a sua conta está conectada com Somente leitura. Altere o Acesso e use Autenticar novamente.
A Magnar não consegue anexar um arquivo no Teams: a sua conta não está com Ler, enviar mensagens e anexar arquivos. Altere o Acesso e use Autenticar novamente. Confira também se o arquivo não passa de 10 MiB.
A Magnar não encontra o e-mail de um usuário do Slack: a sua conexão é anterior a essa permissão. Use Autenticar novamente no menu da conta.
A Magnar não encontra uma mensagem de um canal privado ou uma mensagem direta do Slack: a sua conta está conectada com Public channels. Altere o Acesso para Search, private channels and direct messages e use Autenticar novamente. Mesmo assim, a Magnar só vê as conversas às quais essa conta tem acesso no Slack.
Você alterou o acesso e continua falhando: conclua Autenticar novamente.
Você não vê certos documentos: revise as permissões dessa conta no fornecedor. No SharePoint, revise também Escolher bibliotecas.
No Teams faltam mensagens de canais, transcrições ou gravações: esses acessos exigem o consentimento de um administrador do Microsoft 365 da sua empresa.
A janela de autorização não abre: permita as janelas pop-up no seu navegador e tente novamente.
Ficou com dúvidas? Fale com a gente pelo chat que ajudamos você.
Artigos relacionados