Menu

Manage Conversations Chat Addresses

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

When a new Flex account is created, one default Chat Address will be created out-of-the-box. Refer to the Test a Chat Address section below for information on how to use it with the demo application.

At some point, you might need additional Chat Addresses to handle your traffic. For example, you might be running multiple websites, or might be rendering your website in multiple languages and might want to route conversations differently per language.

In this case, we recommend creating a separate Chat Address for each use case.

Create a Chat Address via Flex Console

You can create Chat Addresses via Flex Console > Manage > Messaging:

  1. Click + Create new Address from the Conversations Addresses tab.
  2. Select Chat as the Address type.
  3. You can optionally enter a friendly name.
  4. Configure the integration to Flex - either by using Studio or Webhook. The most common configuration is to integrate a Chat Address to Flex using a Studio Flow. Unless you have removed or reconfigured it, you should be good to use the out-of-box Studio Flow “Chat Flow” (or “WebChat Flow”). To learn more about configuring Studio Flows, see Configure pre-agent workflow with Studio.
    • Screen Shot 2022-03-16 at 12.00.26 PM.png
  5. Click Submit to save your new Flex Chat Address.

You can edit or delete Chat Addresses at any point using the Flex Console.

Test a Chat Address with demo app

The quickest way to test your Chat Address is using our WebChat React demo app, a React App that demonstrates a website chat widget built for Flex Conversations.

You will need the following for your Flex account:

  • Account SID (get from Account dashboard)
  • Auth Token (get from Account dashboard)
  • API Secret (get from Account > API keys & tokens; create a new API key if you don’t yet have one and make sure you save the secret)
  • Conversation Service SID (ISxxxxxxxxxxxxxxxx; find the default Conversation Service from Conversations > Manage > Defaults)
  • Chat Address SID (IGxxxxxxxxxxxxxxxx; create a Chat Address in Flex > Manage > Messaging > Conversations, or copy a SID of an existing Chat Address)

Once you have all of your credentials, head over to the Webchat React demo app repository provided by Twilio to let you test your integration. Follow the instructions in the README.

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!

thanks-feedback-gif