Menu

Integrate Flex with Zendesk

By deploying the new Zendesk CTI Flex integration, teams using Zendesk as their ticketing system can now interact with their customers across multiple communication channels. By allowing Flex to take care of the ticket housekeeping, teams can focus on solving customer issues.

This integration is Generally Available and supports the following features:

Search and Screenpop: Available across all channels. Use information gathered in the triage phase of customer interaction to automatically look up and display relevant Zendesk tickets or user records. 

Interaction logging: Automatically log Flex interactions into a related Zendesk ticket. 

Context Switching: Set your Zendesk Screen to change to a related Zendesk ticket or user automatically when you multitask.

Chat Transcripts: Automatically save Chat Transcripts for non-voice channels as Internal Ticket Comments.

Voice Recording: Enable Flex Voice Recording for inbound voice calls.

Configurable Ticket and User Creation/Display: Configure automatic ticket and/or user creation and navigation in response to Customer Engagements.

Click to Dial*: Let Agents place an outbound call with the click of a button. 

* This feature is currently in beta.

 

 

Configure Flex

Setup

Configure the Twilio Flex Zendesk Integration

1. Start by navigating to https://flex.twilio.com in Google Chrome.

2. Browse to Admin > Integrations.

3. Click on the Zendesk card to reach the configuration screen:

Twilio Flex Admin - Integrations - Zendesk

4. Configure your Flex Zendesk Integration according to your organisation’s requirements by setting some or all of the following parameters:

Parameter Name

Mandatory?

Description

Outbound Caller ID

Yes*

This will be the caller-Id used for outbound calls from the Flex-Zendesk Integration (via Click to Dial) if an Agent does not have a defined caller ID.

*If the Flex Dialpad is enabled, this option is not needed. You can configure the Dialpad to set your outbound caller ID.

Zendesk Base URL

Yes

Register your Zendesk domain(s) on the Flex Settings page in the Twilio Console. For more details, refer to Securely iframe Flex in your application.

Workflow SID

No

If you want to use a Workflow other than the default Workflow, specify its SID here.

If you are not sure what your Workflow SID is, leave this field empty.

Task Channel SID

No

If you want to use a Task Channel other than the default Voice Channel, specify its SID here.

If you are not sure what your Task Channel SID is, leave this field empty.

New ticket description

No

The description to be used by Flex for automatic Ticket creation.

New ticket subject

No

The subject to be used by Flex for automatic Ticket creation.

Automatic Logging

No

You can configure the task stages when task metadata should be logged as an Internal Note in the relevant Zendesk Ticket. You can choose any, or none, of these three stages:

  • Task Start: Log when an Agent accepts the task.
  • Task Switch: Log when an Agent selects the task. Particularly useful in multitasking setups.
  • Task Complete: Log when an Agent completes the task.

Log Chat details as Internal Note

No

Select this option if you want Chat transcripts for non-voice channels to be recorded as an Internal Note in the relevant Zendesk Ticket, when applicable. If selected, the transcript of the chat is stored in Zendesk when a task is completed.

Navigate

No

Select the nature of the Screenpop shown when an Agent accepts or selects a task. Available options are:

  • Display the Ticket on the Agent’s Screen.
  • Display the User on the Agent’s Screen.
  • Display nothing.

You can select different behavior for cases when the end-customer has provided a valid ticket number in the input.

Create

No

Select if and when you want a new Ticket or User to be created. For cases when an invalid Ticket number has been provided, or no Ticket numbers are provided, you can choose to:

  • Create a new Ticket.
  • Create a new User, if the end-customer is unknown.

When enabling any of the features that result in data being transferred over from Flex to Zendesk, you should be aware that any such data will be governed by Zendesk’s privacy policy.

You should also understand that once data has been copied to Zendesk, it is your responsibility to handle appropriately, and if necessary delete, any data that is copied from Twilio to Zendesk through the Flex App. This includes both data with personally identifiable information (PII) and data without PII.

Please read the Flex Zendesk Integration terms for details.

5. Enable your Zendesk Integration using the Status toggle:

Flex_Zendesk_EnableIntegration.png

Your Flex configuration is now complete. Now install the Twilio Flex App in your Zendesk Instance.

Install the Flex App in your Zendesk Instance

Install the Twilio Flex App in your Zendesk Instance

1. While you are logged into your Zendesk Instance/Domain/Org, navigate to Zendesk Marketplace and either search for Twilio Flex or navigate directly to the app by clicking this URL. Read the Description to learn more about the Twilio Flex App. When you are ready, click the Install button:

Twilio_Flex_App_Integration_with_Zendesk_Support_pic2.png

2. Continue with each of the steps show in the following screen. Modify the parameters if you need to:

Flex_Zendesk_UploadPrivate_3.png

These are are the parameters that you will or may need to change:

Parameter Name

Mandatory?

Description

Flex URL

Yes

This field tells the Twilio Flex App in Zendesk where Flex is hosted. Leave it as is if you are using Hosted Flex, or you are not sure what the correct value should be. If you are hosting Flex on your own infrastructure, you should change this to the URL of your Flex Instance.

The URL must contain ?path=/agent-desktop. Otherwise, Admin users will be unable to initialize the integration correctly.

https://flex.twilio.com/yourRuntime-Domain-3869?path=/agent-desktop

Flex Widget width

Yes

Specify, in pixels, the width of the Flex App within your Zendesk UI.

An important thing to consider when deciding width is that a wider Flex App is useful if you intend to use non-voice channels as it gives a better Chat Experience to your Support staff.

Flex Widget height

Yes

Specify, in pixels, the height of the Flex App within your Zendesk UI.

An important thing to consider when deciding height is that a taller Flex App is useful if you intend to use non-voice channels as it gives a better Chat Experience to your Support staff.

  • You do not need to change anything on this screen unless you want to customize it. If you are not sure about what values to enter, keep the default values.
  • Feel free to select role restrictions if you wish to restrict access to this app to selected Roles or Groups in your organization.

The Flex App should now be installed in your Zendesk Instance. Users with permitted Roles and or in permitted Groups will now be able to see the Flex App when they login to their Zendesk accounts:

flexdeskbeta_Installed_1.png

That’s it! See our guide on Call Flows to take it for a spin.

What’s next?

Now that you’ve integrated Flex into your Zendesk instance, learn more about customizing your integration and managing interactions with your users:

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 Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

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

Thanks for your feedback!

thanks-feedback-gif