Migrate from Legacy Messaging

Flex Conversations requires Flex UI 2.0. If you are on Flex UI 1.x, please refer to Chat and Messaging pages.

To migrate an account from Flex Legacy Messaging to Flex Conversations, start by going through the Conversations prerequisites and updating your account configuration accordingly.

Migration steps for each Address

Each Address on Flex Legacy Messaging can be migrated over to Conversations at its own time and individually.

The following is only available for migrating Addresses without production traffic. Instructions for production Address migration are coming soon.

Before migrating a Legacy Address over to Conversations, notice the following:

  • Long-lived is not supported out-of-box in Flex Conversations
  • If using a Studio Flow, make sure the “Incoming Conversation” trigger is mapped.
  • If you have a webhook configured to handle the contact, the code in your webhook endpoint may need to be migrated
    • If you are creating a Task, you should instead create an Interaction. See Interactions API for more information.
    • If you are invoking any Programmable Chat or Proxy API, you may need to replace it with Conversations API invocations.
  • If you are using integration type “Task”, you may want to look at how to implement the outbound use cases by referring to creating outbound interactions. Flex Conversations doesn’t currently support the Task integration type - you should replace it with Studio or webhook.

Steps to migrate an Address

  1. Make sure the Address has no production traffic
  2. Remove the Legacy Messaging Address (Flex > Manage > Messaging > Legacy, find your Address, delete it)
  3. Create a new Conversations Address for that same Phone Number or WhatsApp Number (see the steps to create an SMS or a WhatsApp Conversations address via the Flex Console or the API)
Rate this page:

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.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!