Zendesk is migrating all live chat accounts to Chat Phase 4, an enhanced Chat experience which moves live chat functionality from the chat widget to the Web Widget (Classic).
Currently, migrating to Chat Phase 4 is optional. However, we recommend making the move sooner rather than later, to give yourself and your team plenty of time to complete the migration tasks.
Before upgrading from Legacy Chat to the enhanced experience, you need to make a few changes to your account. These tasks are required to merge some of the Chat and Support data that is currently separate on your Legacy Chat account, but will be shared in the new configuration.
This article describes the steps your account administrator must take prior to upgrading a legacy live chat account to the enhanced experience.
This article contains the following sections:
Initiating the migration process
Until November 15, 2022, you’ll need to request migration assistance from your account representative. We’ll schedule an upgrade date and time, and notify you through email and in-product messaging soon after. After this date, you will be automatically upgraded before the end of 2023. Notices for your upgrade date and time will be sent to eligible customers in advance through email and in-product messaging. These steps will need to be completed ahead of the date provided..
Confirming agent email addresses
Because the enhanced Chat experience makes Chat functionality available through a shared Support channel, each agent will login through a single email address for Chat and Support. To do so, we will need to correctly identify your agents’ expected login information, then merge their agent information.
To ensure that we’ve done so correctly, you will need to review email addresses after you have received your migration date and time. Otherwise, the merge will be done on your behalf ahead of your scheduled migration.
To confirm your agents’ email settings
- Sign in to your Chat dashboard and click Settings > Agents > Needs Review.
On the Needs Review page, you can expect to see a full list of agents and their existing product access. We have already confirmed some agents for you (denoted by the green checkmark against their name). These are agents who work in both Support and Chat using a single email address. For all other agents, you will need to proceed with step 2.
- Click on an agent name.
- Choose an Agent Type from the scenarios listed below.
- Click Confirm.
Scenarios
For all of the scenarios in this section, admins should confirm that each agent’s settings are correct:
- Is the agent Chat-only, Support-only, or Chat and Support?
- Are their Chat and Support accounts correctly linked?
See the configuration scenarios described below to determine what changes, if any, you or your agents need to make.
- Scenario 1: Agent works in both Support and Chat using a single email address
- Scenario 2: Agent is Chat-only
- Scenario 3: Agent is Support-only
- Scenario 4: Agent works in both Support and Chat using two different email addresses
Scenario 1: Agent works in both Support and Chat using a single email address
Example: Agent 1 handles customer support requests that come in through the Chat channel, and through the Support channel. The agent logs in to Chat and Support separately, but uses the same email address to log in to both.
What we’ll do: We will automatically identify Chat and Support accounts using the same email address, then merge them for you.
What admins need to do: Confirm that your agent settings are correct, and update if necessary.
What agents need to do: Agents will sign in with their Support credentials after the upgrade is complete.
Scenario 2: Agent is Chat-only
Example: Agent 2 handles only customer requests that come in via Chat. They have no user profile in Zendesk Support.
What we’ll do: We will automatically create a new agent on the Support side in the upgraded account, using the existing email address and agent alias.
What admins need to do: Confirm that your agent settings are correct, and update if necessary.
What agents need to do: Agents will receive an email to create a new password after the upgrade is completed. They will need to click on a link in the email and follow the instructions to reset their password.
- Deleting the Chat agent completely; or,
- Updating that Chat agent’s email address
Scenario 3: Agent is Support-only
Example: Agent 3 handles only customer requests that come in via Support. They have no user profile in Zendesk Chat.
What we’ll do: We will move the agent’s email address and user ID to the upgraded account.
What admins need to do: Confirm that your agent settings are correct, and update if necessary. No action is required on the Needs Review page.
What agents need to do: Agents will sign in to the upgraded account using their current email and password.
Scenario 4: Agent works in both Support and Chat using two different email addresses
Example: Agent 4 handles customer support requests that come in through the Chat channel, and through the Support channel. The agent logs in to Chat and Support separately, and uses one email address to log in to Chat (i.e., chat.agent.4@youraccount.com), and another to log in to Support (i.e., support.agent.4@youraccount.com).
What admins need to do: Identify agents that fall into this category and choose a corresponding Support agent to merge with this Chat agent. Select the email address associated with their Support account.
What agents need to do: After the migration, agents will use their Support credentials to sign in to the upgraded account.
Checking your IP restriction settings
To check and update your IP restriction settings
- Sign in to your Chat dashboard, then go to Settings > Account and click the Security tab.
- Note the IP addresses included on your restriction list. These are the IP addresses that can access your Chat dashboard and account pages.
- Next, click the Zendesk Products icon (
) in the top bar, then select Admin Center. - Click the Security icon (
) in the left sidebar, then click Advanced. - Click the IP Restrictions tab. Note the IP addresses included in the Allowed IP ranges list. These are the IP addresses that can access your Zendesk products, including Chat after your account is upgraded.
- Make sure any IP addresses from the Chat IP list are included in the Support IP list.
- If you have added any IP addresses to the Support IP list, click Save.
Adding Chat-only agents to your SAML provider (Professional and Enterprise plans)
If you have SAML authentication enabled for your Support account, you’ll need to assign the authentication to your Chat-only agents before they can sign in to the enhanced experience. See Assigning SAML SSO to users for more information.
(Recommended) Updating to the integrated Web Widget (Classic)
To provide a smoother experience for your customers when the upgrade occurs, you will need to update your Chat service to the Web Widget (Classic).
To know which widget experience is enabled for your Chat account, see Which widget to I have with my Zendesk account and website?
In all cases, the account will switch to the new Web Widget (Classic) experience after the upgrade.
- If you have already set up a Web Widget (Classic) when the account switch occurs, the Web Widget (Classic) experience will reflect your existing configuration.
- If you have not set up a Web Widget (Classic) when the account switch occurs, a Web Widget (Classic) will automatically be created for you with the latest integrated Chat experience enabled.
I'm already using the Web Widget snippet
No action is required. When the account switch occurs, the Web Widget (Classic) experience will reflect your existing configuration.
However, if you are using a Content Security Policy (CSP), we recommend that you make sure it is updated to support the Web Widget (Classic) experience going forward. See our developer documentation, Content Security Policy (CSP) support, for more information.
I'm using the legacy Chat (Zopim) snippet
You will need to move to the integrated Web Widget (Classic) on your help center or website before the upgrade. you can minimize the impact on your agents’ workflow, as well as your customers’ experience.
What will change?
- The Chat look and feel will change slightly.
- The majority of the Chat APIs will continue to work. However, certain Javascript APIs will no longer work. Most importantly, If you are using the legacy ‘setNotes’ or ‘appendNotes’ API see Migrating from the setNotes an appendNotes API for more information on mitigating the impact on your workflow.
- If you have multiple channels enabled in the Web Widget (Classic), such as help center, Support, or Talk, and want to only feature live chat on certain pages, then you can use the suppress Javascript API to suppress other channels, except live chat, on those pages. See Making the Web Widget (Classic) Chat-only for information.
For more details, please see the article on Feature differences.
See Configuring components in the Web Widget (Classic) to learn more about configuring different channels in the Web Widget (Classic) beyond live chat.
Enable account assumption
We want to ensure that the migration is successful at our first attempt. This means we may need to troubleshoot problems on the fly. Please allow Zendesk to access your account as an agent for the duration of the migration. Granting access does not affect your license, or your available agent seats.
To grant temporary access to your account, see Granting Zendesk temporary access to your account.
Next steps
Once the tasks in this article have been completed, you’re ready to start the migration.
While you wait, you can familiarize yourself with the changes you’ll see in your account post-migration, read the migration FAQ, and learn about the differences between your old and new chat phases.
Once you receive notice that your upgrade is done, follow the instructions in Completing the upgrade to Chat Phase 4.
0 Comments
Please sign in to leave a comment.