How to Configure Web ChatThis procedure explains how to configure a chat scenario, chat service, and chat scenario entry point to work together to display a chat widget on your website. By the end of this procedure, you should have a working chat widget on a webpage that connects customers to your contact center.# Give the scenario a unique name (e.g., "Super Chat") and click '''Save'''. Your new scenario will appear in the list of scenarios.# If there are no existing services of type “Chat,” you have to create one.# Next, you need to assign a team, an administrator, and a reviewer (optional) to the service. This is done in the ''Assignments'' tab.[[File:CCA-Services-Chat-Assignments-Tab-54.PNG|thumb|800px|center|Assign a team and administrator to the service]]# If there are no existing chat scenario entries shown, you have to create one.# In the Properties tab, fill in the properties as appropriate (see below for required and optional properties). For definitions, see the ''Contact Center Administrator Guide'', section [[Contact-center-administrator-guide/Messaging|Messaging/Chat]].* '''Name''' - The unique name (any) of the chat scenario entry (e.g., "Redwood Chat")* '''Unique identifier''' - An automatically generated, long string of characters that identifies the chat entry (e.g., "1f03f4090e4b4ffe8bb55365812e7a06")* '''Scenario''' - Choose the Chat Scenario you selected or created in step 1 of this procedure (e.g., "Super Chat"). This is where the parts come together to make chat possible.* '''Service''' - Choose the Chat Service you selected or created in step 2 of this procedure (e.g., "Pacific Chat"). This is where the parts come together to make chat possible.The remaining properties are optional at this time. You can come back to them later.* '''Default service for voice callback''' - Select a voice service if your agents will need to make a call (note: it needs to be a voice service).* '''Merge sessions for identified contacts''' - This checkbox is what makes omnichannel possible (i.e., a recognized Facebook Messenger chat session or a recognized phone number can be merged together).* '''Web HTML snippet''' - Come back to this button after you have completed and saved all your properties options. The HTML snippet is what you will be embedding into your webpages in order to make chat functional* '''Full chat code for local hosting''' - Click this if you will be customizing chat and hosting it on your own website. Bright Pattern provides this code for customers whose websites do not accommodate integration with Bright Pattern chat.* '''Requested skills''' - The auxiliary skills that agents need in order to accept a chat* '''SMS/MMS access numbers''' - Phone numbers that will be used for receiving/sending SMS/MMS messages from/to customers. All incoming messages to this account will start the chat scenario. If no such accounts are not selected here, your scenario is strictly web chat.* '''Messenger Accounts''' - The social messenger accounts that will be used for receiving/sending messages from/to customers. All incoming messages to this account will start the chat scenario. Note that in order to use messenger accounts, messenger integration accounts must be configured for your contact center. If no such accounts are not selected here, your scenario is strictly web chat.* '''Bot / Chat suggestions engine''' - The engine that will provide suggested replies to the agent during chat. Note that in order to use a bot/chat suggestions engine, you must have an integration account configured for your contact center.* '''Connect agent by phone automatically''' - When selected, this option enables automatic connection of an agent to a phone number that a customer sends. If not selected, the agent must take the additional step to dial a number manually.* '''Connect after delay of''' - If Connect agent by phone automatically is selected, you may configure a delay (in seconds) for the connection between agent and customer. * '''Queueing priority''' - The priority level of the customer in the queue (e.g., “1” is high priority, “3” is low, etc.). Leave the queuing priority as-is unless you want to de-prioritize the caller.* '''Chat nick for system messages''' - The name for this scenario entry that will be shown with system messages sent to customers in the chat (e.g., “Redwood Customer Service has joined the chat!”)* '''How long an agent could wait for reply before chat times out''' - The amount of time (in minutes) between replies for the session to timeout* '''How long a client browser may stay unresponsive before chat times out''' - The amount of time (in minutes) that the browser has been idle for the session to timeout. Note: If you are in an area where service is bad, you may want to increase the timeout.* '''Visible to agents''' - When this checkbox is selected, this scenario entry will appear as an entry for all new chat sessions and chat transfers (e.g., agents can receive the chat from a different service). Note that services are added in the Directory folder.* '''Scenario parameters''' - This section will be deprecated.* '''Chat session icon''' - Allows you to set an image to this scenario entry (i.e., in chat, will override the agent’s image in the chat widget). This property will be deprecated. The chat session icon can be added in Chat Widget configuration. See section Chat Widget tab > Chat Styling > Show agent pic.You can edit the appearance (i.e., color, font size, location, etc.) of the chat widget in the ''Chat Styling'' section. This step is important to complete; if you don't do this, your contact tab (see Step 5 of this procedure) will not appear in preview.# At the bottom of the screen, click '''Save'''.# At the bottom of the screen, click '''Apply''' to save your changes.If you do not see the chat widget on your page, revisit the previous steps of this procedure and try again.For more information on chat widget configuration, see the [[Chat-widget-configuration-guide|Chat Widget Configuration Guide]].You may configure the chat widget to initiate a chat session automatically upon a webpage loading. With this configuration, no customer action is required to launch the widget and, when the webpage is loaded, the chat automatically connects to an agent or the queue.To do this, follow these steps:# Open the ''HTML Snippet for Web Page''.# Paste the copied HTML into a text editing application (e.g., Notepad++) to edit it.# In the "Service Pattern Chat Config" object, add the attribute '''autostartChat''' with the value '''true'''. Note that the default value is '''false'''.# Copy all and paste the edited HTML onto your web page. # Publish the webpage and refresh any active chats.The following is an example of how this looks in the ''HTML Snippet for Web Page''.SERVICE_PATTERN_CHAT_CONFIG = { ... autostartChat: true, ... };