salesforce

Le plugin salesforce intègre Salesforce CLI avec Claude Code, fournissant une authentification d’organisation et un agent CLI polyvalent capable d’exécuter n’importe quelle commande sf, y compris les requêtes SOQL. Il prend en charge les environnements de conteneurs sans interface graphique avec les flux d’authentification JWT, access-token et SFDX URL. Le guide d’utilisation ci-dessous montre comment utiliser le langage naturel pour interroger des comptes, des opportunités, des tickets et des contacts via l’agent CLI.

v1.0.0 Development

Installation

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

Prérequis

• Salesforce CLI (@salesforce/cli)
• Organisation Salesforce avec accès API
• Un compte utilisateur avec les autorisations pour interroger des objets (Cases, Opportunities, Accounts, Contacts)

Installez Salesforce CLI sur votre poste de travail :

brew install sf

Vérifiez l’installation :

sf --version

Vous devriez voir une sortie du type @salesforce/cli/2.x.x.

Configuration de l’authentification

Étape 1 : Trouver votre domaine Salesforce

Regardez votre URL Salesforce dans le navigateur. Si vous accédez à Salesforce à l’adresse https://example-corp.lightning.force.com, votre domaine de connexion est https://example-corp.my.salesforce.com.

Astuce

Si votre entreprise utilise SSO, vous devez spécifier votre domaine personnalisé avec --instance-url afin que la connexion redirige via votre fournisseur SSO plutôt que vers la page de connexion Salesforce générique.

Étape 2 : S’authentifier via le navigateur

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

Remplacez YOUR-DOMAIN par le domaine de votre entreprise issu de l’étape 1. Votre navigateur s’ouvre — effectuez le flux SSO ou de connexion et autorisez l’application. Vous devriez voir :

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

Étape 3 : Vérifier la connexion

sf org display --target-org my-org

Confirmez que la sortie indique Connected Status: Connected avec votre nom d’utilisateur et l’URL de l’instance.

Étape 4 : Authentification portable pour les conteneurs (optionnel)

Si vous devez vous authentifier dans un environnement sans interface graphique (CI/CD, conteneur, session distante), exportez l’URL d’authentification SFDX depuis votre poste de travail :

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

Copiez la valeur Sfdx Auth Url (commence par force://). Dans le conteneur, exécutez :

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

Attention

L’URL d’authentification SFDX est un identifiant — traitez-la comme un mot de passe. Ne la validez pas dans des fichiers ni ne la collez dans un chat. Utilisez uniquement des variables d’environnement et des redirections stdin.

Référence des méthodes d’authentification

Méthode	Idéal pour	Nécessite
Web Login	Postes de travail avec navigateur	Navigateur + SSO
SFDX URL	Conteneurs, CI/CD, authentification portable	URL d’auth depuis une session authentifiée
JWT Bearer	Pipelines automatisés	Connected App + clé privée + clé consommateur
Access Token	Authentification par variable d’environnement	SF_ACCESS_TOKEN + SF_ORG_INSTANCE_URL

Remarque : Le flux device (sf org login device) est bloqué depuis août 2025 et n’est pas pris en charge.

Variables d’environnement

Variable	Rôle
SF_ACCESS_TOKEN	Jeton Bearer pour l’authentification access-token
SFDX_AUTH_URL	URL d’authentification Force pour l’auth SFDX URL
SF_ORG_INSTANCE_URL	URL de l’instance d’organisation
SF_JWT_KEY_FILE	Chemin vers la clé privée JWT
SF_CLIENT_ID	Clé consommateur de la Connected App
SF_USERNAME	Nom d’utilisateur Salesforce pour JWT

Commandes

/salesforce:sf-status

Vérifiez le statut de connexion de votre organisation Salesforce, la version CLI et les organisations authentifiées.

/salesforce:sf-status

Ce à quoi s’attendre : Un tableau affichant votre version sf CLI, l’alias de l’organisation authentifiée, le nom d’utilisateur, l’URL de l’instance, le statut de connexion et la version de l’API.

/salesforce:sf-login

Authentifiez-vous auprès d’une organisation Salesforce. Vous pouvez fournir un alias en option.

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

Ce à quoi s’attendre : Si une organisation avec cet alias est déjà authentifiée, les détails de connexion sont affichés. Sinon, les identifiants disponibles (variables d’environnement) sont vérifiés et l’authentification s’effectue via la première méthode entièrement satisfaite.

Compétences

salesforce-index

Routeur d’intentions de niveau supérieur. S’active automatiquement lorsque vous mentionnez Salesforce, la gestion d’organisation ou des requêtes de données en langage naturel.

Vous dites	Redirige vers
”login to salesforce”, “authenticate org”	compétence salesforce-auth
”check org status”, “list orgs”	agent cli-operator
”show me opportunities”, “look up case”	agent cli-operator (requête SOQL)
“generate Apex class”, “create Flow”	compétences de développement afv-library

salesforce-auth

Compétence d’authentification adaptée aux conteneurs. Prend en charge quatre méthodes d’auth et détecte automatiquement les identifiants disponibles. Priorité : access-token, puis JWT, puis SFDX URL, puis web login.

Agents

cli-operator

Agent Salesforce CLI autonome qui exécute les commandes sf avec des garde-fous de sécurité. Toutes les opérations Salesforce sont déléguées à cet agent pour garder le contexte de la session principale allégé.

Règles de sécurité :

• Lecture seule par défaut — les opérations d’écriture nécessitent une approbation explicite
• Ne déploie jamais sans une étape de prévisualisation et de confirmation
• N’affiche jamais les access tokens, URL d’auth ou identifiants dans la sortie
• Nettoie toutes les valeurs fournies par l’utilisateur (rejette les métacaractères shell)
• Utilise la sortie --json pour des résultats structurés et analysables

Format de réponse :

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

Guide d’utilisation : Gestion des comptes

Note

Les invites ci-dessous ne sont pas des fonctionnalités codées en dur du plugin. Elles fonctionnent parce que l’agent cli-operator peut exécuter n’importe quelle commande sf CLI, y compris des requêtes SOQL arbitraires. Les résultats dépendent du modèle de données de votre organisation et de vos autorisations utilisateur. Les invites présentées ici ont été testées et vérifiées pour fonctionner avec les objets Salesforce standard (Account, Contact, Case, Opportunity, AccountTeamMember, OpportunityTeamMember).

Ces invites fonctionnent avec n’importe quelle organisation Salesforce. Remplacez les valeurs fictives par vos propres informations. Chaque invite produit des résultats spécifiques à votre rôle, vos comptes et votre territoire.

Astuce

Pour de meilleurs résultats, incluez votre adresse e-mail dans les invites qui nécessitent d’identifier votre enregistrement utilisateur. Les organisations Salesforce peuvent avoir plusieurs utilisateurs avec des noms similaires.

Démarrage

Après l’authentification, vérifiez que tout fonctionne :

/salesforce:sf-status

Puis essayez une requête simple en langage naturel :

list my authenticated salesforce orgs

Ce à quoi s’attendre : Un tableau affichant toutes les organisations connectées avec alias, nom d’utilisateur, URL d’instance et statut de connexion.

Trouver vos comptes

Découvrez les comptes auxquels vous êtes affecté :

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

Ce à quoi s’attendre : Une liste de comptes regroupés par propriétaire de compte, affichant votre rôle de membre d’équipe sur chacun. Si la plupart des rôles apparaissent vides, il s’agit d’un problème courant de qualité des données — les membres d’équipe de compte existent mais les rôles n’ont pas été renseignés.

Comparer la couverture avec un collègue

Comparez votre couverture de comptes avec celle d’un collègue pour identifier les lacunes :

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.

Ce à quoi s’attendre : Un tableau récapitulatif indiquant le nombre de chevauchements et de lacunes, suivi de deux listes. Si vous avez récemment changé de rôle, vous pouvez trouver zéro chevauchement — cela révèle les comptes auxquels vous devez être ajouté.

Note

Vous pouvez également vérifier un prédécesseur en ajoutant : « Also check if Previous Person Name appears on any of those accounts. » Cela aide à identifier les lacunes de passation lors du remplacement de quelqu’un sur un territoire.

Aperçu du pipeline du territoire

Consultez toutes les opportunités ouvertes sur vos comptes :

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

Ce à quoi s’attendre : Un résumé avec le nombre total d’opportunités, le pipeline brut et le pipeline pondéré. Puis un tableau de répartition par étape et une liste des meilleures opportunités par montant. La sortie signale les problèmes de qualité des données tels que les dates de clôture dépassées ou les montants nuls.

Analyse approfondie d’une opportunité

Obtenez une vue complète d’une transaction spécifique :

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

Ce à quoi s’attendre : La vue d’ensemble de l’opportunité (étape, montant, date de clôture, probabilité, catégorie de prévision, propriétaire), les membres de l’équipe d’opportunité avec leurs rôles, les contacts associés, les tâches et événements récents, et l’historique des modifications de champ montrant l’évolution du montant et de la date de clôture de la transaction au fil du temps.

Tickets de support sur le territoire

Vérifiez les tickets de support ouverts sur vos comptes :

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

Ce à quoi s’attendre : Un décompte des tickets ouverts avec répartition par priorité et statut, puis les détails des tickets regroupés par compte. Les tickets inactifs (vieux de plusieurs mois ou années sans activité) sont signalés comme candidats à la mise à jour des données.

Prévision trimestrielle du pipeline

Obtenez une vue prête pour les prévisions de votre pipeline :

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

Ce à quoi s’attendre : Un tableau avec une ligne par trimestre affichant le nombre d’opportunités, le pipeline total et le pipeline pondéré. Inclut une répartition par étape par trimestre et met en évidence les meilleures transactions pondérées. Les opportunités en retard sont regroupées séparément.

Vue d’ensemble complète d’un compte

Analyse approfondie d’un client spécifique :

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

Ce à quoi s’attendre : Profil de l’entreprise (secteur, chiffre d’affaires, employés, localisation), contacts clés avec titres et e-mail, opportunités ouvertes avec étapes et montants, et tickets de support récents avec statut.

Recherche de ticket

Recherchez un ticket de support spécifique par numéro :

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

Ce à quoi s’attendre : Sujet du ticket, statut, priorité, description, le profil du compte client et le propriétaire du ticket avec ses coordonnées.

Guide d’utilisation : Requêtes de données

Pour les utilisateurs avancés, vous pouvez demander des requêtes de style SOQL spécifiques en langage naturel. Le plugin traduit votre demande en SOQL approprié et l’exécute.

Champs spécifiques

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

Filtrage par date

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

Agrégation

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

Objets personnalisés

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

Astuce

Si une requête échoue parce qu’un champ n’existe pas, le plugin réessaie automatiquement sans ce champ. Les champs personnalisés de votre organisation peuvent utiliser des noms différents — vérifiez votre configuration Salesforce si un champ est introuvable.

Compétences de développement

Les 30 compétences de développement Salesforce issues de la bibliothèque forcedotcom/afv-library s’activent automatiquement pour Apex, Flow, LWC, SOQL, les métadonnées, Agentforce et les tâches de déploiement. Installez-les séparément :

npx skills add forcedotcom/afv-library

Sujet	Compétence
Classes et services Apex	generating-apex
Tests Apex	generating-apex-test
Flows	generating-flow
Bundles LWC et UI	building-ui-bundle-app
Objets personnalisés	generating-custom-object
Champs personnalisés	generating-custom-field
Règles de validation	generating-validation-rule
Ensembles d’autorisations	generating-permission-set
FlexiPages	generating-flexipage
Agents Agentforce	developing-agentforce
Tests Agentforce	testing-agentforce
Déploiement	deploying-ui-bundle
Migration SLDS2	uplifting-components-to-slds2
Refactorisation des déclencheurs	trigger-refactor-pipeline