If you are looking to upgrade from a deprecated version (before v2.1) please review the upgrade notes which are located here.
Prerequisite: Zendesk TPE License
To use the Amazon Connect app with Zendesk Support you need a valid Talk Partner Edition (TPE) license. Without it the app will not be able to show (pop) a recognised user on incoming call, or create a ticket. Instead, it will display a warning similar to the screenshot below:
Please contact your Zendesk support team if you’re unsure about your TPE license status.
Installing the Amazon Connect app
You need to have administrator access in your AWS account in order to install the app.
Search for the Amazon Connect app in the Zendesk Marketplace and click on install.
Select the Zendesk instance you want to install this app in and click on install.
Configure the app’s settings
Configure the below settings for the app.
1. Amazon Connect URL
Enter the Amazon Connect URL that you want to connect with your Zendesk account.
When entering your Amazon Connect URL, make sure you omit /connect/login from the URL. For example, the URL for your Connect instance should be in the following format https://instance-name.awsapps.com, or https://instance-name.my.connect.aws
2. Single sign-on URL (optional)
This field is only required if your Connect instance is configured with single sign-on (SSO). Enter the SSO URL for your Connect instance from your Identity Provider (IDP). This is not the URL of the Amazon Connect instance.
3. AWS Region
The name of the Connect instance's region, eg. us-east-1.
4. Default entry point phone number
Enter the call centre number that will be reported in tickets as the number that the call was dialled from in outbound calls and the number that was called in inbound calls.
For inbound calls this can be overridden by setting the
dialed_number attribute in your contact flow. Likewise, for outbound calls it can be overridden by setting the
outbound_cli attribute with the value of
Queue Outbound Number system attribute in your outbound whisper flow. (see the sample outbound whisper flow available here)
5. Default country dialling prefix (optional)
If set, this prefix will be used when making outbound calls in Zendesk for users whose phone numbers are in your local format. E.g. adding +61 for Australia.
6. Connect time zone (optional)
Enter your time zone, eg. Australia/Sydney, so that the Contact Trace Records linked from within ticket comments will be displayed in your local date/time. If this is not specified it will default to UTC. You can view a list of the different time zones here.
7. Create ticket after minutes (optional)
This setting controls whether a recent ticket of a recognised caller should be opened instead of creating a new one. E.g. setting this to 15 means that a new ticket will be created if there hasn’t been a ticket created or updated in the last 15 minutes for that user. It can be overridden by setting the
recent_ticket_timeout attribute in your contact flow.
8. Contact attribute name containing Zendesk ticket number (optional)
If this attribute is set in a contact flow the ticket number specified will be opened, instead of creating a new one.
NOTE: the name of this attribute can be changed in the corresponding app setting.
9. Enable media-less mode (optional)
Select this option if you are using your Zendesk account in a VDI environment. This option will also allow you to reload your Zendesk instance without interrupting a live call as well as preventing duplicate tickets from being created if you have more than one tab of Zendesk open in your browser. See detailed steps further in this document on how to sign in to Zendesk if you have media-less mode enabled.
If you have media-less mode enabled, ensure you first log in to the CCP in an independent window or tab before launching this app in Zendesk, otherwise the app will not function correctly.
10. Configure remote logging (optional)
Remote logging facilitates troubleshooting of hard to reproduce, client-specific issues out. This capability comes with the following features:
Disabled by default: Upon installation (or upgrade from a previous version), app logging is turned off. No logging will take place until the client explicitly turns it on.
Redacted by default: when the client turns on the remote logging, all PII data contained in logs will be scrubbed - their contents replaced by a string
[redacted]. Redaction can be turned off in non-production environments where only test (mock) data is used.
Extensible redaction configuration: redaction algorithm will automatically scrub PII data commonly found in Zendesk CRM data store. In addition, client can specify their own rules for redaction in a configuration file. See more details.
11. Enable Role & Group Restrictions
If you wish to have granular permissions to only allow certain groups or roles, access to this app, please configure them here.
Whitelist URL’s in Connect
Click on the Amazon Connect app icon in the top right corner of your Zendesk instance.
The app will display two URLs which need to be whitelisted in your Connect instance.
Sign in to your AWS account, go to Amazon Connect and click on your Connect instance. Click on application integration on the left hand side menu.
Click on add origin.
Copy one of the URLs from the app’s loading screen and paste it into the field. Click on add.
Click on add origin again. Copy the other URL from the app’s loading screen and paste it into the field. Click on add.
Refresh your Zendesk instance. Click on the Amazon Connect app icon in the top right corner of your Zendesk instance. A new tab will open. Enter your Amazon Connect username and password and then click on sign in.
After you have successfully signed in to Amazon Connect the tab will automatically close. The Amazon Connect app should now load in Zendesk.
You are now ready to receive inbound calls and make outbound calls within Zendesk using the Connect softphone.