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.
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.
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.
3. Escolha Adicionar de um repositório e digite:
Ploomes/construtor-ploomes-plugin
4. Clique em Usar "Ploomes/construtor-ploomes-plugin".
5. Na aba Descobrir, o plugin aparece como Construtor Ploomes. Clique em Adicionar.
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 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.
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.
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:
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.
Clique no </>.
Na dúvida, passe o mouse sobre os ícones: o nome de cada um aparece.
5) Escolhendo a pasta do plugin
Ainda na aba Code, comece uma sessão nova.
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.
Ao lado do seletor de pasta, deixe o ambiente em Local, que é o seu computador.
6) Conectando a sua conta Ploomes
6.1) Copie a chave do usuário de integração
No Ploomes, acesse Administração no menu lateral.
Clique em Usuários de integração.
Clique no usuário de integração com o perfil Administrador.
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.
6.2) Cole a chave na página de login
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.Cole a chave no campo User-Key e clique em Conectar.
Quando aparecer Conta conectada, volte à conversa e peça de novo.
❗ 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.
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.














