Skip to main content

Deploy Copilot to Salesforce

How to use Fin Copilot for Salesforce to enable AI-powered teammate support.

Updated over 3 months ago

Copilot gives every Salesforce agent a personal AI assistant. Enabled by Fin, it surfaces AI-generated replies from across your support content and past cases—speeding up responses and improving consistency without changing how your team works.

Key benefits / use cases

  • AI-powered teammate support directly within Salesforce.

  • Faster response times with answers powered by Fin’s training.

  • Flexible teammate permissions to control who can use or manage Copilot.

  • Simple reporting tools to track Copilot usage and impact.


How to deploy Copilot to Salesforce

1. Connect to Salesforce

Navigate to Deploy > Copilot in your Fin workspace and connect to your Salesforce production.

This is the same API connection used by Fin for other Salesforce channels, so you might already have it connected.

2. Install the Fin Copilot app in Salesforce

To use Copilot, you must install the app in Salesforce:

  1. Click Install the app in Salesforce to initiate installation of the app.

  2. Select Install for all users. You'll be able to choose which agents should have access later in the setup.

  3. (Recommended) Under “Advanced Options” select Compile only the Apex in the package.

  4. Click Install and grant access to the trusted sites required by the package. This allows Fin to send and receive data from Salesforce.

  5. Wait until it finishes - no errors should be shown.

Note:

  • Salesforce compiles Apex classes during package installation. You may need to upgrade your Salesforce tier to be able to use Fin Copilot for Salesforce which relies on Apex classes.

  • Installation may take up to 30 seconds, but sometimes longer depending on how many Apex classes in your org.

  • Salesforce will send you an email when installation completes, so you can leave and come back to this step while you wait.

Return to Deploy > Copilot in your Fin workspace to check the “Install the Copilot app in Salesforce” is marked as Done.

You can select Manage app in Salesforce to open Salesforce’s Installed Packages page. Here, you should see Fin Copilot for Salesforce.

3. Add custom settings to Salesforce

For Copilot to be embedded in Salesforce, some custom settings need to be added to your Salesforce workspace:

  • Frame URL: Copilot sends a request for each different region. The frame URL allows Copilot to support multi-region.

  • Your Fin app ID code: Allows Copilot in Salesforce to identify this Fin workspace.

  • Your Fin app private key: Allows Copilot to create a JWT to confirm to Salesforce that its coming from an authorized client.

All you need to do is click Add settings to Salesforce to send an API request. You’ll then be able to see and manage the settings that have been added in Salesforce.

4. Edit your Salesforce page layout to display the Copilot app

Now you've installed the Copilot app in Salesforce, edit your page layout so you're able to access it.

  1. Go to Salesforce Settings on your Case or Messaging Session page and select Edit Page. This requires the correct admin permissions in your Salesforce account.

  2. Search for the Fin Copilot component and drag it into your layout.

  3. You can set the Fin Copilot component visibility by adding filters to restrict Copilot usage to certain agents/operators.

  4. Then click Save and refresh the page to confirm it appears correctly.

5. Enable Lightning Web Security

This allows your agents to add Copilot responses directly to the composer. If the setting is already applied, click Save and refresh.

Fin automatically checks Lightning App Pages to detect whether the Copilot component is present. The deployment step will change to Done once applied.

6. Select which teammates have access

Copilot costs $35/month per teammate, so you must select which Salesforce agents you’d like to have access. You can give access to Copilot only, or also invite agents to your Fin workspace for those who need to manage Copilot’s training and performance.

Assign Copilot to existing teammates

Go to Settings > Teammates in your Fin workspace. In the Fin Copilot seat column, assign seats to teammates who need access.

Enable Copilot for new teammates

Go to Settings > Teammates in your Fin workspace and click New teammate. Enter the teammate’s email address then select the Copilot Seat option.

You can choose to give teammates one of the following access levels to your Fin workspace:

  • Full Access: Manage training, deployments, and all Fin settings.

  • View Only: View training, test Copilot, and access reports.

  • No Access: Use Copilot in Salesforce only, without access to your Fin workspace.

Invited teammates will receive an email to join Fin and they can create a password and sign in.

They'll be given options of what they can log into, depending on the level of access they were granted.

  • Teammates who were only invited to use Copilot with "No Access" to your Fin workspace, will be directed to Salesforce.

  • Teammates who were given "Full Access" or "View Only" permission to your Fin workspace will see an option to log into Fin and an option to log into Salesforce and use Copilot.

Configuring SAML (optional)

If your team uses SAML for authentication, you can configure it for Fin Copilot even though the official Okta app is not supported at this time.

You can still enable SAML by following our SAML setup instructions and adding an additional ACS URL.

You must add a custom SSO / ACS URL using one of the following values, depending on your region:

Replace :app_id_code with your Fin workspace ID.

All other configuration steps follow the standard SAML setup process described in our SAML article.

7. Use Copilot in Salesforce

Once a Copilot invite has been accepted, teammates can access the Fin Copilot app from a Salesforce Case/Messaging Session page (if you added the component to these page layouts). They'll be asked to sign in to their Fin account to start using the app.

Now they can ask questions and Copilot will utilize the training it’s been given in your Fin workspace to provide answers.

Note: Fin Copilot currently doesn't apply any Guidance or Data connectors you've trained Fin AI Agent with.


Train Copilot

Go to the Train > Content section in Fin and open the content source you want to enable for Copilot.

Select content items in bulk and click Change Fin Copilot state then click Enable for Fin Copilot.

Enable case history from specific agents

From the Train > Content section, you can also select Case history from Salesforce and enable the toggle to sync history.

Choose to Sync all or Sync a selection and then filter case history based on attributes.

Your case history can then be enabled for Copilot too. When helping your agents answer questions, Copilot will look through your teams’ conversation history from the last 120 days to find previous answers. This can be limited to specific teammate conversations (e.g. your more tenured support agents).

Note: Personal information in conversations will be redacted from answers wherever possible. However, we recommend answers should always be reviewed by agents prior to sharing.


Preview Copilot

To preview Copilot, go to Train > Content in Fin. Select Fin Copilot using the dropdown on the interactive preview. This provides an accurate representation of Copilot’s training, so you can understand the way it will answer your agents in Salesforce.

You can also specify which sources you want Copilot to use when generating an answer.


Copilot reporting

To view Copilot reporting, go to Analyze > Custom Report in Fin.

If you haven't edited this report before, you’ll find a default section at the bottom called “Fin Copilot” which includes the following charts:

  • Copilot questions

  • Teammates using Copilot

  • Copilot content performance

If you've edited your custom report, you'll need to add these charts in. To do this, hit Edit and then add a chart and search for Copilot to add your own metrics or visualizations.


FAQs

Can I control which content Copilot uses?

Yes. Use the Fin Copilot state toggle in Fin’s Content section to control access to sources. Copilot will respect any audience rules you've applied to content (i.e. only use content that's relevant for the customer a teammate is talking to). You can also limit which teammate cases are used.

How quickly will Copilot ingest new Salesforce cases?

The last 120 days of Salesforce cases are ingested initially and then subsequent cases are ingested on a daily basis if the "Copilot can use conversation history" option is enabled:

To ensure efficiency and scalability, advanced algorithms are used to process a select subset of cases. This approach maintains optimal performance while handling a large volume of data.

Did this answer your question?