Skip to contentSkip to navigationSkip to topbar
On this page

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:

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.

Twilio Flex (Zendesk Marketplace)(link takes you to an external page)

Setup

setup page anchor

Configure the Twilio Flex Zendesk Integration

configure-the-twilio-flex-zendesk-integration page anchor
  1. Start by navigating to https://flex.twilio.com(link takes you to an external page) in Google Chrome.
  2. Browse to Admin > Integrations(link takes you to an external page) .
  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 NameMandatoryDescription
Outbound Caller IDYes*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 URLYesRegister your Zendesk domain(s) on the Flex Settings(link takes you to an external page) page in the Twilio Console. For more details, refer to Securely iframe Flex in your application.
Workflow SIDNoIf 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 SIDNoIf 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 descriptionNoThe description to be used by Flex for automatic ticket creation.
New ticket subjectNoThe subject to be used by Flex for automatic ticket creation.
Automatic LoggingNoYou 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 NoteNoSelect 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.
NavigateNoSelect 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.
CreateNoSelect 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.
(error)

Danger

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(link takes you to an external page).

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.

  1. Enable your Zendesk Integration using the Status toggle:

    Flex_Zendesk_EnableIntegration.

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

Install the Twilio Flex App in your Zendesk Instance

install-the-twilio-flex-app-in-your-zendesk-instance page anchor
  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(link takes you to an external page) . 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.
  1. Continue with each of the steps show in the following screen. Modify the parameters if you need to:
Flex_Zendesk_UploadPrivate_3.

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

Parameter NameMandatory?Description
Flex URLYesThis 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(link takes you to an external page)
Flex Widget widthYesSpecify, 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 heightYesSpecify, 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.
(information)

Info

  • 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.

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


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

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.