salesforce

O plugin salesforce integra o Salesforce CLI ao Claude Code, fornecendo autenticação de org e um agente CLI de propósito geral capaz de executar qualquer comando sf, incluindo consultas SOQL. 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 através 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 do Salesforce

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

Etapa 2: Autentique-se 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 da Etapa 1. Seu navegador será aberto — conclua o fluxo de SSO ou login e autorize o aplicativo. Você deverá ver:

Successfully authorized your-email@company.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 a URL da instância.

Etapa 4: Auth portátil para contêineres (opcional)

Se você 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@your-domain.my.salesforce.com"
echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin=- --alias=my-org --set-default

Referência de 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, auth portátil	Auth URL de uma sessão autenticada
JWT Bearer	Pipelines automatizados	Connected App + chave privada + consumer key
Access Token	Auth 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 auth por access-token
`SFDX_AUTH_URL`	Force auth URL para auth por 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`	Consumer key 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 do Salesforce, a versão do CLI e as orgs autenticadas.

/salesforce:sf-status

O que esperar: Uma tabela exibindo 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-se em uma org do 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 totalmente satisfeito.

Skills

salesforce-index

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

Você diz	Encaminha 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 auth e detecta automaticamente quais credenciais estão disponíveis. Prioriza: access-token, depois JWT, depois SFDX URL e, por fim, web login.

Agentes

cli-operator

Agente autônomo do Salesforce CLI que executa comandos sf com salvaguardas 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 deploys sem uma etapa de prévia 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

Estes 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 sua função, contas e território.

Primeiros passos

Após autenticar-se, 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 em quais contas você está na equipe de conta:

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

O que esperar: Uma lista de contas agrupadas por proprietário da conta, exibindo sua função de membro da equipe em cada uma. Se a maioria das funções aparecer vazia, isso é um problema comum de higiene de dados — as associações à equipe de conta existem, mas as funções não foram preenchidas.

Cruze a cobertura com um colega

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

In salesforce, find all accounts where Colleague Name is on the account team. Then for each of those accounts, check if your-email@company.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ções e lacunas, seguida de duas listas. Se você mudou de função recentemente, pode encontrar zero sobreposições — isso revela quais contas você precisa ser adicionado.

Visão geral do pipeline do território

Veja todas as oportunidades abertas nas 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 a 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.

Detalhamento de oportunidade

Obtenha o quadro completo 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 vinculados, tarefas e eventos recentes, e histórico de alterações de campos mostrando como o valor e a data de fechamento do negócio mudaram ao longo do tempo.

Casos de suporte em todo o território

Verifique casos de suporte abertos nas 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 de prioridade e status, seguida dos detalhes dos casos agrupados por conta. Casos antigos (meses ou anos sem atividade) são sinalizados como candidatos a higiene.

Previsão de pipeline trimestral

Obtenha uma visão do seu 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 do mix de estágios por trimestre e destaca os principais negócios ponderados. Oportunidades vencidas são agrupadas separadamente.

Visão geral completa da conta

Aprofunde-se em 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 principais com cargos e e-mail, oportunidades abertas com estágios e valores, e casos de suporte recentes com status.

Consulta de caso

Consulte 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 específicas no estilo SOQL em linguagem natural. O plugin traduz sua solicitação no 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'

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 deploy. 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`
Deploy	`deploying-ui-bundle`
Migração SLDS2	`uplifting-components-to-slds2`
Refatoração de triggers	`trigger-refactor-pipeline`