Overview
The Salesforce integration connects your AI agent to your Salesforce CRM. Your chatbot can look up customer information, check deal status, capture new leads, and update contact records, all through natural conversation.
Ideal for sales teams who want to capture leads from chat conversations and provide customers with real-time information about their accounts.
Available Actions
| Action | Description |
|---|
| Get Contact | Look up contact information by email or name |
| Get Opportunity | Check the status of a deal/opportunity |
| Create Lead | Create a new lead record from chat conversation |
| Update Contact | Update existing contact information |
The Create Lead action is great for capturing prospects directly from chat conversations. Leads are created with full conversation context.
Prerequisites
Before setting up the Salesforce integration, you'll need:
- A Salesforce account with API access
- Admin access to create connected apps
- Your Salesforce instance URL
Setup Instructions
Step 1: Create a Connected App
- Log in to Salesforce
- Go to Setup → App Manager
- Click New Connected App
- Fill in the basic info:
- Connected App Name: “ChatSpark”
- API Name: “ChatSpark”
- Contact Email: your email
- Enable OAuth Settings
- Add OAuth scopes:
api, refresh_token - Click Save
Step 2: Get Your Credentials
- After saving, go to Manage Consumer Details
- Copy your Consumer Key and Consumer Secret
- Note your Instance URL (e.g.,
https://yourcompany.salesforce.com)
Salesforce uses OAuth for authentication. You'll need to authorize ChatSpark to access your Salesforce data during setup.
Step 3: Enable in ChatSpark
- In ChatSpark, go to AI Actions
- Find Salesforce in the Library and click Enable
- Select the chatbot(s) that should have access
- Enter your Instance URL and Access Token
- Click Save
Configuration Fields
| Field | Description | Example |
|---|
| Instance URL | Your Salesforce instance URL | https://yourcompany.salesforce.com |
| Access Token | Your Salesforce access token | 00D... |
Testing Your Integration
After setup, test the integration:
- Open your chatbot widget
- Try asking: “Look up contact john@example.com”
- The AI should return the contact details from Salesforce
Other test queries:
- “Create a lead for Jane Smith at jane@company.com”
- “What's the status of the Acme Corp opportunity?”
- “Update the phone number for contact ID xxx”
Troubleshooting
Invalid session
Salesforce access tokens expire. You may need to refresh your token or re-authenticate the connection.
API access denied
Ensure your Salesforce license includes API access. Some editions restrict API access.
Field permission errors
Check that your Salesforce user profile has read/write access to the fields ChatSpark needs to access.
If you're having trouble with the Salesforce integration, contact our support team and we'll help you troubleshoot.
Also: Built-in Lead Capture
For simpler lead collection without a CRM integration, ChatSpark's built-in
Lead Capture collects name, email, phone, and more through natural conversation. Export as CSV or push to any tool via Zapier.