salesforce

Il plugin salesforce integra la Salesforce CLI con Claude Code, fornendo l’autenticazione org e un agente CLI di uso generale in grado di eseguire qualsiasi comando sf, incluse le query SOQL. Supporta ambienti container headless con flussi di autenticazione JWT, access-token e SFDX URL. La guida all’utilizzo di seguito illustra come usare il linguaggio naturale per interrogare account, opportunità, casi e contatti tramite l’agente CLI.

v1.0.0 Development

Installazione

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

Prerequisiti

Salesforce CLI (@salesforce/cli)
Org Salesforce con accesso API
Un account utente con autorizzazioni per interrogare oggetti (Cases, Opportunities, Accounts, Contacts)

Installare la Salesforce CLI sulla propria workstation:

brew install sf

Verificare l’installazione:

sf --version

Dovrebbe essere visualizzato un output simile a @salesforce/cli/2.x.x.

Configurazione dell’autenticazione

Passaggio 1: Individuare il dominio Salesforce

Controllare l’URL di Salesforce nel browser. Se si accede a Salesforce tramite https://example-corp.lightning.force.com, il dominio di login è https://example-corp.my.salesforce.com.

Passaggio 2: Autenticarsi tramite browser

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

Sostituire YOUR-DOMAIN con il dominio aziendale individuato nel Passaggio 1. Il browser si aprirà — completare il flusso SSO o di login e autorizzare l’app. Dovrebbe essere visualizzato:

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

Passaggio 3: Verificare la connessione

sf org display --target-org my-org

Confermare che l’output mostri Connected Status: Connected con il proprio username e l’URL dell’istanza.

Passaggio 4: Autenticazione portabile per container (opzionale)

Se è necessario autenticarsi in un ambiente headless (CI/CD, container, sessione remota), esportare l’SFDX auth URL dalla propria workstation:

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

Copiare il valore Sfdx Auth Url (inizia con force://). Nel container, eseguire:

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

Riferimento ai metodi di autenticazione

Metodo	Ideale per	Requisiti
Web Login	Workstation con browser	Browser + SSO
SFDX URL	Container, CI/CD, autenticazione portabile	Auth URL da una sessione autenticata
JWT Bearer	Pipeline automatizzate	Connected App + chiave privata + consumer key
Access Token	Autenticazione tramite variabile d’ambiente	`SF_ACCESS_TOKEN` + `SF_ORG_INSTANCE_URL`

Nota: Il flusso device (sf org login device) è bloccato dall’agosto 2025 e non è supportato.

Variabili d’ambiente

Variabile	Scopo
`SF_ACCESS_TOKEN`	Bearer token per l’autenticazione access-token
`SFDX_AUTH_URL`	Force auth URL per l’autenticazione SFDX URL
`SF_ORG_INSTANCE_URL`	URL dell’istanza org
`SF_JWT_KEY_FILE`	Percorso alla chiave privata JWT
`SF_CLIENT_ID`	Consumer key della Connected App
`SF_USERNAME`	Username Salesforce per JWT

Comandi

/salesforce:sf-status

Verifica lo stato della connessione all’org Salesforce, la versione della CLI e le org autenticate.

/salesforce:sf-status

Cosa aspettarsi: Una tabella che mostra la versione della CLI sf, l’alias dell’org autenticata, l’username, l’URL dell’istanza, lo stato della connessione e la versione API.

/salesforce:sf-login

Autentica un’org Salesforce. È possibile fornire facoltativamente un alias.

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

Cosa aspettarsi: Se un’org con quell’alias è già autenticata, vengono riportati i dettagli della connessione. In caso contrario, vengono verificate le credenziali disponibili (variabili d’ambiente) e l’autenticazione avviene utilizzando il primo metodo completamente soddisfatto.

Skill

salesforce-index

Router degli intenti di primo livello. Si attiva automaticamente quando si menziona Salesforce, la gestione org o query sui dati in linguaggio naturale.

Si dice	Indirizza a
”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` (query SOQL)
“generate Apex class”, “create Flow”	skill di sviluppo afv-library

salesforce-auth

Skill di autenticazione adattata per container. Supporta quattro metodi di autenticazione e rileva automaticamente le credenziali disponibili. Priorità: access-token, poi JWT, poi SFDX URL, poi web login.

Agenti

cli-operator

Agente autonomo della Salesforce CLI che esegue comandi sf con misure di sicurezza. Tutte le operazioni Salesforce sono delegate a questo agente per mantenere snello il contesto della sessione principale.

Regole di sicurezza:

Sola lettura per impostazione predefinita — le operazioni di scrittura richiedono approvazione esplicita
Non esegue mai deploy senza un passaggio di anteprima e conferma
Non mostra mai token di accesso, auth URL o credenziali nell’output
Sanifica tutti i valori forniti dall’utente (rifiuta metacaratteri shell)
Utilizza l’output --json per risultati strutturati e analizzabili

Formato delle risposte:

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

Guida all’utilizzo: Gestione account

Questi prompt funzionano con qualsiasi org Salesforce. Sostituire i valori segnaposto con le proprie informazioni. Ogni prompt produce risultati specifici per il proprio ruolo, account e territorio.

Per iniziare

Dopo l’autenticazione, verificare che tutto funzioni:

/salesforce:sf-status

Quindi provare una semplice query in linguaggio naturale:

list my authenticated salesforce orgs

Cosa aspettarsi: Una tabella che mostra tutte le org connesse con alias, username, URL dell’istanza e stato della connessione.

Trovare i propri account

Scoprire a quali account si è assegnati:

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

Cosa aspettarsi: Un elenco di account raggruppati per proprietario dell’account, che mostra il proprio ruolo come membro del team su ciascuno. Se la maggior parte dei ruoli risulta vuota, si tratta di un problema comune di qualità dei dati — le appartenenze al team account esistono ma i ruoli non sono stati compilati.

Confronto della copertura con un collega

Confrontare la copertura degli account con un collega per individuare lacune:

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.

Cosa aspettarsi: Una tabella riepilogativa con il conteggio delle sovrapposizioni e delle lacune, seguita da due elenchi. Se si è cambiato ruolo di recente, potrebbe non esserci alcuna sovrapposizione — questo rivela gli account a cui è necessario essere aggiunti.

Panoramica della pipeline del territorio

Visualizzare tutte le opportunità aperte sugli account:

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

Cosa aspettarsi: Un riepilogo con il conteggio totale delle opportunità, la pipeline grezza e la pipeline ponderata. Poi una tabella di distribuzione per fase e un elenco delle principali opportunità per importo. L’output segnala problemi di qualità dei dati come date di chiusura scadute o importi nulli.

Analisi approfondita di un’opportunità

Ottenere un quadro completo su un deal specifico:

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

Cosa aspettarsi: La panoramica dell’opportunità (fase, importo, data di chiusura, probabilità, categoria previsionale, proprietario), i membri del team dell’opportunità con i ruoli, i contatti associati, le attività e gli eventi recenti e la cronologia delle modifiche ai campi che mostra come l’importo del deal e la data di chiusura siano variati nel tempo.

Casi di supporto nel territorio

Verificare i casi di supporto aperti sugli account:

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

Cosa aspettarsi: Un conteggio dei casi aperti con suddivisione per priorità e stato, seguito dai dettagli dei casi raggruppati per account. I casi inattivi (con mesi o anni senza attività) vengono segnalati come candidati alla pulizia dei dati.

Previsione della pipeline trimestrale

Ottenere una visualizzazione della pipeline pronta per le previsioni:

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

Cosa aspettarsi: Una tabella con una riga per trimestre che mostra il conteggio delle opportunità, la pipeline totale e la pipeline ponderata. Include una suddivisione del mix per fase per trimestre e mette in evidenza i deal con il maggiore peso ponderato. Le opportunità scadute vengono raggruppate separatamente.

Panoramica completa dell’account

Analisi approfondita di un cliente specifico:

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

Cosa aspettarsi: Profilo aziendale (settore, fatturato, dipendenti, ubicazione), contatti chiave con titoli ed email, opportunità aperte con fasi e importi, e casi di supporto recenti con stato.

Ricerca di un caso

Cercare un caso di supporto specifico tramite numero:

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

Cosa aspettarsi: Oggetto del caso, stato, priorità, descrizione, il profilo dell’account cliente e il proprietario del caso con le informazioni di contatto.

Guida all’utilizzo: Query sui dati

Per gli utenti avanzati, è possibile richiedere query in stile SOQL in linguaggio naturale. Il plugin traduce la richiesta nel SOQL appropriato e lo esegue.

Campi specifici

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

Filtro per data

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

Aggregazione

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

Oggetti personalizzati

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

Skill di sviluppo

Le 30 skill di sviluppo Salesforce della libreria forcedotcom/afv-library si attivano automaticamente per attività relative ad Apex, Flow, LWC, SOQL, metadati, Agentforce e deployment. Installarle separatamente:

npx skills add forcedotcom/afv-library

Argomento	Skill
Classi e servizi Apex	`generating-apex`
Test Apex	`generating-apex-test`
Flow	`generating-flow`
Bundle LWC e UI	`building-ui-bundle-app`
Oggetti personalizzati	`generating-custom-object`
Campi personalizzati	`generating-custom-field`
Regole di validazione	`generating-validation-rule`
Set di autorizzazioni	`generating-permission-set`
FlexiPage	`generating-flexipage`
Agenti Agentforce	`developing-agentforce`
Test Agentforce	`testing-agentforce`
Deployment	`deploying-ui-bundle`
Migrazione SLDS2	`uplifting-components-to-slds2`
Refactoring dei trigger	`trigger-refactor-pipeline`