Downgrade to Flex UI 1.x and Legacy Messaging
In order to successfully downgrade from Flex 2.x, please follow these steps.
Convert Conversations Addresses to Legacy Messaging
When you downgrade from Flex UI 2.0, you will need to convert Conversations Addresses to Legacy Addresses in your account as Conversations is only available for customers using Flex UI 2.0 and up.
- Navigate to Flex > Manage > Messaging in the Twilio Console and select the Conversations Addresses tab. Take note of the Address details before deleting each Conversation Address as you will need to recreate them in the Legacy Addresses tab.
- Notice the Address type filter - go through the Address types, remove Conversations Addresses for all types (by default, there is one SMS Address and one Chat Address).
- Select Legacy Addresses and click Create new Address.
- Create your Legacy Addresses to match the former Conversations Addresses.
- Follow the steps on Manage SMS Addresses (skip buying a number, as you want to reuse the existing one(s)) and Manage WebChat Addresses respectively.
The Twilio Webchat React repository is only compatible with Flex 2.0. Flex UI 1.x uses the legacy webchat widget.
Configure Studio Flow
When creating a Legacy Address, you can reuse the same Studio Flow previously associated with a Conversations Address. Confirm that the Send to Flex widget is connected to the Incoming Message trigger and that it uses the attributes structure for Messaging and Chat Studio Flows. Original out-of-box Studio Flows are configured like that by default.
Downgrade Flex UI and Plugins
Flex UI 1.x uses React 16.5.2
by default. If your plugin was built on a later version of React and you downgrade the UI without disabling your existing plugins, your Flex instance will no longer be functional. Follow these steps to update your plugin:
Before you downgrade to Flex UI 1.x, verify that all ongoing chat, SMS, or WhatsApp tasks are completed.
- Navigate to the Flex Admin dashboard and select Developer Setup.
- Select the plugin you want to use and change the status to Disabled. You will need to do this with all of the plugins installed on your account.
- Once the plugins are all disabled, you can downgrade your UI version: From the Flex Versioning and updates page in the Admin dashboard, select a 1.x.x version from the version list. To pin to a specific Flex UI version, see "Flex UI Versioning" on the Flex UI Core Concepts page.
- Enable your plugins again by navigating to Developer Setup and clicking on the plugin.
- Select Enable.
- To update the React version of the plugin to be compatible with Flex 1.x, change the version of React in your package.json file to
16.5.2
. - Click Save to apply the change.
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.