Exercise - Provision the web chat channel

Completed

Web chat is a simple web page that allows users to communicate with your Azure Health Bot instance. It's a popular channel that you can easily embed in your web assets. Alternative channels can be enabled for your bot on request.

Create the web chat channel

  1. Sign in to the Health Bot management portal. On the left menu, under Integration, select Secrets & Keys.

    Screenshot that shows Azure Health Bot Secrets.

  2. You use secrets to connect the bot to a web page. Copy the values for APP_SECRET and WEBCHAT_SECRET.

    Screenshot that shows APP_SECRET and WEBCHAT_SECRET.

  3. Go to the web chat container sample repository, and select Deploy to Azure.

  4. You're redirected to your Azure portal. Sign in by using your Azure credentials, and enter the details required for the deployment:

    • Subscription: The Azure subscription that's charged.
    • Resource group: Create a new group or use an existing group.
    • App Secret: Use the APP_SECRET value copied in step 2.
    • Webchat Secret: Use the WEBCHAT_SECRET value copied in step 2.

    Screenshot that shows the web chat deployment window in the Azure portal.

  5. Select Review + create, and then select Create.

  6. After the deployment completes, select Go to resource group, and then select the new App Service.

  7. On the Overview page, open the Default domain.

    Screenshot that shows the web chat overview page in the Azure portal.

  8. Test the connection to your bot instance by entering a few commands in the web chat.

    Screenshot that shows the web chat user experience.

Deploy Agent Webchat

Agent Webchat is another channel that's connected to your bot instance.

  1. In the management portal for your Health Bot instance, go to Configuration > Conversation > Human Handoff. Enable the human handoff feature, and select Save.

    Screenshot that shows the Human Handoff tab.

  2. To access the sample web chat, open the web chat URL that you created in step 7 and add /agent.html to the URL. A sign-in page loads that details the agent experience. You can enter any values to access the agent portal. Within the agent portal, you can issue agent commands to interact with users who are talking with your bot.

    Screenshot that shows Agent Webchat.

User experience: Connect to a live agent

If there are online agents, the user and agent go through a connection sequence before the live chat begins.

  1. The user says something that triggers the handoff connection sequence.

  2. The user is advised that they'll connect to an agent soon.

  3. The user is added to the queue, and the agents receive a notification.

  4. The agent uses a connect command to talk to the user who's been in the queue the longest.

  5. A connection is established between the agent and the user.

  6. The user receives a notification they're talking with an agent.

  7. The live chat continues until the agent ends the interaction.

    Screenshot that shows the user and agent interaction through the web chat channel.