Salesforce CRM connector tools
The Salesforce Customer Relationship Management (CRM) connector tools let marketing and sales teams integrate with Salesforce from Mark (Optimizely Agent Platform). The tools streamline workflows, from automating personalized content for new leads and suggesting relevant materials for sales follow-ups. They also provide actionable insights through dynamic reporting and proactive alerts for at-risk opportunities. Mark transforms how teams leverage their CRM for enhanced engagement, efficiency, and competitive advantage.
First, a Mark administrator must configure the Salesforce CRM connector in Mark (Optimizely Agent Platform). On the Connectors page, click Configure on the Salesforce CRM tile and complete the steps. After the administrator configures the connector, individual Mark users and agent builders click Connect on the Salesforce CRM tile and log in to Salesforce CRM to access their information from Mark. Administrators only need to configure the Salesforce CRM connector once.
Connect Mark with Salesforce
The following video and steps walk you through connecting Mark with Salesforce CRM.
Configure the Salesforce CRM connector
When you click Configure, Mark opens the Configure Salesforce CRM dialog. If the connector is not installed yet, an Install modal displays first. The dialog then has two steps: Settings, where you enter the details the connector needs to authenticate, and Tools, where you choose which tools to enable.
As a Mark administrator, complete the following steps:
- Go to Connectors.
- (Optional) Enter Salesforce CRM in the Enter name field, or use the Provider, Active Status, and Provider Type filters to find the connector.
- Click Configure on the Salesforce CRM tile.
Note The Install modal only displays if the connector is not installed yet. Installing adds the connector to your organization and makes its tools available. You install a connector once, for everyone.
- On the Settings step, complete the following, and then click Next. The app stores these settings and applies them to everyone in your organization. Under Salesforce CRM Settings:
- Leave Instance level Mark OAuth off to use the default Salesforce authentication method. Turn it on only if you use a custom Salesforce Auth Provider connection configured in Mark, and then enter the connection name.
- Enter your Salesforce Instance URL, such as https://yourcompany.my.salesforce.com or https://na1.salesforce.com. Leave it blank if your Salesforce Auth Provider already supplies the instance_url value.
Under Tool Permissions:
- Turn Enable Data Reading on to allow read-only operations, such as listing, getting, describing, and counting objects and reports. When it is off, Mark cannot view or query Salesforce data.
- Turn Enable Data Modifications on to allow write operations, such as creating and updating objects. When it is off, Mark cannot create or modify Salesforce records.
- On the Tools step, select the tools that users can use by default, and then click Save. Each tool displays its type, such as Read, Create, Update, or Delete. Use the search field to find a tool, or click Deselect all to clear the selection. Tools that you do not select still display on the connector's Tools tab, but remain disabled until you select them.
After you configure the connector, the Salesforce CRM tile displays Connect for everyone in your organization.
After you complete the steps in this section, Mark users can follow the steps in the Authenticate with Salesforce CRM section.
Approve the Salesforce app in Salesforce
After a Mark administrator Connects Mark with Salesforce, a Salesforce Admin must complete the following steps in Mark:
- Go to Connectors.
- Click Connect on the Salesforce CRM connector.
This makes the Mark app available in Salesforce.
Open a new tab and go to Salesforce. Log in and complete the following steps once:
- Go to Setup > Apps > Connected Apps > Connected Apps OAuth Usage. See Manage Current OAuth Connected App Sessions in the Salesforce documentation.
- Click Manage App Policies on the Opal app. See Manage Access to a Connected App in the Salesforce documentation.
- Click Edit policies and adjust IP restrictions to Relax IP restrictions. See Connected App IP Relaxation and Continuous IP Enforcement in the Salesforce documentation.
- Click Save.
- Click Install on the Connected Apps OAuth Usage page.
Authenticate with Salesforce CRM
After an administrator connects Mark with Salesforce, log in from Mark to access your information. The Salesforce CRM connector tools use user-level authorization, so each Mark user can only access data they have permission to access in Salesforce.
If the tile displays Contact Admin instead of Connect, an administrator has not configured the connector yet. Click Contact Admin to send them a request, which displays in their Notifications.
To authenticate, complete the following steps in Mark:
- Go to Connectors.
- Click Connect on the Salesforce CRM connector tools.

- Log in to Salesforce in the window that Optimizely displays.

After you connect to Salesforce, the Salesforce CRM connector tools become available in Mark chat, agents, and workflows.
Add skills
Skills help you control how Mark communicates with Salesforce based on how you use it. You should add at least one skill before calling the Salesforce connector tools.
As an example, follow the steps in the Create an organization-wide skill documentation and enter the following information:
Name – Salesforce Tools
Core Skill
Salesforce Tool Usage Guidelines: When interacting with Salesforce data, especially `Opportunity` records, always adhere to the following rules:
- Opportunity Filtering:
- When querying `Opportunity` records, only include opportunities where type is one of the following:
- New Customer - Single Product
- New Customer - Multiple Products
- Existing Customer - Cross Sell
- Existing Customer - Cross Sell and Up Sell
- If the user mentions "closed won opportunities" in the context of an Opportunity always use 'stage' of 'Closed Won - Finance'
- If the user mentions "open opportunities" in the context of an Opportunity, filter by 'opportunity status' is 'Open'
- If the user mentions "closed lost opportunities" in the context of an Opportunity always filter by 'stage' is 'Closed Lost'
- If the user mentions "top opportunities" always sort descending by the RecurringSoftwareAmountChange__c field
- Always exclude opportunities with "test", "dummy", or "renewal" in the name (not case sensitive)
- Always exclude opportunities where the RecurringSoftwareAmountChange__c is null, a non-number, 0, or less than 1
- Opportunity Data:
- When returning opportunity data always show: opportunity name, Recurring_Software_Amount_Change__c (label this field 'Recurring Software Amount (converted)'), owner, and close date at a minimum
- Always use thousands separators (commas) when displaying number fields. Never show decimal points or cents.
- IMPORTANT: If the user asks for opportunity "ARR", "amount", "revenue", or "value", always use the RecurringSoftwareAmountChange__c field on the opportunity object because this is always in USD currency. Never use the 'Amount' field because it can be in different currencies.
- Salesperson/AE Mapping:
- If the user mentions "salesperson" or "AE" in the context of an `Account` or `Opportunity`, interpret this as a request for the "Primary Account Executive" field.
- Implementation: When retrieving `Account` or `Opportunity` records, include the Salesforce API field name for "Primary Account Executive" in the `fields` parameter (for example, `"PrimaryAccountExecutive__c"` or `"PrimaryAccountExecutive"`). *Note: You may need to use* `salesforce_crm_describe_object` *to confirm the exact API name of this field if it is a custom field.*
- CSM Mapping:
- If the user mentions "CSM" in the context of an `Account` or `Opportunity`, interpret this as a request for the "Primary Customer Success Manager" field.
- Implementation: When retrieving `Account` or `Opportunity` records, include the Salesforce API field name for "Primary Customer Success Manager" in the `fields` parameter (for example, `"PrimaryCustomerSuccessManager__c"` or `"PrimaryCustomerSuccessManager"`).
- *Note: You may need to use* `salesforce_crm_describe_object` *to confirm the exact API name of this field if it is a custom field.*
When to use – When querying Salesforce data with Salesforce CRM tools.
Update the Core Skill with additional information about how your organization uses Salesforce.
Salesforce CRM connector tools
After a Mark administrator connects and add the required skills and you log in to Salesforce , call the following tools in Mark.
Click a tool's name to expand it and learn when to use it, its required and optional parameters, and example prompts for calling the tool. If you do not provide a required parameter, Mark prompts you for it.
Objects
Use these tools to count, create, retrieve, and update standard and custom Salesforce records. Choose the tool that matches the operation you need to perform.
Custom objects
Custom objects are data structures your organization has added to Salesforce beyond the standard set. Use these tools to discover which custom objects exist in your org and to query or filter records within them.
Reports
Use these tools to find, inspect, and run existing Salesforce reports. Start with the salesforce_crm_list_reports tool to discover available reports. Use the salesforce_crm_describe_report tool to review a report's structure and available filters before running it. Then use the salesforce_crm_run_report tool to retrieve the data.
Use cases
Personalize content for new leads
Challenge – Marketing teams struggle to create and deliver personalized content to new leads, leading to generic outreach and lower engagement.
Solution with Mark – Mark can monitor Salesforce for newly created leads. Upon identifying a new lead, Mark automatically retrieves relevant details such as industry, company size, and expressed interests. Leveraging this data, Mark then drafts personalized marketing content, like a tailored email or a blog post summary, ready for review and immediate deployment by the marketing team. This ensures every new lead receives content that resonates, boosting engagement and qualification rates.
Automate content suggestion for sales follow-up
Challenge – Sales representatives spend time searching for appropriate content (case studies, product sheets, or demos) to share with prospects at different stages of the sales cycle, often leading to delays and inconsistent messaging.
Solution with Mark – As opportunities advance through Salesforce stages, Mark proactively identifies the need for follow-up content. Based on the opportunity's details (for example, industry, specific product interest, or identified pain points), Mark searches your Content Marketing Platform (CMP) for the most relevant assets. It then suggests these assets directly to the sales rep or even drafts a personalized email incorporating the content, streamlining the follow-up process and ensuring timely, relevant communication.
Streamline opportunity reporting
Challenge – Business users need quick, up-to-date insights into sales pipeline health and opportunity status, but compiling reports from Salesforce can be time-consuming and require specific expertise.
Solution with Mark – Ask Mark for a summary of open opportunities, top deals, or opportunities by stage. Mark queries Salesforce in real-time, aggregates the data, and presents it in an easily digestible format, such as a dynamic table or chart within a Mark canvas. This eliminates manual reporting efforts, providing instant, actionable insights for sales leaders and executives, unifying reporting into a single, accessible interface.
Proactive engagement for at-risk opportunities
Challenge – Sales teams often react to at-risk opportunities rather than proactively addressing potential issues, leading to lost deals. Identifying these opportunities early and knowing the best course of action is critical.
Solution with Mark – Mark continuously monitors Salesforce opportunities for signs of risk, such as prolonged inactivity, approaching close dates without recent engagement, or changes in competitor presence. When an at-risk opportunity is detected, Mark alerts the sales representative and suggests next-best actions. This could include drafting a re-engagement email, recommending a specific piece of content to share, or prompting a call with a key stakeholder, letting you proactively intervene to keep deals on track.
Competitive intelligence for sales pitches
Challenge – Sales representatives need quick access to up-to-date competitive intelligence to effectively position Optimizely's solutions during critical sales pitches, but this information is often scattered or difficult to retrieve on demand.
Solution with Mark – When a sales rep is preparing for a pitch, they can ask Mark for competitive intelligence related to a specific opportunity. Mark retrieves any competitor information stored in Salesforce for that opportunity and then leverages its extensive internal knowledge base (including up-to-date competitor analysis) to provide key differentiators, battle cards, and strategic talking points against the identified competitors. This empowers sales teams with instant, relevant insights to strengthen their pitches and close more deals.
Note
If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applications.