FruxonDocs

Salesforce

Salesforce CRM integration for accounts, contacts, opportunities, leads, and SOQL queries

The Salesforce integration lets your agents manage CRM objects — accounts, contacts, opportunities, leads — and run SOQL/SOSL queries.

Prerequisites

You need:

  • Salesforce Instance URL — Your Salesforce instance URL (e.g., https://your-org.my.salesforce.com).
  • One of the following for authentication:
    • Access Token — A Salesforce OAuth access token.
    • OAuth — For user-level access where each chat user authorizes with their own Salesforce account.

Setup

  1. Open your agent in Agent Studio
  2. In the Integrations panel, click Add Integration Config
  3. Select Salesforce from the integration list
  4. Give the config a display name (e.g., "Salesforce - CRM")
  5. Enter your Instance URL
  6. Choose your authentication method:
    • Access Token — Paste your Salesforce access token
    • OAuth — Click Connect to start the Salesforce OAuth flow
  7. Save the agent revision

Using in Your Agent

  1. In an Agent Step, attach Salesforce tools from the tools panel
  2. The agent uses your integration config for all Salesforce API calls
  3. Tools are referenced as salesforce.query_records, salesforce.create_record, etc.

Available Tools

Generic Record Operations

ToolDescriptionAction Type
query_recordsQuery records using SOQLReadOnly
search_recordsSearch records using SOSLReadOnly
describe_sobjectDescribe an SObject schemaReadOnly
get_recordGet a record by IDReadOnly
list_recordsList recent recordsReadOnly
create_recordCreate a recordReversible
update_recordUpdate a recordReversible
delete_recordDelete a recordIrreversible

Accounts

ToolDescriptionAction Type
get_accountsGet accountsReadOnly
get_accountGet a specific accountReadOnly
create_accountCreate an accountReversible
update_accountUpdate an accountReversible

Contacts

ToolDescriptionAction Type
get_contactsGet contactsReadOnly
get_contactGet a specific contactReadOnly
create_contactCreate a contactReversible
update_contactUpdate a contactReversible

Opportunities

ToolDescriptionAction Type
get_opportunitiesGet opportunitiesReadOnly
get_opportunityGet a specific opportunityReadOnly
create_opportunityCreate an opportunityReversible
update_opportunityUpdate an opportunityReversible

Leads

ToolDescriptionAction Type
get_leadsGet leadsReadOnly
get_leadGet a specific leadReadOnly
create_leadCreate a leadReversible
update_leadUpdate a leadReversible

On this page