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.

Step One: Create Watson Assistant Chatbot with IBM. IBM has created tools to help get you started:

  • https://www.youtube.com/watch?reload=9&time_continue=1&v=h-u-5f8fZtc
  • https://www.ibm.com/cloud/watson-assistant/
  • https://cloud.ibm.com/docs/services/assistant?topic=assistant-getting-started#gettingstarted

Step Two: Locate your credentials and chatbot URL

  1. From the IBM Watson Assistant homepage, go to “Assistants”
  2. Click “View API Details” from the menu to the right of the skill you would like to use.

You’ll be brought to a page with your API Details. Take note of your:

  1. Assistant credentials = Password
  2. Assistant URL = Legacy v1 Workspace URL
  3. Workspace ID = Workspace ID


SMS:

Step Three: Open Atmosphere® SmartFlows to bring Watson Assistant into your flow

  1. Click and drag an INBOUND SMS trigger to begin the flow.
  2. Click, drag, and connect a WATSON ASSIST action to Inbound SMS. In the configurations panel to the right, paste your Watson Credentials (from step 2 above) into the appropriate fields (Credentials, URL, Workspace ID). In the TEXT/MESSAGE section, drag the initial variable of the text message received (ex: $ISMS_1.message) into the field.
  3. Click, drag and connect an SMS block to the Watson Assist block. Click the SMS block to configure and drag the Watson Assist response text (ex: $WATSONASSIST_2.responsetext) variable to the MESSAGE field.

Step Four: Save and Deploy. Congrats!


Voice

Step Three: Open Atmosphere® SmartFlows to bring Watson Assistant into your flow

  1. Click and drag an INBOUND CALL Trigger to begin the flow.
  2. Click, drag, and connect a PLAY AUDIO Action to the INBOUND CALL. Configure this block with text-to-speech or audio files to create welcome greetings for callers.
  3. Click, drag, and connect a RECORD RESPONSE Action to the PLAY AUDIO Action. This will allow you to record the callers voice.
  4. Click, drag, and connect a SPEECH REC to the RECORD RESPONSE Action. This will transcribe the callers message. In the configurations panel,
    select REC_3.full_recording under FILE REFERENCE.
  5. Click, drag and connect a WATSON ASSIST to the SPEECH REC.This image has an empty alt attribute; its file name is Wat-Voice-1-1024x337.png
  6. Input your Watson Credentials into the appropriate fields (Credentials, URL, Workspace ID).
  7. In the Inputs section and in the TEXT/MESSAGE field: drag and drop the $SPEECHREC TEXT from the Available Variables.
  8. Click, drag and connect a PLAY AUDIO Basic to WATSON ASSIST. In the configurations, drag $WATSONASSIST_0.responsetext from the Available Variables and drop it into the text-to-speech textbox.
  9. Connect the PLAY AUDIO to the initial RECORD RESPONSE (from #3)This image has an empty alt attribute; its file name is Wat-Voice-2-1024x490.gif

Step Four: Save and Deploy. Congrats!