Integrate Flex with Salesforce
With out-of-the-box support for Salesforce Open CTI, you can now power your Salesforce environment with omnichannel communications offered by Flex. Both Salesforce Classic and Lightning Experience integrations are supported, allowing you to use Flex directly within your Salesforce instance.
In this guide, you will learn how to configure Flex within Salesforce, configure outbound calling, enable SSO (Single Sign-On), and launch your integration.
Let's get started!
Info
Need to create a new Salesforce organization for your proof of concept? Create a Salesforce developer account at https://developer.salesforce.com.
The Flex Salesforce integration embeds the Flex agent user interface directly into the Salesforce application and creates a single source of truth for agents.
As part of the Salesforce integration, the following features are supported within Flex:
- Native Digital Engagement: supported interaction with customers on various communications APIs, such as Voice, Web Chat, SMS, and WhatsApp
- Personalization: route any Salesforce Object (case, lead, contact, or other custom object) and blend it with other channels
- Programmability: tailored look and feel of the application, possibility to code in adjustments
- Pre-built native features: click-to-dial, screen pop with search capabilities, context switching, activity logging, SSO integration
- Multiple deployment scenarios: Flex can be embedded inside of Salesforce, or Salesforce can be embedded within Flex
- Open your Flex Console .
- Go to Admin > Integrations .
- On the Salesforce tile, click Configure .
- Under Status , toggle the integration plugin on.
- Under Configuration , click Edit Configuration , and set up your Salesforce Integration for your organization with the following parameters:
| Parameter Name | Description |
|---|---|
| Workflow SID (Optional) | If you want to use a different Workflow than your default Workflow, enter the Workflow SID. If not, leave it empty. If you are not sure what this is, then leave it empty. |
| Task Channel SID (Optional) | If you want to use a different Task Channel than the default Voice Channel, enter the Task Channel SID here. If not, leave it empty. If you are not sure what this is, then leave it empty. |
| Salesforce Base URL (Required) | Register your Salesforce domain(s) on the Flex Settings page in the Twilio Console. For more details, see Securely iframe Flex in your application. |
| SSO | Select this option if you want to deploy the Flex-Salesforce Integration using Single Sign-On (SSO). Always check this option if you are operating in a production environment. Leave this unchecked if you are planning to test the integration using your Twilio Account or Project login credentials. |
| Log | Decide when you’d like to log a task in Salesforce: when a task starts, is completed, or switched. |
- Click Apply .
-
Optionally, under
Files
, click
Download
to view the Call Center Definition file for your Salesforce Call Center configuration. If you don’t download the files here, you can download them later from the Flex CTI Setup Wizard in Salesforce.
Tip You can right click and save the link to download the XML file directly.
Danger
Flex generates different Call Center Definition files depending on whether you choose to use SSO or not. If you indicated that you are planning to use SSO during the configuration step, you must update the "CTI Adapter URL" in your Call Center Definition file. Your file will contain: https://flex.twilio.com/yourRuntime-Domain-3869?path=/agent-desktop.
Update "yourRuntime-Domain-3869" to match your Twilio Flex Login Link. You can find this Login Link on the SSO Configuration page within the Twilio Console.
- Log in to your Salesforce instance.
- In the Salesforce AppExchange , search for Twilio Flex CTI connector .
- Click Get It Now to install the Flex CTI connector in your Salesforce instance.
- Select your installation preferences and click Install . Once installed, you’ll see the managed package show in your Installed Packages page in Salesforce.
- In Salesforce, click the App Launcher and search for Flex CTI .
-
In
Twilio Flex CTI for Salesforce
, select a configuration option. If you already have a Twilio and Flex account, enter your
AccountSID
, which you can find in
Console
.
Note
If you enter an incorrect AccountSID here, you will need to
uninstall the package
then re-install to configure with the correct AccountSID.
- Click Get Started .
- In the Setup Wizard , follow the steps to complete setup. You can choose steps for Lightning or Classic by selecting the tab at the top of the page.
Once setup is complete, Salesforce users in your Contact Center can see the Flex agent UI in your chosen App in Salesforce.
That's it! See our guide on Call Flows to take it for a spin.
- Copy Download Link feature does not work in Flex Insights when Flex is embedded within Salesforce
- When making an outbound call, ensure the relevant Salesforce record for the phone number is open before beginning the call. Otherwise, activity logs of the outbound call may not be reflected on the correct Salesforce record.
Agents must search for the Salesforce record of the relevant phone number before beginning an outbound call. This is to ensure the outbound call will be logged to the correct Salesforce record.
To uninstall the package in Salesforce, follow Salesforce’s Uninstall a Managed Package.
Now that you've integrated Flex with your Salesforce instance, learn more about customizing your integration and managing interactions with your users:
- Learn how to manage your Flex-Salesforce call flows
- Customize your Flex-Salesforce integration
- Check out the release notes for a complete list of supported features
- Securely embed Flex as an iframe