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:
- Click + Create new Address from the Conversations Addresses tab.
- Select Chat as the Address type.
- You can optionally enter a friendly name.
- 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.
-
- 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 the demo app
The quickest way to test your Chat Address is by using our WebChat React demo app, which demonstrates a website chat widget built for Flex Conversations.
You will need the following for your Flex account:
- Account SID (get from the Account dashboard)
- Auth Token (get from the 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. To create a web channel for your Chat Address SID, see the WebChats Resource.)
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.
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.