Configure the Zendesk app


Note: This article applies to Genesys Cloud for Zendesk.

After you install Genesys Cloud for Zendesk, you can configure basic settings for the app.

  1. In the left navigation pane in Zendesk, click the Genesys Cloud icon.
  2. Click App Configuration.
  3. Configure the following settings:
    • Genesys Cloud Environment is the domain that the app uses.

      The integration must reference the region where your Genesys Cloud organization is located. Otherwise, anyone using your organization, including agents, cannot log in. By default, the integration points to US East.

      Modify the URL that appears under Genesys Cloud Environment based on where your Genesys Cloud organization is located.

      Genesys Cloud region AWS region Domain
      Americas (Canada) Canada (Canada Central) apps.cac1.pure.cloud
      Americas (US East) US East (N. Virginia) apps.mypurecloud.com
      Americas (US West) US West (Oregon) apps.usw2.pure.cloud
      Asia Pacific (Seoul) Asia Pacific (Seoul) apps.apne2.pure.cloud
      Asia Pacific (Sydney) Asia Pacific (Sydney) apps.mypurecloud.com.au
      Asia Pacific (Tokyo) Asia Pacific (Tokyo) apps.mypurecloud.jp
      EMEA (Dublin) EU (Ireland) apps.mypurecloud.ie
      EMEA (Frankfurt) EU (Frankfurt) apps.mypurecloud.de
      EMEA (London) EU (London) apps.euw2.pure.cloud
    • Auto Redirect to SSO allows you to use a single sign-on identity provider.

      By using a single sign-on identity provider, an agent can sign in to one application such as Okta and then is automatically logged in to the client. For information about the single sign-on providers that Genesys Cloud supports, see About single sign-on (SSO).

      If you select Auto Redirect to SSO, all agents in your organization must use the single sign-on identity provider that you input.

      1. In the SSO Identity Provider Name box, input the name of the single sign-on identity provider that you want to use.

        For a list of valid values, see the provider parameter at Additional Authorization Parameters in the Developer Center.

      2. In the Genesys Cloud Organization Name box, input the name of the Genesys Cloud organization that uses this single sign-on identity provider.
      Note: If your single sign-on identity provider does not allow the single sign-on redirect window to be embedded, then select Dedicated Login Window. Otherwise, when you log in, the client will not load. Instead, you see a blank area on-screen and an error message in the console.
    • Dedicated Login Window causes a separate login window to open.

      This separate window allows you to use login providers that do not work in embedded windows. In this window, you can sign in using Genesys Cloud credentials or credentials for other providers that you configured in your Genesys Cloud organization. For information about the single sign-on providers that Genesys Cloud supports, see About single sign-on (SSO).

      Tip: To reopen or bring the focus to this window, click Open Authentication Window in the client. 
    • Call History allows agents to view their call history in the client.

      For more information, see Access call history.

    • Server-Side Logging allows Genesys Customer Care to access server-side logs directly.

      By default, logs appear in your browser console that you can use to troubleshoot issues. With this setting, you can configure Genesys Cloud for Zendesk to save logs server side. Customer Care can then access these logs directly.

      Tip: If you have a slow or unreliable Internet connection, or you risk running out of session storage, Genesys recommends that you do not select Server-side logging.
  4. Click Save

App Configuration settings in Zendesk

For the other settings, see Settings in Genesys Cloud for Zendesk.

For more information about the integration, see About Genesys Cloud for Zendesk.