Acquire
  • Home link-arrow
  • Chatbots link-arrow
  • IBM Watson

IBM Watson



Watson is IBM’s cognitive computing technology that understands both structured and unstructured data, has the ability to create hypotheses, learns from collaborations, and interacts with humans in a natural way. IBM Watson provides trained responses that include text, images, and more.

This tutorial will show you how to set up IBM Watson and integrate Watson with your Acquire Chatbot. Only one Watson Assistant may be integrated at a time. If you’ve already set up a Watson assistant, start at the Obtaining the API Key and URL.

In this article:

  • Setting Up Watson Assistant 
  • Obtaining the API Key and URL
  • Using IBM Watson in Acquire

Setting Up Watson Assistant

First, you must start a Watson service instance.

Step 1: Sign up for a free IBM Cloud account or log in with your existing account.

Step 2: Load the Watson Assistant page in the IBM Cloud catalog.

Step 3: The Watson service instance will be created in the “Default” resource group.If you wish to change the resource group, change it at this stage as it cannot be changed later. However, this group is sufficient for the purposes of your Acquire Chatbot integration.

If you're creating an instance for production use, which is more robust, you can learn more about resource groups in IBM’s docs.

Step 4: You may be asked to choose an appropriate region/location to deploy your instance in.

Step 5: Press ‘Create’. 


You'll now create a Watson Assistant. Assistants are what IBM calls chatbots.


LooDARSKs-xfSfI9MFwt7LA_gXuT2LIe6E2Be1CnCUCuGEJGthfxwrxOWhXYTvwsY-SfbYcERGZ-Oi64d1DmVHD-SPq3v1Hcffx02iWlydb9gnUi504fh8q8gM3Ukd_VMRrrKNMr

Step 1. Open the Watson Assistant

After creating a Watson Assistant service instance, the Watson Assistant dashboard will appear. You will now be able to manage the Watson Assistant.

Click 'Launch Watson Assistant'. If you're prompted to log in, provide your IBM Cloud credentials.


ELa0-T0iXwReUmIlEEXgtScei5YLRNZuiin78kp5QoFcyxsfbhQxoIxpOgyBHyKdRUVwbCr5X7-XhwbInY0-fq_jyEN5I22jUxU--nn_5y2mM2hMrswzHfre11jT1SNHV8iAptAA

Step 2. Create an assistant

Click 'Create assistant' to add an assistant.


Wa14vcCSgGzjKSri-_BsPqvVRWTY4Fobn6Rl4UTQZgLZu5gDLN3pTzlNYBionrWk1pYnEk2t4i2r7fA9uzMPMM4KVWFKxOPBvcMuob2LkDHwcnR1bHfAxdPTDWpijRvgdIPT_h_T

Name and describe your assistant. Then press 'Create assistant'.

zNjT5BOEwbq4u8EkTJitmQGbxlAD_JnusFMrBkHcpTQczrEf-gO8iECM92V4_LNpLvVxqeeZToZFtVC3_Fugtyib4-ysnYy-UFEoGft5BvoafUn4h7Prz9IIEYwGcXztPzuCu2uk

Step 3. Add dialog skills

A dialog skill is a container for the artefacts that define the conversation flow that your assistant will make use of to engage with your customers.

  1. Click on your assistant tile to open the assistant.
  2. Click 'Add dialog skill'. Name and describe your skill, then press 'Create skill'.
gB85yPBoJRpqQrKvQIyinEXnigIK2FaHQNplHw-LU5XGSVRj5hsitLp5lFSkz4uXmdu8n8NJlFIIA2H69uU4Wlpi9L0kbSr9AzXU3IpdQ9dsct_-xWh4drUfeIQW5E_aI_-OJH4z

You will then land on the Intents page. You may also add intents by clicking on ‘Dialog’ on the assistant page. 

gvgXup3AEFUMBvEWGwk2XHcPpfh9Y15tI-r__yI4otmDZzrUekr0LaVp51fuYBfbH7ILUBLvHE9127hWjC5ISccQxJiQosI8GuHApisznN4YP8GXbp1E_KsV9Cc0OaWfK9Ey9Q1V

Step 4. Add intents from a Content Catalog

Here you can add training data that was built by IBM Watson as further skills by adding intents from the Content Catalog. By giving the assistant access to the General Content Catalog, the chatbot will be able to greet and conclude conversations appropriately.

  1. Click the Content Catalog tab.
  2. Find General in the list, and then click 'Add to skill'.

zV6QIc03rjwsfqZFnE0JyzmsNmFsq6tDISiTvWQR5dWHio_K1fUdFzCvm-8lLZU8qThB8kXP7dFm63wzoK-vbxDg4HJWmt1L5hlXX5y2WlHW9tppIXIJh9ICUpNb7I3p1wvwUH3H

A message will display informing you the intent was successfully added.

Step 5. Build a dialog

From the Content Catalog tab, navigate to the Dialog tab.


Jqs0HktekWJIElDqKj_OUQ1zTMbruht2Z2NG2ECICx2oiUD1nTBHvXT1CuSc_Pf_HKlThTxbLOdPgIDaW9CKfl7NqskXe8wYHREvAZx9gVGByLdlkwZX-fIZGTOWqzZ-Rew_NjDS

A dialog defines your conversation flow in the form of a logic tree. It matches intents (what users say) to responses (what the bot says back). Each node of the tree has a condition that triggers it, based on the user's input.

We'll create a simple dialog that handles the greeting and ending intents, each with a single node.

Adding nodes to handle intents

Now let's add nodes between the “Welcome” node and the “Anything else” node to handle our intents.


i3xwniU9U3omCsjV2kAKsOz1gJY5LkVtGI7auh3WO1UNhh3KoEBJCPESBfHlQnXoaTzmukH3Arigt2nWj7E1_FksT7ACzJv9tFas_SFLCfLnfkVOpoOU6j-PSlXAgi3tmYw4ooTZ

Click the vertical ellipsis (‘⋮’) on the “Welcome” node, and then select 'Add node below'.


gEyfhPeHanb0BMlH0xpmGF34-IESZgnKUT-yq604aSLgmxb2Ouau8_ujOKWoi7wULkYz8AGjAAOo0SGH7JhuBlJc2wRX6vDhtNp_NzIAr9XXV8XACBHvK_vjj1GXFmEa6tTAI6kw

In the If assistant recognizes field of this node, start to type #General_Greetings. Then, select the #General_Greetings option.


Nx3Z5NtodrB0t4IEaugxV-X9gX4CQdy0Eehtd7tkihV-n7vZ1FosQZVoIPE6wW_YcQW1xyrWIV6lgfVMySa2l85wPnKnCG239srUHflQd3n_F9HMA3PEWXw_RA5c-DwB4xwyM0mz

Add the response text, “Hello There!”.


jAMNmeUnGLE69XGg5bkKJZwGaOyB2u8hTKa2JyMjzhjlpK-wha1Sixje6EHWVAK4TzKrcHzTQXALEQskmMJ69wtohxcYIoi5h7zS41N4fuBLgcqHIss5C6qAZQ2kJMZQmIoWcka6

Click on the “X” icon to close the edit view. Your changes will be automatically saved.

You will now see three nodes as shown below.


isxWeRo0nmVvWW9qEWaGWVWKoB4kXQw4ct1Hr6c7PSaLLs1gODFE-X-aNsc9av6qhIRO1VztibhAreoge_4sPp90bXcg1ZiMgUs5IkWiVdDL1fH_8g51bccEoYMEiNGs9pd2ZuLc

Click the vertical ellipsis (‘⋮’) on the #General_Greetings node, and then select 'Add node below' to create a peer node. In the peer node, specify #General_Ending in the “If assistant recognizes” field, and type “OK. See you later!” as the response text.


VV0nMm-Wwk7Rn4GdBPHUMwMm6BkV4KAaeCK4SPbUo1SnpxS-gjymRYMP-2bBd8Ym_75gYamfzJu0eIrSMYDs4YjZVZXKaxJMFtCcw8-ZlIw4mWfAzNESg3ggIxH16_hsDIv8WO5f

Click the ‘X’ icon to close the edit view. Your changes will be automatically saved.

You’ve now created an IBM Watson bot that will respond to visitor greetings. Before integrating this bot with Acquire, you’ll need to obtain your account account credentials. 

Obtaining the API Key and URL 

To find your IBM account’s API key and URL, navigate to the IBM Cloud Dashboard and click on Resource List. Go to Services and click on your assistant. 


Ie3nLwM_VO6hZmBvJ_8rc0RUq-wyEXEbVOPDdXa2HZyEVqgZ2YSCPTZc5EfxRY9Q0UKcBk7ipKRbkNH0uY5OGq0affrbpF4JaAv8Rs6o8eEWxiUUXVDHlZSrnMuEFsWkwFkYkoWL

You will be redirected to the IBM Watson Service Page. Copy your ‘API key’ and ‘URL’.

[Note: If your URL includes watsonplatform.net, you will be shown a notice to update the URL in your IBM Watson platform. Kindly update and follow the instructions given there. If your URL does not include watsonplatform.net, you are good to go! ]


O2KmgI_L3w5-FMyIYa-a9Iju-gVaniWPnEQygLHux8d1M_H7m4YdLMbuRzwdFnsHRAM-NaDTsEniOzBAKZVmUAt2C5a46PRmCtkSesD1Cn2UrkEJqcGacJJ2wDQJgs_AASnxDYt6

To find your Assistant ID, click on 'Launch Watson Assistant'. A list of your assistants will display.


_adGMvgZ2Y-ovr5Hci6XPjCeSUUwspAP7T-CpRUmRKF9sZESmVgZarIGMCTxBoVgOLIg3IQCNnIuHmNVJBnTdAyOBhuwlQgHZPGEFul0GYQhoKGNtYPYlenw-ctjqu4h8ZpfSF1g

Select the vertical ellipsis icon (‘⋮’) icon inside the assistant window and then click on Settings.


qzEdJ1YGttN3QgWUS57-WRn3kboWSOTbLk8785JoyKZJalgrn8lhd_NpMHgcYkDPcS0D550E8kHwY4F4DFIA5thCdVFlEUIrqW9YxCtEh6qi6zMKPJrx-npR3kkfpq88iVJ5pqpP

Click on the API Details tab. Copy the Assistant ID as shown below.


Q7_kT9SqCv8L0lctabJgv53ZHbdVGfbQOD2guNUyeZwieq7bu13sk32qGrUl6HZ3GtR3QDx-FWPWy1wiSDDiXiQy_LcACV67zyajDOmcl335g3RTVxD4JfpzwKh8zyld4YKrE00L

You’re all set! The IBM Watson chatbot is now ready to be integrated with your Acquire account. 

Installing IBM Watson in Acquire 

Once you have your IBM Watson credentials, go to the Acquire App Store > Chatbots and click on the IBM Watson tile.


OD01V3jyLRT93LHMjKBkkL0XsZcAyJ5fsvIqrQljXjXGgQhrMM7V0FbGuR478fs4JTLQoNWvstBEV-mHlsPnQS0Gl7lq84HQbILT_YxaT6bzGf5YPy5WzN69BD3d9VWfJxLGoQOK

Click ‘Install’.

Click ‘Authorize Access’ to authorize the integration. 

You’ll be redirected to the Settings tab. In the ‘Client API Key’ field, input your IBM account API key. In the URL, enter your account URL. 

In ‘Assistant ID’, enter your Assistant ID. 

Then, hit ‘Save’. 

Using IBM Watson in Acquire


Next, you can use a Business Rule to engage your chatbot with visitors.

But first, you may want to test out your new bot. To set up a simple Business Rule, go to Settings > Workflows > Business Rules. Click on ‘New Rule’ and choose ‘Chat’ as your ‘Channel’ and ‘On New Conversation’ as your ‘Trigger Type’. Then press ‘Create’. 

Create a new branch, and choose ‘Assign Bot’. From the bot drop-down menu, select ‘IBM Watson’.

Your Business Rule should look like the image below. 


HV9yFQu4CvgHRHMP0PPpoeVbJ66v48Fh-NNRUUpsjMBNqjfNrq9l94SDfIQBu52s78jseY_tYKe5gFsyTSyRknJieFCnMJlOa62erlOle0RpFySP1-V7H2OEr0TBzz-eOE_uuIYR

‘Save’ the Business Rule and use the toggle button to activate it (right, green). Be sure to check that no other Business Rules are overriding it. 

Go to your Dashboard, and click on ‘Go to Chat Simulate Page’.

Once there, engage the bot in a conversation by clicking on the launcher and beginning a new conversation. The bot should respond with the text you’ve entered. 

z8Puv5lI_ZUohqUp_mBVm8XjJzwFsg-F8hQprGZk7d5YzjMsKW8y6AQrkoKjEDMQGf-UDGHo4O-hYIdUrv3dTbLtV9k8zpFjG9F9YcECfyiKQ2agUsFjQY9eUG8bW6uPQvGTUvOE

To learn more about IBM Watson’s Assistant, check out IBM’s documentation

Having trouble? Reach out to support@acquire.io.


default-user

Related Articles