Salesforce

परिचय

कस्टमर डेटा ऐक्सेस करने, लीड्स मैनेज करने और अवसर बनाने के लिए अपने ElevenLabs AI एजेंट्स को Salesforce CRM से कनेक्ट करें। यह इंटीग्रेशन आपके एजेंट्स को मौजूदा कस्टमर रिकॉर्ड प्राप्त करने, नई लीड्स और कॉन्टैक्ट्स बनाने और बातचीत के दौरान Salesforce ऑब्जेक्ट्स को क्वेरी करने देता है।

क्षमताएं

सेटअप

यह इंटीग्रेशन ऑथेंटिकेशन के लिए Salesforce OAuth 2.0 Client Credentials का इस्तेमाल करता है। आपको Salesforce में एक External Client App बनाना होगा।

डेमो वीडियो

यह कैसे काम करता है

टूल कॉन्फ़िगरेशन

तीन webhook टूल उपलब्ध हैं: salesforce_search_records, salesforce_get_record, और salesforce_create_record। हर टूल के लिए Workplace Auth Connection से ऑथराइज़ेशन कॉन्फ़िगर करें।

ऑथराइज़ेशन - Workplace OAuth2 कनेक्शन

{
  "grant_type": "client_credentials"
}

Webhook टूल कॉन्फ़िगरेशन

Authentication सेक्शन में हर टूल के लिए एक Workplace Auth Connection (OAuth2) जोड़ें। हर टूल का कॉन्फ़िगरेशन देखने के लिए नीचे दिए टैब इस्तेमाल करें।

{
  "type": "webhook",
  "name": "salesforce_search_records",
  "description": "Searches for existing records in Salesforce using SOQL queries. Always returns human-readable names and details, not just IDs.",
  "api_schema": {
    "url": "https://acme.my.salesforce.com/services/data/v58.0/query/",
    "method": "GET",
    "path_params_schema": [],
    "query_params_schema": [
      {
        "id": "q",
        "type": "string",
        "description": "SOQL query string to search for records. Always include Name fields and other human-readable information. Example: SELECT Id, Name, Email, Phone, Company FROM Contact WHERE Email = 'customer@example.com'. For Opportunities, include: SELECT Id, Name, StageName, Amount, CloseDate, Account.Name FROM Opportunity",
        "dynamic_variable": "",
        "constant_value": "",
        "required": true,
        "value_type": "llm_prompt"
      }
    ],
    "request_body_schema": null,
    "request_headers": [
      {
        "type": "value",
        "name": "Content-Type",
        "value": "application/json"
      }
    ]
  },
  "response_timeout_secs": 30,
  "dynamic_variables": {
    "dynamic_variable_placeholders": {}
  }
}

सामान्य Salesforce ऑब्जेक्ट्स

सामान्य SOQL क्वेरीज़

अपने एजेंट के सिस्टम प्रॉम्प्ट को कस्टमाइज़ करते समय इन SOQL क्वेरीज़ को शुरुआती बिंदु के रूप में इस्तेमाल करें। सभी क्वेरीज़ तकनीकी IDs के बजाय इंसानों के पढ़ने लायक जानकारी लौटाती हैं:

ईमेल से कॉन्टैक्ट खोजें

SELECT Id, Name, Email, Phone, Title, Account.Name, Account.Type FROM Contact WHERE Email = 'customer@example.com'

ईमेल या फ़ोन से लीड खोजें

SELECT Id, Name, Email, Phone, Company, Industry, Status, LeadSource, Title FROM Lead WHERE Email = 'customer@example.com' OR Phone = '+1234567890'

नाम से अकाउंट खोजें

SELECT Id, Name, Type, Industry, Phone, BillingCity, BillingState, Website FROM Account WHERE Name LIKE '%Company Name%'

हाल की अवसरों की जानकारी खोजें

SELECT Id, Name, StageName, Amount, CloseDate, Account.Name, Account.Type, Owner.Name, Description FROM Opportunity WHERE CreatedDate = THIS_MONTH

अकाउंट के आधार पर अवसर खोजें

SELECT Id, Name, StageName, Amount, CloseDate, Probability, NextStep, Owner.Name FROM Opportunity WHERE Account.Name LIKE '%Company Name%'

इंटीग्रेशन टेस्टिंग

अपना External Client App सेट अप करने और इंटीग्रेशन कनेक्ट करने के बाद, प्रोडक्शन में डिप्लॉय करने से पहले इसकी जांच करें:

1. खोज सुविधा: अपने एजेंट से मौजूदा कॉन्टैक्ट खोजने के लिए कहें।
2. रिकॉर्ड बनाना: अपने एजेंट से नई लीड या कॉन्टैक्ट बनाने के लिए कहें।
3. डेटा प्राप्त करना: पुष्टि करें कि आपका एजेंट ग्राहकों की विस्तृत जानकारी प्राप्त कर सकता है।

केस कमेंट ट्रिगर: Email-to-Case के लिए ईमेल जवाब

अगर आपने Salesforce Case Comment ट्रिगर (Service Cloud Cases के लिए एजेंट का ऑटो-रिस्पॉन्स) सक्षम किया है, तो कम-से-कम एक इनबाउंड ईमेल वाले Cases के जवाब ग्राहक को असली, थ्रेडेड ईमेल के रूप में भेजे जाते हैं — सिर्फ़ आंतरिक Case Comment के रूप में नहीं। यह इस बात पर आधारित है कि Case में कोई इनबाउंड ईमेल है या नहीं, न कि Case की Origin पिकलिस्ट वैल्यू पर। इसलिए, अगर आपका org सामान्य “Email” के बजाय “Email - Returns” जैसी कस्टमाइज़्ड Origin वैल्यू इस्तेमाल करता है, तब भी यह सही तरह से काम करता है। जिन Cases में कोई इनबाउंड ईमेल नहीं है, उनमें पहले की तरह कोई बदलाव किए बिना सार्वजनिक Case Comment पोस्ट होता रहेगा। ग्राहक के मूल ईमेल में CC किए गए सभी पते जवाब में भी अपने-आप CC हो जाते हैं, ठीक वैसे ही जैसे किसी मानव एजेंट का “Reply All” काम करता है — बस आपके org के Email-to-Case रूटिंग पते CC में जानबूझकर शामिल नहीं किए जाते, ताकि जवाब Email-to-Case द्वारा फिर से इनजेस्ट न हो और एजेंट अपने ही संदेश पर दोबारा ट्रिगर न हो।

ईमेल जवाब भेजने के लिए, सिर्फ़ Case Comments के लिए ज़रूरी सेटअप के अलावा कुछ और सेटअप चाहिए:

• Run As यूज़र के Profile या Permission Set में, इंटीग्रेशन के लिए पहले से ज़रूरी API Enabled अनुमति के अलावा, Send Email सिस्टम अनुमति भी सक्षम होनी चाहिए (Setup > Users > Profiles, System Permissions के अंतर्गत)।
• आपके org की Email Deliverability सेटिंग (Setup > Email > Deliverability) में बाहरी ईमेल की अनुमति होनी चाहिए — Sandboxes में डिफ़ॉल्ट रूप से यह प्रतिबंधित सेटिंग होती है, जो बिना सूचना के आउटबाउंड ईमेल ब्लॉक कर देती है।
• अगर आप चाहते हैं कि जवाब Run As यूज़र के अपने मेलबॉक्स के बजाय किसी सपोर्ट उपनाम से आएं, तो ट्रिगर पर Org-Wide Email Address Id फ़ील्ड को Organization-Wide Email Address के Id पर सेट करें (Setup > Organization-Wide Addresses > पते पर क्लिक करें > URL से Id कॉपी करें)। Run As यूज़र के अपने पते से भेजने के लिए इसे खाली छोड़ दें।
• ट्रिगर पर Email-to-Case Routing Address(es) फ़ील्ड को अपने org के Email-to-Case पते पर सेट करें (एक से अधिक पते होने पर कॉमा से अलग करें, Setup > Email-to-Case)। इसके बिना, इंटीग्रेशन ग्राहक के ईमेल के To पते से रूटिंग पते का अनुमान लगाने की कोशिश करता है। इसमें वे Cases छूट जाते हैं जिनमें आपका रूटिंग पता मुख्य प्राप्तकर्ता के बजाय सिर्फ़ CC में था — ऐसी स्थिति में जवाब में उसे फिर से CC करने पर एजेंट अपने ही संदेश पर दोबारा ट्रिगर हो जाएगा।

अगर ग्राहक के org में ये कॉन्फ़िगर नहीं हैं, तो ईमेल भेजने में विफलता की स्थिति में सार्वजनिक Case Comment पोस्ट किया जाता है, ताकि कोई जवाब बिना सूचना के छूट न जाए — लेकिन ऊपर दिया गया सेटअप पूरा होने तक ग्राहक को वह ईमेल से नहीं मिलेगा।

सुरक्षा संबंधी बातें

• सभी API कॉल के लिए HTTPS एंडपॉइंट इस्तेमाल करें।
• सुनिश्चित करें कि Salesforce में सही फ़ील्ड-लेवल सुरक्षा कॉन्फ़िगर की गई है।
• Run As यूज़र की अनुमतियां तय करती हैं कि इंटीग्रेशन किस डेटा तक पहुंच सकता है — इन्हें उसी अनुसार सीमित रखें।
• API एक्सेस और उपयोग का नियमित रूप से ऑडिट करें।

उपयोगी लिंक

• Salesforce REST API दस्तावेज़
• SOQL क्वेरी भाषा रेफरेंस
• External Client Apps और OAuth 2.0
• Salesforce सुरक्षा के सर्वोत्तम तरीके