Passar para o conteúdo principal

Como instalar o plugin do Ploomes no Claude

Instale o plugin do Ploomes no Claude para conversar com os seus dados, configurar o Ploomes e ter um suporte técnico que investiga a sua conta. Com o Estúdio IA, o Claude também constrói telas, formulários de CPQ e fluxos.

Escrito por Ploo

O plugin do Ploomes para o Claude leva o Ploomes inteiro para dentro da conversa. Ele entende como o Ploomes funciona, lê a sua conta e age nela a partir do que você pede em linguagem natural.

O que o plugin faz para qualquer cliente Ploomes

  • Conversa com os seus dados: analisa a carteira, preenche informações, migra dados de outro sistema e faz mudanças em massa, como passar os clientes de um vendedor para outro.

  • Configura o Ploomes pela conversa: você descreve o processo e o Claude monta a configuração.

    • Funis e etapas: um funil novo, com as etapas, a cor e quem pode ver.

    • Design de propostas e documentos: cria e redesenha os modelos de proposta, venda e documento da conta, com a identidade visual da sua empresa.

    • Checklists: o que preencher em cada etapa, inclusive travas, como só deixar o negócio avançar com o CNPJ do cliente preenchido.

    • Automações de funil e gerais: criar uma tarefa quando o negócio entra numa etapa, enviar um e-mail quando ele é ganho.

    • Fluxos de aprovação: pedir aprovação para propostas com desconto acima de 20% ou acima de um valor.

    • Campos e formulários: campos novos e a ordem em que aparecem para o time.

    • Formulários externos: captação de leads, solicitação de orçamento, atualização cadastral.

    • Metas: painéis de metas por vendedor, equipe ou empresa.

    • Filtros e abas com as listas que o time usa no dia a dia.

  • É o seu suporte técnico dentro da conversa: o plugin conhece o Ploomes por inteiro e investiga a sua conta para responder dúvidas complexas, explicando o que aconteceu e como resolver. Por exemplo: por que uma automação não rodou, por que um vendedor não vê um cliente, por que um campo não aparece no formulário ou quem mudou um negócio de etapa.

Com o Estúdio IA, o Claude também constrói no seu Ploomes

Com o Estúdio IA, a camada de IA do Ploomes, o plugin vai além de operar a conta: ele constrói nela. Você descreve o que precisa e o Claude entrega pronto, sem você escrever uma linha de código.

  • Telas no CRM: painéis, quadros kanban, listas e mini-aplicações sob medida para o seu processo, que entram no menu do Ploomes. É o Construtor de Telas.

  • Formulários de CPQ: o formulário de propostas, vendas e documentos montado a partir do seu modelo, com o CPQ em branco.

  • Fluxos no Ploomes Flows: integrações com outros sistemas e automações, com o Integrador Flow.

Somado ao que o plugin já faz com os dados e a configuração, o Claude passa a cuidar do Ploomes de ponta a ponta: entende a conta, ajusta a configuração e constrói o que falta.

Com o Estúdio IA, o Claude constrói telas no Ploomes

Este artigo mostra três jeitos de instalar o plugin (escolha o mais fácil para você), como conectar a sua conta Ploomes e como fazer o primeiro pedido.

1) Pré-requisitos

  • App do Claude no computador (Mac ou Windows), com um plano que inclua o Claude Code: Pro, Max, Ultra, Team ou Enterprise. O plano gratuito do Claude não inclui o Claude Code.

  • Um usuário de integração com o perfil Administrador na sua conta Ploomes, em Administração › Usuários de integração. A chave desse usuário conecta o plugin à sua conta.

  • Estúdio IA, só para construir: telas, formulários de CPQ e fluxos pedem o Estúdio IA na sua conta. Dados, configuração e suporte funcionam sem ele.

Nota: você não precisa instalar mais nada. Se o plugin não encontrar no computador o que precisa para rodar, ele baixa sozinho.

⚠️ Ainda não tem o app do Claude? Baixe em claude.com/download, instale e entre com a sua conta do Claude.

2) Instalando o plugin

Escolha um dos três jeitos. Todos chegam ao mesmo resultado.

Três jeitos de instalar o plugin do Ploomes

Opção 1: pelas Configurações do app (só cliques)

1. No app do Claude, abra as Configurações (no menu da sua conta, no canto inferior esquerdo) e vá em Personalização › Plugins.

2. Clique em Adicionar › Adicionar marketplace.

Opção 1: abra Configurações › Plugins

3. Escolha Adicionar de um repositório e digite:

Ploomes/construtor-ploomes-plugin

4. Clique em Usar "Ploomes/construtor-ploomes-plugin".

Opção 1: adicione o marketplace do Ploomes

5. Na aba Descobrir, o plugin aparece como Construtor Ploomes. Clique em Adicionar.

Opção 1: adicione o plugin

Opção 2: pedindo ao Claude (uma mensagem)

1. No canto superior esquerdo do app, clique no ícone </> para abrir a aba Code. Comece uma sessão nova, em qualquer pasta.

2. Cole a mensagem abaixo e envie:

Rode estes comandos:
/plugin marketplace add Ploomes/construtor-ploomes-plugin
/plugin install construtor-ploomes@construtor-ploomes

3. O Claude roda os dois comandos e avisa quando terminar. Se ele pedir permissão para rodar um comando, autorize.

Opção 2: peça ao Claude para instalar

Opção 3: pelo terminal

Para quem já usa o Claude Code no terminal. No Windows, o terminal é o PowerShell: abra o menu Iniciar, digite PowerShell e abra o Windows PowerShell.

1. Entre numa pasta vazia e inicie o Claude Code:

mkdir ploomes-claude
cd ploomes-claude
claude

2. Digite os dois comandos, um de cada vez:

/plugin marketplace add Ploomes/construtor-ploomes-plugin
/plugin install construtor-ploomes@construtor-ploomes

3. Na tela de detalhes do plugin, escolha Install for you (user scope).

4. Rode /reload-plugins.

Opção 3: pelo terminal

Ainda não tem o Claude Code no terminal? No macOS: curl -fsSL https://claude.ai/install.sh | bash. No Windows (PowerShell): irm https://claude.ai/install.ps1 | iex. Depois, rode claude e entre com a sua conta. O passo a passo completo está no guia oficial de instalação.

Nota: no Claude, o plugin do Ploomes aparece com o nome técnico Construtor Ploomes (construtor-ploomes). Os comandos deste artigo usam esse nome.

3) Criando a pasta do plugin

O plugin trabalha dentro de uma pasta do seu computador, onde guarda os arquivos do que você pedir. A pasta pode ficar em qualquer lugar; a sugestão é criar dentro de Documentos.

  • No Mac: abra o Finder, entre em Documentos, clique com o botão direito num espaço vazio e escolha Nova Pasta.

  • No Windows: abra o Explorador de Arquivos, entre em Documentos, clique com o botão direito num espaço vazio e escolha Novo › Pasta.

Dê à pasta o nome Ploomes no Claude.

Passo 1: crie uma pasta para o plugin

Nota: use sempre a mesma pasta. Com o Estúdio IA, cada tela ou formulário ganha uma subpasta dentro dela, e a versão oficial fica salva na sua conta Ploomes, então nada se perde se a pasta for apagada.

4) Abrindo a aba Code

O plugin funciona na aba Code do app do Claude. Para abrir:

  1. No app do Claude, olhe o canto superior esquerdo. Ali ficam dois ícones lado a lado: o balão, que é o Chat, e o </>, que é o Code.

  2. Clique no </>.

Na dúvida, passe o mouse sobre os ícones: o nome de cada um aparece.

O ícone da aba Code, no canto superior esquerdo do app

Passo 2: abra a aba Code

5) Escolhendo a pasta do plugin

  1. Ainda na aba Code, comece uma sessão nova.

  2. Embaixo da caixa de mensagem, clique no seletor de pasta e escolha Ploomes no Claude. Na primeira vez, a pasta ainda não aparece na lista: use a opção de abrir pasta e procure em Documentos.

  3. Ao lado do seletor de pasta, deixe o ambiente em Local, que é o seu computador.

Passo 3: escolha a pasta do plugin

6) Conectando a sua conta Ploomes

6.1) Copie a chave do usuário de integração

  1. No Ploomes, acesse Administração no menu lateral.

  2. Clique em Usuários de integração.

  3. Clique no usuário de integração com o perfil Administrador.

  4. Copie a chave do campo Chave da API.

Ainda não tem um usuário de integração? Clique em Novo usuário, preencha nome e e-mail e escolha o perfil Administrador. O artigo Como obter acesso à API do Ploomes mostra o processo completo.

Passo 4: copie a chave do usuário de integração

6.2) Cole a chave na página de login

  1. Faça o primeiro pedido na sessão. A página Conectar a conta da Ploomes abre ao lado da conversa (no terminal, ela abre no navegador). Se preferir conectar antes de pedir algo, rode /construtor-ploomes:conectar.

  2. Cole a chave no campo User-Key e clique em Conectar.

  3. Quando aparecer Conta conectada, volte à conversa e peça de novo.

Passo 5: conecte a sua conta

❗ Importante: a chave fica só na página de login e no plugin do seu computador. Nunca cole a chave na conversa com o Claude.

Nota: use a chave de um usuário de integração. A chave de um usuário comum muda a cada entrada no CRM Web, e o plugin para até você conectar de novo.

7) Fazendo os primeiros pedidos

Com a conta conectada, escreva o pedido em linguagem natural, como faria com um colega que conhece o Ploomes.

Com os seus dados:

  • "Quantos negócios foram ganhos neste trimestre, por vendedor?"

  • "Passe os clientes do João Silva para a Maria Souza."

  • "Importe para o Ploomes os clientes desta planilha." (anexe a planilha na conversa)

Na configuração:

  • "Crie um funil de pós-venda com as etapas Onboarding, Implantação e Acompanhamento."

  • "Redesenhe o nosso modelo de proposta com o logo e as cores da empresa."

  • "Na etapa Proposta, só deixe o negócio avançar com o CNPJ do cliente preenchido."

  • "Quando um negócio for ganho, crie uma tarefa de onboarding para o responsável."

  • "Peça aprovação do gestor para propostas com desconto acima de 20%."

No suporte:

  • "Por que a automação de boas-vindas não rodou para o cliente Acme?"

  • "Por que a Maria não consegue ver os clientes da equipe Sul?"

  • "Quem mudou este negócio de etapa ontem, e por quê?"

Com o Estúdio IA:

  • "Crie uma tela no Ploomes com os negócios abertos do mês, agrupados por etapa."

  • "Crie o formulário de CPQ do meu modelo de proposta."

  • "Crie um fluxo que avise o responsável quando um negócio ficar 7 dias parado na mesma etapa."

Telas e formulários abrem numa prévia ao lado da conversa, com o status da versão e o botão Publicar. Cada resposta vira uma versão salva na conta, e a tela só chega ao CRM quando você clica em Publicar e confirma.

Passo 6: peça o que precisar

8) Comandos do plugin

  • /construtor-ploomes:conectar: abre a página de login do Ploomes e troca a conta conectada.

  • /construtor-ploomes:status: mostra a conta conectada, a pasta e a tela ativa.

  • /construtor-ploomes:artefatos: lista as telas e os formulários de CPQ da conta.

  • /construtor-ploomes:ajuda: explica o que dá para pedir ao plugin.

9) Mantendo o plugin atualizado

Quando sair uma versão nova, o plugin avisa na conversa.

  • Instalou pelas Configurações: a atualização chega pelo marketplace, em Configurações › Plugins.

  • Instalou pedindo ao Claude ou pelo terminal: peça ao Claude "Atualize o plugin construtor-ploomes".

A versão nova vale a partir da próxima sessão.

10) Dúvidas frequentes

Preciso do Estúdio IA para usar o plugin? Não. Conversar com os dados, configurar o Ploomes e usar o plugin como suporte técnico funcionam em qualquer conta. O Estúdio IA libera a construção de telas, formulários de CPQ e fluxos.

O Claude não conseguiu instalar o plugin. Confira se a sessão está na aba Code, numa pasta do seu computador, e envie a mensagem de novo. Se persistir, use a opção 1, pelas Configurações.

Posso usar outra pasta ou apagar a pasta Ploomes no Claude? Pode, mas prefira sempre a mesma: assim é fácil continuar de onde parou. Se apagar, as telas e os formulários feitos com o Estúdio IA continuam salvos na sua conta Ploomes, e o plugin retoma a partir deles.

Como confiro se o plugin está instalado? Numa sessão nova, digite /construtor-ploomes: na caixa de mensagem: os quatro comandos do plugin aparecem na lista. Se não aparecerem, abra outra sessão, porque o plugin carrega na sessão seguinte à instalação.

A página de login diz "A Ploomes recusou essa User-Key". Copie a chave inteira de novo, sem espaço no começo ou no fim, e cole outra vez.

A página de login diz que o usuário não é administrador. O usuário de integração precisa do perfil Administrador. Ajuste o perfil em Administração › Usuários de integração.

O plugin aparece duas vezes. Ele foi instalado por mais de um jeito. Mantenha uma cópia: remova a das Configurações › Plugins ou peça ao Claude para desinstalar a outra.

Como troco a conta conectada? Rode /construtor-ploomes:conectar e confirme a troca. A página de login abre de novo para a chave da outra conta.

Leia também:


Esse artigo te ajudou? Deixe seu retorno abaixo para continuarmos sempre melhorando nossa base de conhecimento. 😊

Ficou com alguma dúvida? Não hesite em chamar o Suporte pelo chat da plataforma ou pelo e-mail suporte@ploomes.com.

Respondeu à sua pergunta?