salesforce

O plugin salesforce integra o Salesforce CLI ao Claude Code, fornecendo autenticação de org e um agente CLI de uso geral capaz de executar qualquer comando sf, incluindo consultas SOQL. Ele suporta ambientes de contêiner sem interface gráfica com fluxos de autenticação JWT, access-token e SFDX URL. O guia de uso abaixo demonstra como utilizar linguagem natural para consultar contas, oportunidades, casos e contatos por meio do agente CLI.

v1.0.0 Development

Instalação

/plugin install salesforce@f5-sales-demo-marketplace

Pré-requisitos

• Salesforce CLI (@salesforce/cli)
• Org do Salesforce com acesso à API
• Uma conta de usuário com permissões para consultar objetos (Cases, Opportunities, Accounts, Contacts)

Instale o Salesforce CLI em sua estação de trabalho:

brew install sf

Verifique a instalação:

sf --version

Você deverá ver uma saída como @salesforce/cli/2.x.x.

Configuração de Autenticação

Etapa 1: Encontre seu domínio Salesforce

Verifique a URL do Salesforce no navegador. Se você acessa o Salesforce em https://example-corp.lightning.force.com, seu domínio de login é https://example-corp.my.salesforce.com.

Dica

Se sua empresa utiliza SSO, você deve especificar seu domínio personalizado com --instance-url para que o login seja redirecionado pelo seu provedor de SSO em vez da página de login genérica do Salesforce.

Etapa 2: Autentique via navegador

sf org login web --alias my-org --set-default --instance-url https://YOUR-DOMAIN.my.salesforce.com

Substitua YOUR-DOMAIN pelo domínio da sua empresa obtido na Etapa 1. Seu navegador será aberto — conclua o fluxo de SSO ou login e autorize o aplicativo. Você deverá ver:

Successfully authorized your-email@example.com with org ID 00DXXXXXXXXXXXXXXX

Etapa 3: Verifique a conexão

sf org display --target-org my-org

Confirme que a saída exibe Connected Status: Connected com seu nome de usuário e URL da instância.

Etapa 4: Autenticação portátil para contêineres (opcional)

Se precisar autenticar em um ambiente sem interface gráfica (CI/CD, contêiner, sessão remota), exporte a SFDX auth URL da sua estação de trabalho:

sf org display --verbose --target-org my-org

Copie o valor de Sfdx Auth Url (começa com force://). No contêiner, execute:

export SFDX_AUTH_URL="force://PlatformCLI::YOUR_AUTH_TOKEN@example.com"
echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin=- --alias=my-org --set-default

Cuidado

A SFDX auth URL é uma credencial — trate-a como uma senha. Não a inclua em arquivos ou cole em conversas. Utilize apenas variáveis de ambiente e pipes de stdin.

Referência dos métodos de autenticação

Método	Melhor para	Requer
Web Login	Estações de trabalho com navegador	Navegador + SSO
SFDX URL	Contêineres, CI/CD, autenticação portátil	Auth URL de uma sessão autenticada
JWT Bearer	Pipelines automatizados	Connected App + chave privada + chave do consumidor
Access Token	Autenticação por variável de ambiente	SF_ACCESS_TOKEN + SF_ORG_INSTANCE_URL

Observação: O fluxo de dispositivo (sf org login device) está bloqueado desde agosto de 2025 e não é suportado.

Variáveis de ambiente

Variável	Finalidade
SF_ACCESS_TOKEN	Token Bearer para autenticação por access-token
SFDX_AUTH_URL	Force auth URL para autenticação SFDX URL
SF_ORG_INSTANCE_URL	URL da instância da org
SF_JWT_KEY_FILE	Caminho para a chave privada JWT
SF_CLIENT_ID	Chave do consumidor do Connected App
SF_USERNAME	Nome de usuário do Salesforce para JWT

Comandos

/salesforce:sf-status

Verifique o status de conexão da sua org Salesforce, a versão do CLI e as orgs autenticadas.

/salesforce:sf-status

O que esperar: Uma tabela mostrando a versão do sf CLI, alias da org autenticada, nome de usuário, URL da instância, status de conexão e versão da API.

/salesforce:sf-login

Autentique em uma org Salesforce. Opcionalmente, forneça um alias.

/salesforce:sf-login
/salesforce:sf-login my-org

O que esperar: Se uma org com esse alias já estiver autenticada, o comando reporta os detalhes da conexão. Caso contrário, verifica as credenciais disponíveis (variáveis de ambiente) e autentica usando o primeiro método completamente satisfeito.

Skills

salesforce-index

Roteador de intenção de nível superior. Ativa automaticamente quando você menciona Salesforce, gerenciamento de org ou consultas de dados em linguagem natural.

Você diz	Roteia para
”login to salesforce”, “authenticate org”	skill salesforce-auth
”check org status”, “list orgs”	agente cli-operator
”show me opportunities”, “look up case”	agente cli-operator (consulta SOQL)
“generate Apex class”, “create Flow”	skills de desenvolvimento afv-library

salesforce-auth

Skill de autenticação adaptada para contêineres. Suporta quatro métodos de autenticação e detecta automaticamente quais credenciais estão disponíveis. Prioridade: access-token, depois JWT, depois SFDX URL, depois web login.

Agentes

cli-operator

Agente autônomo do Salesforce CLI que executa comandos sf com proteções de segurança. Todas as operações do Salesforce são delegadas a este agente para manter o contexto da sessão principal enxuto.

Regras de segurança:

• Somente leitura por padrão — operações de escrita requerem aprovação explícita
• Nunca realiza deploy sem uma etapa de pré-visualização e confirmação
• Nunca exibe access tokens, auth URLs ou credenciais na saída
• Sanitiza todos os valores fornecidos pelo usuário (rejeita metacaracteres de shell)
• Usa saída --json para resultados estruturados e analisáveis

Formato de resposta:

## Result: [SUCCESS | FAILURE | PARTIAL]
### Command Executed
### Output Summary
### Issues

Guia de Uso: Gerenciamento de Contas

Nota

Os prompts abaixo não são recursos codificados diretamente no plugin. Eles funcionam porque o agente cli-operator pode executar qualquer comando sf CLI, incluindo consultas SOQL arbitrárias. Os resultados dependem do modelo de dados da sua org e das suas permissões de usuário. Os prompts aqui foram testados e verificados para funcionar com objetos padrão do Salesforce (Account, Contact, Case, Opportunity, AccountTeamMember, OpportunityTeamMember).

Esses prompts funcionam com qualquer org do Salesforce. Substitua os valores de espaço reservado pelas suas próprias informações. Cada prompt produz resultados específicos para o seu perfil, contas e território.

Dica

Para melhores resultados, inclua seu endereço de e-mail nos prompts que precisam identificar seu registro de usuário. Orgs do Salesforce podem ter vários usuários com nomes semelhantes.

Primeiros passos

Após autenticar, verifique se tudo está funcionando:

/salesforce:sf-status

Em seguida, experimente uma consulta simples em linguagem natural:

list my authenticated salesforce orgs

O que esperar: Uma tabela mostrando todas as orgs conectadas com alias, nome de usuário, URL da instância e status de conexão.

Encontre suas contas

Descubra quais contas você está atribuído:

what salesforce accounts am I on the account team for? My email is your-email@example.com

O que esperar: Uma lista de contas agrupadas por proprietário da conta, mostrando seu papel como membro da equipe em cada uma. Se a maioria dos papéis aparecer em branco, isso é uma lacuna comum de higiene de dados — as associações de equipe de conta existem, mas os papéis não foram preenchidos.

Verifique cobertura com um colega

Compare sua cobertura de contas com a de um colega para identificar lacunas:

In salesforce, find all accounts where Colleague Name is on the account team. Then for each of those accounts, check if your-email@example.com is also on the account team. Show me two lists: accounts where we are BOTH tagged, and accounts where only my colleague is tagged but I am missing.

O que esperar: Uma tabela resumida mostrando a contagem de sobreposição e a contagem de lacunas, seguida de duas listas. Se você mudou de função recentemente, pode encontrar zero sobreposição — isso revela quais contas você precisa ser adicionado.

Nota

Você também pode verificar um antecessor adicionando: “Also check if Previous Person Name appears on any of those accounts.” Isso ajuda a identificar lacunas de transição ao substituir alguém em um território.

Visão geral do pipeline do território

Veja todas as oportunidades abertas em suas contas:

show me all open salesforce opportunities on Colleague Name's account team accounts, sorted by close date, include the stage, amount, and probability

O que esperar: Um resumo com contagem total de oportunidades, pipeline bruto e pipeline ponderado. Em seguida, uma tabela de distribuição por estágio e uma lista das principais oportunidades por valor. A saída sinaliza problemas de higiene de dados como datas de fechamento vencidas ou valores nulos.

Análise detalhada de oportunidade

Obtenha a visão completa de um negócio específico:

show me a detailed view of the OPPORTUNITY NAME opportunity in salesforce - include the opportunity team members, any activities or tasks, and the account contacts

O que esperar: A visão geral da oportunidade (estágio, valor, data de fechamento, probabilidade, categoria de previsão, proprietário), membros da equipe de oportunidade com funções, contatos associados, tarefas e eventos recentes, e histórico de alterações de campos mostrando como o valor e a data de fechamento do negócio evoluíram ao longo do tempo.

Casos de suporte em todo o território

Verifique os casos de suporte abertos em suas contas:

show me all open salesforce cases across Colleague Name's account team accounts, grouped by account, sorted by most recent first

O que esperar: Uma contagem de casos abertos com detalhamento por prioridade e status, seguida dos detalhes dos casos agrupados por conta. Casos antigos (com meses ou anos de inatividade) são sinalizados como candidatos a higienização.

Previsão de pipeline trimestral

Obtenha uma visão do pipeline pronta para previsão:

for Colleague Name's accounts, show me a quarterly pipeline summary - group the open opportunities by close date quarter with count, total amount, and weighted amount for each quarter

O que esperar: Uma tabela com uma linha por trimestre mostrando contagem de oportunidades, pipeline total e pipeline ponderado. Inclui um detalhamento da composição de estágios por trimestre e destaca os principais negócios ponderados. Oportunidades vencidas são agrupadas separadamente.

Visão geral completa da conta

Análise aprofundada de um cliente específico:

give me a full account overview for ACCOUNT NAME in salesforce including contacts, open opportunities, and recent cases

O que esperar: Perfil da empresa (setor, receita, funcionários, localização), contatos-chave com títulos e e-mail, oportunidades abertas com estágios e valores, e casos de suporte recentes com status.

Consulta de caso

Pesquise um caso de suporte específico pelo número:

look up salesforce case CASE-NUMBER and show me the case details, the customer account, and who owns it

O que esperar: Assunto do caso, status, prioridade, descrição, o perfil da conta do cliente e o proprietário do caso com informações de contato.

Guia de Uso: Consultas de Dados

Para usuários avançados, você pode solicitar consultas no estilo SOQL em linguagem natural. O plugin traduz sua solicitação para o SOQL apropriado e o executa.

Campos específicos

query salesforce for all Contacts at ACCOUNT NAME - show Name, Title, Email, Phone, and Department

Filtragem por data

show me all salesforce opportunities that closed won in the last 90 days on ACCOUNT NAME

Agregação

count all open salesforce cases grouped by priority and status across my accounts

Objetos personalizados

query the CUSTOM_OBJECT__c object in salesforce for records where Status__c = 'Active'

Dica

Se uma consulta falhar porque um campo não existe, o plugin tenta novamente automaticamente sem esse campo. Campos personalizados na sua org podem ter nomes diferentes — verifique a Configuração do Salesforce se um campo não for encontrado.

Skills de Desenvolvimento

As 30 skills de desenvolvimento do Salesforce da forcedotcom/afv-library são ativadas automaticamente para tarefas de Apex, Flow, LWC, SOQL, metadados, Agentforce e implantação. Instale-as separadamente:

npx skills add forcedotcom/afv-library

Tópico	Skill
Classes e serviços Apex	generating-apex
Testes Apex	generating-apex-test
Flows	generating-flow
LWC e pacotes de UI	building-ui-bundle-app
Objetos personalizados	generating-custom-object
Campos personalizados	generating-custom-field
Regras de validação	generating-validation-rule
Conjuntos de permissões	generating-permission-set
FlexiPages	generating-flexipage
Agentes Agentforce	developing-agentforce
Testes Agentforce	testing-agentforce
Implantação	deploying-ui-bundle
Migração SLDS2	uplifting-components-to-slds2
Refatoração de triggers	trigger-refactor-pipeline