Luma is a Virtual Agent, often referred to as a chatbot, that allows users to interact in a conversational manner to resolve their issues or interact with the Service Management team. A special embeddable web widget is available inside Intelligent Service Management (ISM). This allows end-users navigating to the ISM self-service portal to use the widget to chat with a Virtual Agent or reach out to the support team. Analysts can take quick actions through the widget to transfer tickets, add a worklog, reset a password, trigger a follow-up and much more.   

As an Administrator, you need to perform the following steps to integrate Web widget in ISM.:

1. Configure web widget in Luma and retrieve the secret key.
2. Integrate web widget in ISM

Configure Web widget in Luma

To enable and configure web widget in Luma, do the following.:

1. Login to Luma Skills Builder as an Administrator.
2. Navigate to Bot Dashboard, Bot Configuration (from actions button), Channels and then click Web Widget from the Configure Channels list.
   The Configure Web Widget dialog box appears as shown below.
   
   
3. Copy the Secret Key and retain them in an easily accessible location such as notepad or a text editor tool. These details will be used later when adjusting the web widget code on your website. You can use the copy icon to the right of each section to simplify the operation. 
4. Click Next. The following Welcome screen appears. The Welcome screen provides a getting started message to first time users and Guest users.
   
5. Click Configure to enable the Web Widget channel. 
6. Use the toggle button () to make the channel Active/inactive.
   
   
7. Click Next to configure the web widget.
   
8. Update welcome title & description if required, else, click Configure.
   
   The configured web widget is shown on the Channels page.
   
   
   • By default, the toggle button () is set to Active. If required, use the toggle button to make the channel inactive.
   • If required, use the edit button () to edit the web widget details.

Integrate Web widget in ISM

To integrate web widget in ISM, do the following.:

1. Navigate to Manage, Tools, and then Integrations.
2. Select Luma from the Integration Name panel.
3. Type the Luma Application URL. For example, https://lumadev3.serviceaide.com/login
4. Enter the secret key which is required to authenticate you as a user who can access Luma Web Widget. As an Administrator, you must have a Luma Account. Contact Serviceaide Support for additional information.
5. Type the bot name in the Luma Name field. This name appears on top of the chat widget.You can name it based on your requirement. Luma Name does not have to align to the bot name inside the Luma skills builder UI. 
6. Select Luma version.
7. Provide the Luma Tenant External Id.
8. Add the API Access Key.
9. Enable Generative AI to enable AI services and other Luma VA-specific generative AI features.
10. If you wish to customize the Luma Icon, add a public URL for the icon in Bot Icon URL. This is optional. If not provided, the default Luma icon is displayed.
11. Click Save.
12. To activate the widget, click the button on the Luma control bar. By default, the button is set to Inactive.
    
    

Chat with Luma

Refresh the ISM page to view the Luma web widget icon on the right corner of the page. Once the service is running, users can send messages to the Bot and receive responses from your Luma Virtual Agent.

For queries related to enabling the web widget, please contact the Serviceaide Support team.

Multiple BOT support for Webwidget in Luma

To integrate multiple bot web widget in ISM, do the following.:

1. Navigate to Manage, Tools, and then Integrations.
2. Select Luma WebWidget from the Integration Name panel.
3. Type the Luma Application URL. For example, https://lumadev3.serviceaide.com/login
4. Type the bot name in the Luma Bot Name (en_US) field. This name appears on top of the chat widget. You can name it based on your requirement. Luma Name does not have to align to the bot name inside the Luma skills builder UI
5. Enter the secret key which is required to authenticate you as a user who can access Luma Web Widget. As an Administrator, you must have a Luma Account. Contact Serviceaide Support for additional information.
6. Similarly for Spanish and Portuguese the application URL will be the same, enter the bot name in the Luma Bot Name (es_ES) for Spanish and Luma Bot Name (pt_BR) for Portuguese and enter the respective Secret Keys.
7. Click Save.