salesforce

Il plugin salesforce integra la CLI Salesforce con Claude Code, fornendo l’autenticazione dell’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 gli oggetti (Cases, Opportunities, Accounts, Contacts)

Installare la CLI Salesforce sulla propria workstation:

brew install sf

Verificare l’installazione:

sf --version

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

Configurazione dell’autenticazione

Passaggio 1: Trovare il proprio dominio Salesforce

Osservare l’URL di Salesforce nel browser. Se si accede a Salesforce tramite https://acme.lightning.force.com, il dominio di accesso è https://acme.my.salesforce.com.

Consiglio

Se l’azienda utilizza SSO, è necessario specificare il proprio dominio personalizzato con --instance-url affinché il login venga reindirizzato tramite il provider SSO anziché alla pagina di accesso generica di Salesforce.

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 indicato nel Passaggio 1. Il browser si apre — completare il flusso SSO o di accesso e autorizzare l’applicazione. Dovrebbe comparire:

Successfully authorized your-email@company.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 nome utente 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’URL di autenticazione SFDX 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@your-domain.my.salesforce.com"
echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin=- --alias=my-org --set-default

Attenzione

L’URL di autenticazione SFDX è una credenziale — trattarla come una password. Non salvarla in file né incollarla in chat. Utilizzare esclusivamente variabili di ambiente e pipe stdin.

Riferimento ai metodi di autenticazione

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

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

Variabili di ambiente

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

Comandi

/salesforce:sf-status

Verificare 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, il nome utente, l’URL dell’istanza, lo stato della connessione e la versione API.

/salesforce:sf-login

Autenticarsi su un’org Salesforce. È possibile fornire un alias in modo opzionale.

/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 di ambiente) e l’autenticazione avviene tramite il primo metodo completamente soddisfatto.

Skill

salesforce-index

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

Si dice	Instrada 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 quali credenziali sono disponibili. Ordine di priorità: access-token, poi JWT, poi SFDX URL, poi web login.

Agenti

cli-operator

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

Regole di sicurezza:

• Solo 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 access token, URL di autenticazione o credenziali nell’output
• Sanifica tutti i valori forniti dall’utente (rifiuta i metacaratteri shell)
• Utilizza l’output --json per risultati strutturati e analizzabili

Formato della risposta:

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

Guida all’utilizzo: Gestione degli account

Nota

I prompt di seguito non sono funzionalità codificate nel plugin. Funzionano perché l’agente cli-operator può eseguire qualsiasi comando della CLI sf, incluse query SOQL arbitrarie. I risultati dipendono dal modello dati dell’org e dalle autorizzazioni dell’utente. I prompt qui presenti sono stati testati e verificati con gli oggetti Salesforce standard (Account, Contact, Case, Opportunity, AccountTeamMember, OpportunityTeamMember).

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

Consiglio

Per ottenere i migliori risultati, includere il proprio indirizzo email nei prompt che devono identificare il proprio record utente. Le org Salesforce possono avere più utenti con nomi simili.

Per iniziare

Dopo l’autenticazione, verificare che tutto funzioni:

/salesforce:sf-status

Poi provare una semplice query in linguaggio naturale:

list my authenticated salesforce orgs

Cosa aspettarsi: Una tabella che mostra tutte le org connesse con alias, nome utente, 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@company.com

Cosa aspettarsi: Un elenco di account raggruppati per proprietario, che mostra il proprio ruolo nel team account per 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 popolati.

Confrontare la copertura con un collega

Confrontare la propria copertura account con quella di un collega per identificare le lacune:

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.

Cosa aspettarsi: Una tabella riassuntiva che mostra il numero di sovrapposizioni e lacune, seguita da due elenchi. Se si è cambiato ruolo di recente, è possibile che non vi sia alcuna sovrapposizione — questo rivela gli account a cui occorre essere aggiunti.

Nota

È possibile verificare anche la presenza di un predecessore aggiungendo: “Also check if Previous Person Name appears on any of those accounts.” Questo aiuta a identificare le lacune nel passaggio di consegne quando si sostituisce qualcuno in un territorio.

Panoramica della pipeline del territorio

Visualizzare tutte le opportunità aperte nei propri 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 numero totale di opportunità, la pipeline grezza e quella pesata. Seguono una tabella di distribuzione per fase e un elenco delle principali opportunità per importo. L’output segnala i problemi di qualità dei dati, come date di chiusura scadute o importi nulli.

Analisi approfondita di un’opportunità

Ottenere un quadro completo su una trattativa specifica:

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 di previsione, proprietario), i membri del team opportunità con i relativi ruoli, i contatti associati, le attività e gli eventi recenti, e la cronologia delle modifiche ai campi che mostra come l’importo e la data di chiusura si sono evoluti nel tempo.

Casi di supporto nel territorio

Verificare i casi di supporto aperti nei propri account:

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

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

Previsione della pipeline trimestrale

Ottenere una vista della pipeline pronta per la previsione:

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 numero di opportunità, la pipeline totale e quella pesata. Include un dettaglio del mix di fasi per trimestre ed evidenzia le trattative con maggiore peso. Le opportunità scadute vengono raggruppate separatamente.

Panoramica completa di un 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, sede), 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'

Consiglio

Se una query fallisce perché un campo non esiste, il plugin ritenta automaticamente senza quel campo. I campi personalizzati dell’org possono avere nomi diversi — verificare la configurazione di Salesforce se un campo non viene trovato.

Skill di sviluppo

Le 30 skill di sviluppo Salesforce della libreria forcedotcom/afv-library si attivano automaticamente per Apex, Flow, LWC, SOQL, metadati, Agentforce e attività di deploy. 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
Deploy	deploying-ui-bundle
Migrazione SLDS2	uplifting-components-to-slds2
Refactoring dei trigger	trigger-refactor-pipeline