Menu

Customize your Flex-Salesforce Integration

The setup and configuration outlined in Create your Flex-Salesforce Integration and Manage Flex-Salesforce Call Flows describe how to get up and running with the default behavior in mind. However, you might want to customize both this integration experience as well as call flows.

Do you still need to set up your Flex-Salesforce Integration? Check out our guide for configuring your Salesforce instance for Flex!

In this guide, we will walk through how to customize the default call flow in your Flex-Salesforce integration by

  1. Creating an IVR (Interactive Voice Response) to collect a case number from our caller
  2. Looking up an existing case, or
  3. Creating a new case from the caller's input if there is no pre-existing case

To accomplish this, we'll need to do the following:

  1. Create a Studio flow to introduce IVR and collect a Case Number from the caller
  2. Pass Salesforce's Case object to the Flex-Salesforce integration by using a custom Task attribute called sfdcSearchString
  3. Re-configure the Salesforce Softphone layout to point to the Case Object

Remember: Flex is a Programmable Application Platform, so you can customize Flex to any extent using the Flex Plugin Model, and those changes will be reflected in your Salesforce integration as well. The customizations in this guide refer to the enhancements in both the integration and the call flow itself.

Create a Studio IVR flow

From your Twilio Console, create a Studio flow, or edit an existing studio flow by doing the following:

  1. Add a Studio widget to Gather input on a call to collect user input for a given Case ID (if one exists). Let’s call this widget getInput.
  2. On the 'User Pressed Keys' transition, connect this widget to the Send to Flex widget.
  3. Pass {{widgets.getInput.Digits}} to the sfdcSearchString task attribute, making sure that the default type and name attributes exist.
  4. The final Studio Flow will look like this:
    Create a studio flow for your Flex IVR.

Configure the Softphone layout for the Case object

The way to tell Salesforce which object to use for Search and Screen Pop is through the Softphone layout.

We will configure the softphone layout to refer to the Case object instead of the default Contact object.

For inbound calls:

  • Change the order of objects to move Case to the top
    Flex-Salesforce: Move Case object to top.
  • Change the Screen Pop settings to point to Case object:
    Change the Screen Pop settings to point to the Case object.

Create a new matching record without Phone information

A Phone attribute is always sent from the Flex plugin to Salesforce when creating a new record. However, specific records like Cases are not linked to a given phone number.

Depending on your Softphone layout configuration, you can disable providing this information by adding an extra sfdcIncludePhoneInPopToNewRecord task attribute and setting that to false.

sfdcIncludePhoneInPopToNewRecord

Resulting Call Flow

Now, when a caller provides a Case ID using their keypad upon being prompted by the IVR, that Case ID is used to search for the case and render the Screen Pop to the relevant Case record.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.

Thank you for your feedback!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

Refer us and get $10 in 3 simple steps!

Step 1

Get link

Get a free personal referral link here

Step 2

Give $10

Your user signs up and upgrade using link

Step 3

Get $10

1,250 free SMSes
OR 1,000 free voice mins
OR 12,000 chats
OR more