Configuration Guide: IBM Watson Assistant Over SMS and Voice

With IBM’s Watson Assistant, you can integrate an AI-powered conversational interface into flows you build in Atmosphere SmartFlows®.

.

.

Create Watson Assistant Chatbot

 IBM has created tools to help get you started:

Watson Assistant Tooling Overview

Watson Assistant Documentation 

Getting Started with Watson Assistant 

Locate your credentials and chatbot URL

 You will need these to be able to configure your bot in SmartFlows

.

From the IBM Watson Assistant homepage, go to “Assistants

.

You’ll be brought to a page with your API Details as seen below. Take note of the green boxed fields, as these will be the values of your Password, Workspace URL, and Workspace ID Input fields in SmartFlows. 

.

 

Open Atmosphere® SmartFlows to bring Watson Assistant into your flow

    Here you will have two options: if you want this to be a SMS flow or a

    calling flow. 

.

SMS Chatbots: 

To begin the flow, drag the INBOUND SMS trigger onto the work board. 

Connect a WATSON ASSIST action off of the Inbound SMS. Your flow should look like the this:

.

In the configurations panel to the right, paste your Watson Credentials (from above) into the appropriate fields.

.

In the TEXT/MESSAGE input field, drag the initial variable of the text message received (ex: $ISMS_1.message) into the box.

.

Connect an SMS action to the Watson Assist action. In the SMS configuration, drag the Watson Assist response text (ex: $WATSONASSIST_2.responsetext) variable to the MESSAGE field. 

.

Voice Chatbot

To begin the flow, drag the INBOUND CALL on to the work board. Then connect a PLAY AUDIO action to the INBOUND CALL. 

.

.

Configure the PLAY AUDIO with text-to-speech or audio files to create a welcome greetings for calling. 

.

To be able to record the callers voice, you will need to connect a RECORD RESPONSE action to the PLAY AUDIO

.

Now, you will need to drag and connect a SPEECH REC to the RECORD RESPONSE. This is needed in order for you to transcribe the callers message. In the configuration panel, select the REC_#.full_recordng variable from the RECORD RESPONSE action for the File Reference as seen below: 

.

.

Connect a WATSON ASSIST action to the SPEECH REC. Your flow should look like the following:

.

 

Input your Watson Credentials from Step 2 into the appropriate fields. In the Text/Message field: drag and drop the $SPEECHREC.text from the available variables. 

.

Connect a PLAY AUDIO to the WATSON ASSIST. In the configurations, drag the $WATSONASSIT_#.responsetext from the available variables into the text-to-speech box. This will play the response from Watson to the caller. 

.

Connect the PLAY AUDIO to the initial RECORD RESPONSE. This will allow the caller to continued the conversation with Watson. When you’re done, your flow should look like the following: 

.

 

 

Save & Deploy your flow! 

Congrats! You successfully created your Watson chatbot!