IBM Watson Assistant


Add this plugin to your site and let IBM Watson help you better support your customers. In a few minutes, you can train Watson to answer frequently asked questions, provide useful information and help them navigate your website. And if they want to talk to a human, the plugin can connect them to a real operator via telephone.

This plugin uses IBM Watson Assistant (formerly Watson Conversation) on the IBM Cloud. You can use it with an IBM Cloud Lite account free of charge and without a need to provide a credit card. If you take this free course you may get a special offer of US$1200 of IBM Cloud usage to deploy chatbots for much higher usage. If you build web sites and chatbots as a business you may qualify for a special ISV program.

Currently supported features:

  • Take advantage of Rich responses to add images, pauses, and clickable responses to your chatbot
  • Use user’s account data such as name in chatbot dialog
  • Easy VOIP calling powered by Twilio for users to contact a real person if they wish
  • Simple plugin setup to get your Watson Assistant chatbot available to users as soon as possible
  • Control usage of the Watson Assistant service directly from the plugin settings page
  • Choose the pages and posts you want the visitors to see the chat bot on
  • Customize the appearance of the chat box to your preference


  • An example of your chatbot greeting a website visitor.



This plugin requires the WordPress REST API Plugin to be installed. If you have WordPress 4.7 or later, this is installed by default.

Installing the Plugin

  1. Log in to your site’s Dashboard.
  2. Click on the Plugins tab in the left panel, then click the Add New button.
  3. Search for “Watson Assistant” and the latest version will appear at the top of the list of results.
  4. Install the plugin by clicking the Install Now link.
  5. When installation finishes, click Activate Plugin.

This plugin can also be installed manually.

If your WordPress site is hosted by WordPress (with a URL like, you need a paid plan to install plugins. If your WordPress is hosted separately, you should have no issue.

Building Your Chatbot

  1. Learn how to set up your Watson Assistant chatbot with this quick free course.

  2. Sign up for a free IBM Cloud Lite account.

  3. You can see the Watson Assistant documentation for more information.

Once you’ve created your workspace using the course or the link above, you must connect it to your WordPress site.

Setting up the Plugin

  1. From the Deploy tab of your workspace, you must obtain your username and password credentials in addition to the Workspace URL of your new workspace.

  2. Enter these on the “Main Setup” tab of your settings page. Once you click “Save Changes”, the plugin will verify if the credentials are valid and notify you of whether or not the configuration was successful.

  3. (Optional) By default, the chatbot shows up on all pages of your website. In the Behaviour tab of your settings page, you can choose which pages to show the chat bot on. You can also show the chat box inline within posts and pages using the shortcode [watson-chat-box]

If you have a server-side caching plugin installed such as WP Super Cache, you may need to clear your cache after changing settings or deactivating the plugin. Otherwise, your action may not take effect.


What is the best place to learn how to create a chatbot?

Check out this free course to learn how to build your own chatbot.

Why should I use this?

Watson Assistant, when used with this plugin, allows you to build and deploy a fully customized chat bot with little technical knowledge. It can talk to your website’s visitors about whatever you choose, from helping navigate the website and providing support with common questions, to just having a casual conversation on a topic of interest.

Do I need to know how to code?

Nope. This plugin allows you to easily deploy chatbots that you create using the Watson Assistant service on IBM Cloud. This free course will guide you through this intuitive process – no prior technical knowledge necessary.

How do I see my chatbot’s conversations with users?

On the same page where you build your chatbot in IBM Cloud, you can click on the Improve tab to view and analyze past conversations with users.


no support

the plugin is great when it works, but too often it will stop working and start again or just stop altogether for long periods of time and unfortunately they don’t respond to all support requests – just some?

I know the plugin is free but if you’re building a business on this it can be very detrimental to work this way. We are looking into implementing this directly and avoiding the use of a ‘novice’ company

Great plugin

Not only a great plugin but really fast support when IBM make changes to Watson. Awesome.

Excellent plugin

A very good plugin that works perfectly with the Watson API. Not too much to say as it works so well! However I did find one 403 Forbidden response in the loading sequence – it’s still five star though. Thanks guys – great job!

Great Potential, Awful Support for Developers

When I first read about the Watson Assistant Conversation plugin, I was impressed with what I saw. Generally speaking, the Watson has a lot of potential. Unfortunately, that potential seems severely limited by the actual support that IBM and Cognitive Class offer for the Watson plugin.

I have a support thread on this page that has received no response in 7 days. I have finished building my chatbot, but am having a “minor” deployment issue (minor in terms of scale, but significant in terms of user experience issue on the deployment side ). I haven’t even received a “we are looking into this” response, despite two follow up messages from myself.

Long story short, I am impressed by the potential, but the poor support is forcing me to explore competitors’ options for a chatbot.

Plugin setup doesn’t match IBM’s Workspace Credentials

Update #2
The plugin has been updated to support the API credentials for Sydney!
Update #1
Ok, so apparently if you set your cloud location to Sydney rather than the default US South, you can’t use this plugin. I switched to US South and the credentials page is now totally different.

I’ve done the course, and the Workspace Credentials within the Deploy window do not match the WordPress plugin’s config options: username and password. I guess the username is the Workspace ID or similar, but there’s no password to be seen. Running the Assistant in the Sydney cloud, not US.

Read all 20 reviews

Contributors & Developers

“IBM Watson Assistant” is open source software. The following people have contributed to this plugin.


Translate “IBM Watson Assistant” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Added context variable option with Plug-in version
  • Switched to User/Password credentials


  • Fixed dialog context integration


  • Made Watson Assistant API version 2 default


  • Updated instructions on plugin configuration


  • Added support for Watson Assistant API v2


  • Fixed issue with Watson Dialog Options integration


  • Fixed issue with chatbot not responding in certain WordPress environments
  • Fixed minimization setting for small devices
  • Added debug information to make addressing user’s issues faster and easier
  • Fixed a bug with voice calling not always loading the required scripts


  • Fixed issue with API key authentication on some WordPress installations
  • Fixed “Please fill in your Watson Assistant Workspace Credentials” link


  • Added support for new Watson response types (Images, Options and Pauses)


  • Fixed issue with new users entering workspace URL with username/password credentials
  • Fixed “Enabled” setting bug


  • Fixed compatibility issue with PHP versions lower than 5.6


  • Added option for new type of credentials, used by services in Sydney
  • Fixed small styling issues


  • Fixed critical bug caused by missing files


  • Reorganized and moved settings to top-level menu
  • Fixed chat box minimize bug
  • Fixed issue with chat box disappearing sometimes


  • Added option for message delay with “typing” ellipses animation


  • Fixed chat box preview in Appearance settings page
  • Fixed issue with old credentials migration in some installations


  • Fixed Context Variables bug
  • Moved Clear Messages button to header
  • Added timezone context variable


  • Added example values to Context Variables page
  • Added settings for FAB icon and text size


  • New Context Variables Feature for using user account data in chat bot dialog
  • Added full-screen specific font size
  • Fixed chat box rendering bug


  • Small UI improvements


  • Fixed full screen caching issue
  • Fixed issue with rendering lists in messages
  • Added PHP compatibility check upon activation
  • Small CSS improvements
  • Fixed transient checks
  • Decreased lower font size limit


  • Added setting to control message displayed after API limit overage
  • Added setting to temporarily disable chatbot without having to deactivate plugin
  • Fixed compatibility issues with PHP 5.3


  • Rebrand from Watson Conversation to Watson Assistant


  • More detailed debug info for credential validation failure


  • Added chat box shortcode feature
  • Added more text customization to Appearance tab
  • Added CSS caching to reduce server load
  • Fixed bug causing some websites to have issues sending messages


  • Added tooltips to settings
  • Changed appearance of muliple-message responses
  • Improved full screen customization


  • Fixed appearance of send button for certain websites


  • Fixed styling issues for some devices


  • Improved spacing of chat box button
  • Added more customization for chat box minimized state
  • Added option for Send Message button
  • Fixed appearance of multiple-message responses from chatbot


  • Fixed issue with chat button remaining clickable when invisible


  • Fixed browser caching issue preventing chatbox from appearing initially after updates


  • Modified WordPress hooks


  • Fixed bug with credentials validation


  • Added WordPress hooks for sending and receiving messages
  • Added extra debug information for credential validation failure
  • Added Chat Button customization


  • Fixed bug with Advanced page showing on wrong tab


  • Added Preset Response Options feature
  • Fixed issue where typing in message box caused media in previous messages to reload


  • Added compatiblity with Internet Explorer
  • Fixed chat box rendering for some WordPress installations
  • Fixed visual bug with long words in messages


  • Fixed issue with voice call settings validation


  • Added settings tab to help introduce plugin to new users
  • Made some settings more intuitive
  • Settings on all tabs are submitted together now


  • Fixed bug with setting to start chat box minimized


  • Fixed bug in Voice Call UI customization


  • Removed font size cap, fixed font size issues for full screen


  • Added voice calling feature using Twilio
  • Improved compatibility with older PHP versions
  • Added setting for full-screen UI on non-mobile devices


  • Fixes bug causing links from chatbot to be same color as background.


  • Improves backwards compatibility with older PHP versions
  • Improves iOS support.


  • Fixes bug where settings changes do not take effect.


  • New UI for mobile devices.
  • Added ability to clear messages.
  • Fixed several small bugs.


  • Fixed critical bug causing chat box to stick to cursor on some browsers, on some pages.


  • Fixed some UI issues with the chat box being hidden and not staying minimized across pages.
  • Adjusted Show on Home Page option to Show on Front Page instead.


  • Changed UI to use floating action button for minimizing.


  • Added setting allowing admin to specify API base URL.