salesforce

salesforce प्लगइन Salesforce CLI को Claude Code के साथ एकीकृत करता है, org प्रमाणीकरण और एक सामान्य-उद्देश्य CLI एजेंट प्रदान करता है जो SOQL क्वेरी सहित कोई भी sf कमांड चला सकता है। यह JWT, access-token, और SFDX URL प्रमाणीकरण फ्लो के साथ headless कंटेनर परिवेशों का समर्थन करता है। नीचे दिया गया उपयोग मार्गदर्शिका दर्शाता है कि CLI एजेंट के माध्यम से accounts, opportunities, cases, और contacts क्वेरी करने के लिए प्राकृतिक भाषा का उपयोग कैसे करें।

v1.0.0 Development

स्थापना

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

पूर्वापेक्षाएँ

Salesforce CLI (@salesforce/cli)
Salesforce org API एक्सेस के साथ
ऑब्जेक्ट क्वेरी करने की अनुमति वाला उपयोगकर्ता खाता (Cases, Opportunities, Accounts, Contacts)

अपने वर्कस्टेशन पर Salesforce CLI स्थापित करें:

brew install sf

स्थापना सत्यापित करें:

sf --version

आपको @salesforce/cli/2.x.x जैसा आउटपुट दिखना चाहिए।

प्रमाणीकरण सेटअप

चरण 1: अपना Salesforce डोमेन खोजें

ब्राउज़र में अपना Salesforce URL देखें। यदि आप Salesforce को https://acme.lightning.force.com पर एक्सेस करते हैं, तो आपका लॉगिन डोमेन https://acme.my.salesforce.com है।

चरण 2: ब्राउज़र के माध्यम से प्रमाणीकरण करें

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

चरण 1 से अपने कंपनी डोमेन से YOUR-DOMAIN बदलें। आपका ब्राउज़र खुलता है — SSO या लॉगिन फ्लो पूरा करें और ऐप को अधिकृत करें। आपको यह दिखना चाहिए:

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

चरण 3: कनेक्शन सत्यापित करें

sf org display --target-org my-org

पुष्टि करें कि आउटपुट में आपके username और instance URL के साथ Connected Status: Connected दिखता है।

चरण 4: कंटेनर के लिए पोर्टेबल auth (वैकल्पिक)

यदि आपको headless परिवेश (CI/CD, कंटेनर, रिमोट सेशन) में प्रमाणीकरण करना है, तो अपने वर्कस्टेशन से SFDX auth URL निर्यात करें:

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

Sfdx Auth Url मान कॉपी करें (जो force:// से शुरू होता है)। कंटेनर में चलाएँ:

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

प्रमाणीकरण विधियों का संदर्भ

विधि	इसके लिए सर्वश्रेष्ठ	आवश्यकता
Web Login	ब्राउज़र वाले वर्कस्टेशन	Browser + SSO
SFDX URL	कंटेनर, CI/CD, पोर्टेबल auth	प्रमाणीकृत सेशन से Auth URL
JWT Bearer	स्वचालित पाइपलाइन	Connected App + private key + consumer key
Access Token	Environment variable auth	`SF_ACCESS_TOKEN` + `SF_ORG_INSTANCE_URL`

नोट: Device flow (sf org login device) अगस्त 2025 से अवरुद्ध है और समर्थित नहीं है।

Environment variables

Variable	उद्देश्य
`SF_ACCESS_TOKEN`	access-token auth के लिए Bearer token
`SFDX_AUTH_URL`	SFDX URL auth के लिए Force auth URL
`SF_ORG_INSTANCE_URL`	Org instance URL
`SF_JWT_KEY_FILE`	JWT private key का पथ
`SF_CLIENT_ID`	Connected App consumer key
`SF_USERNAME`	JWT के लिए Salesforce username

कमांड

/salesforce:sf-status

अपना Salesforce org कनेक्शन स्थिति, CLI संस्करण, और प्रमाणीकृत orgs जाँचें।

/salesforce:sf-status

क्या अपेक्षित करें: एक तालिका जो आपका sf CLI संस्करण, प्रमाणीकृत org alias, username, instance URL, कनेक्टेड स्थिति, और API संस्करण दिखाती है।

/salesforce:sf-login

Salesforce org में प्रमाणीकरण करें। वैकल्पिक रूप से एक alias प्रदान करें।

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

क्या अपेक्षित करें: यदि उस alias वाला org पहले से प्रमाणीकृत है, तो यह कनेक्शन विवरण रिपोर्ट करता है। यदि नहीं, तो यह उपलब्ध क्रेडेंशियल (environment variables) जाँचता है और पहली पूरी तरह से संतुष्ट विधि का उपयोग करके प्रमाणीकरण करता है।

कौशल

salesforce-index

शीर्ष-स्तरीय intent राउटर। जब आप प्राकृतिक भाषा में Salesforce, org प्रबंधन, या डेटा क्वेरी का उल्लेख करते हैं तो स्वचालित रूप से सक्रिय होता है।

आप कहते हैं	रूट करता है
”login to salesforce”, “authenticate org”	`salesforce-auth` skill
”check org status”, “list orgs”	`cli-operator` agent
”show me opportunities”, “look up case”	`cli-operator` agent (SOQL query)
“generate Apex class”, “create Flow”	afv-library development skills

salesforce-auth

कंटेनर-अनुकूलित प्रमाणीकरण कौशल। चार auth विधियों का समर्थन करता है और स्वचालित रूप से पता लगाता है कि कौन से क्रेडेंशियल उपलब्ध हैं। प्राथमिकता: access-token, फिर JWT, फिर SFDX URL, फिर web login।

एजेंट

cli-operator

स्वायत्त Salesforce CLI एजेंट जो सुरक्षा गार्डरेल के साथ sf कमांड निष्पादित करता है। मुख्य सेशन संदर्भ को सुव्यवस्थित रखने के लिए सभी Salesforce ऑपरेशन इस एजेंट को सौंपे जाते हैं।

सुरक्षा नियम:

डिफ़ॉल्ट रूप से केवल-पठन — write ऑपरेशन के लिए स्पष्ट अनुमोदन आवश्यक है
पूर्वावलोकन और पुष्टि चरण के बिना कभी deploy नहीं करता
आउटपुट में access tokens, auth URLs, या क्रेडेंशियल कभी नहीं दिखाता
सभी उपयोगकर्ता-प्रदत्त मानों को sanitize करता है (shell metacharacters अस्वीकार करता है)
संरचित, parseable परिणामों के लिए --json आउटपुट का उपयोग करता है

प्रतिक्रिया प्रारूप:

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

उपयोग मार्गदर्शिका: खाता प्रबंधन

नीचे दिए गए prompts प्लगइन की hard-coded विशेषताएँ नहीं हैं। ये काम करते हैं क्योंकि cli-operator एजेंट कोई भी sf CLI कमांड चला सकता है, जिसमें मनमानी SOQL क्वेरी शामिल हैं। परिणाम आपके org के डेटा मॉडल और आपकी उपयोगकर्ता अनुमतियों पर निर्भर करते हैं। यहाँ दिए गए prompts मानक Salesforce ऑब्जेक्ट (Account, Contact, Case, Opportunity, AccountTeamMember, OpportunityTeamMember) के साथ परीक्षण और सत्यापित किए गए हैं।

ये prompts किसी भी Salesforce org के साथ काम करते हैं। placeholder मानों को अपनी जानकारी से बदलें। प्रत्येक prompt आपकी भूमिका, खातों, और क्षेत्र के अनुसार परिणाम उत्पन्न करता है।

शुरुआत करना

प्रमाणीकरण के बाद, सत्यापित करें कि सब कुछ काम करता है:

/salesforce:sf-status

फिर एक सरल प्राकृतिक भाषा क्वेरी आज़माएँ:

list my authenticated salesforce orgs

क्या अपेक्षित करें: एक तालिका जो alias, username, instance URL, और कनेक्शन स्थिति के साथ सभी कनेक्टेड orgs दिखाती है।

अपने खाते खोजें

जानें कि आप किन खातों पर account team में असाइन हैं:

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

क्या अपेक्षित करें: खाता स्वामी द्वारा समूहीकृत खातों की एक सूची, प्रत्येक पर आपकी team member भूमिका दिखाती है। यदि अधिकांश भूमिकाएँ खाली दिखती हैं, तो यह एक सामान्य डेटा स्वच्छता अंतर है — account team memberships मौजूद हैं लेकिन भूमिकाएँ populate नहीं की गई थीं।

एक सहकर्मी के साथ कवरेज का क्रॉस-रेफरेंस

अंतराल खोजने के लिए किसी टीममेट के साथ अपने account कवरेज की तुलना करें:

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.

क्या अपेक्षित करें: overlap count और gap count दिखाने वाली एक सारांश तालिका, उसके बाद दो सूचियाँ। यदि आपने हाल ही में भूमिकाएँ बदली हैं, तो आपको शून्य overlap मिल सकता है — यह बताता है कि आपको किन खातों में जोड़ने की आवश्यकता है।

क्षेत्र पाइपलाइन अवलोकन

अपने खातों में सभी खुली opportunities देखें:

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

क्या अपेक्षित करें: कुल opportunity count, raw pipeline, और weighted pipeline के साथ एक सारांश। फिर एक stage distribution तालिका और राशि के अनुसार शीर्ष opportunities की सूची। आउटपुट डेटा स्वच्छता मुद्दों जैसे past-due close dates या null amounts को फ्लैग करता है।

Opportunity गहन विश्लेषण

किसी विशिष्ट deal का पूरा चित्र प्राप्त करें:

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

क्या अपेक्षित करें: opportunity अवलोकन (stage, amount, close date, probability, forecast category, owner), भूमिकाओं के साथ opportunity team members, tagged contacts, हाल के tasks और events, और field change history जो दिखाती है कि deal की राशि और close date समय के साथ कैसे बदली।

क्षेत्र में सहायता cases

अपने खातों पर खुले support cases जाँचें:

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

क्या अपेक्षित करें: priority और status breakdown के साथ खुले cases की संख्या, फिर खाते के अनुसार समूहीकृत case विवरण। पुराने cases (कोई activity नहीं के साथ महीनों या वर्षों पुराने) को hygiene उम्मीदवारों के रूप में फ्लैग किया जाता है।

त्रैमासिक पाइपलाइन पूर्वानुमान

अपनी पाइपलाइन का forecast-ready दृश्य प्राप्त करें:

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

क्या अपेक्षित करें: प्रति तिमाही opportunity count, कुल pipeline, और weighted pipeline दिखाने वाली एक पंक्ति के साथ एक तालिका। प्रति तिमाही stage mix breakdown और शीर्ष weighted deals को हाइलाइट करती है। Past-due opportunities को अलग से समूहीकृत किया जाता है।

पूर्ण खाता अवलोकन

किसी विशिष्ट ग्राहक में गहराई से जाएँ:

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

क्या अपेक्षित करें: कंपनी प्रोफ़ाइल (industry, revenue, employees, location), शीर्षक और ईमेल के साथ मुख्य contacts, stages और amounts के साथ खुली opportunities, और status के साथ हाल के support cases।

Case लुकअप

नंबर के आधार पर एक विशिष्ट support case देखें:

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

क्या अपेक्षित करें: Case subject, status, priority, description, ग्राहक account प्रोफ़ाइल, और संपर्क जानकारी के साथ case owner।

उपयोग मार्गदर्शिका: डेटा क्वेरी

पावर उपयोगकर्ताओं के लिए, आप प्राकृतिक भाषा में विशिष्ट SOQL-शैली की क्वेरी माँग सकते हैं। प्लगइन आपके अनुरोध को उचित SOQL में अनुवादित करता है और चलाता है।

विशिष्ट फ़ील्ड

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

दिनांक फ़िल्टरिंग

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

एकत्रीकरण

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

कस्टम ऑब्जेक्ट

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

विकास कौशल

forcedotcom/afv-library से 30 Salesforce विकास कौशल Apex, Flow, LWC, SOQL, metadata, Agentforce, और deployment कार्यों के लिए स्वचालित रूप से सक्रिय होते हैं। उन्हें अलग से स्थापित करें:

npx skills add forcedotcom/afv-library

विषय	कौशल
Apex classes और services	`generating-apex`
Apex tests	`generating-apex-test`
Flows	`generating-flow`
LWC और UI bundles	`building-ui-bundle-app`
कस्टम objects	`generating-custom-object`
कस्टम fields	`generating-custom-field`
Validation rules	`generating-validation-rule`
Permission sets	`generating-permission-set`
FlexiPages	`generating-flexipage`
Agentforce agents	`developing-agentforce`
Agentforce testing	`testing-agentforce`
Deployment	`deploying-ui-bundle`
SLDS2 migration	`uplifting-components-to-slds2`
Trigger refactoring	`trigger-refactor-pipeline`