concierge

A utilty that allows a small business owner to create a Watson-powered chatbot to answer
questions about their business and publish it to their web page. The chatbot can answer questions about
your business's contact details, directions and can even help take bookings.

See a live demo here showing Concierge in action - the
concierge chatbot can be found in the bottom right corner of the page.

Pre-requisites

Bluemix - Bluemix is IBM's cloud platform. Sign up for a free acount. This will give you
the ability to provision cloud services such as Watson Conversation and use the OpenWhisk platoform (see below).

Watson Conversation API - The Watson Conversation service has a free demo account and
is provisioned in your Bluemix dashboard. Simply add the service and make a note of your service username/password.

tells you the HTML to paste into your own web page to add the chatbot to your website

It's that simple!

Storing your conversations

The concierge tool will also prompt you for a Cloudant URL and Cloudant Database name. If they are supplied then the converation will be
stored in that database as it happens (don't forget to create the database in the Cloudant dashbaord first). This will allow you to
perform analytics on your chats. How many people used it? What questions did they ask? What bookings have I collected today?

Using this library programmatically

As well as the concierge-chatbot command-line tool, you may also use this as a library within your own applications. Simply
use npm install --save concierge-chatbot to add it to your project and require it into your own code:

var concierge =require('concierge-chatbot');

The concierge object then has the following functions

interactive()

Call interactive to initiate an command-line session where the user will be prompted for the business data on the command line.

concierge.interactive();

createWorkspace(data)

The createWorkspace function creates a Watson Conversation configuration given the business data:

var data ={

"username":"MYWATSONCONVERSATIONUSERNAME",

"password":"MYWATSONCONVERSATIONPASSWORD",

"cloudanturl":"https://MYUSERNAME:MYPASSWORD@MYHOST.cloudant.com",

"cloudantdbname":"concierge",

"name":"The Pretend Hotel",

"address":"18 Front Street, London",

"postcode":"W1A1AA",

"phone":"01818118181",

"website":"http://pretendhotel.com",

"email":"enquiries@pretendhotel.com",

"twitter":"pretendhotel",

"facebook":"https://facebook.com/pretendhotel",

"opening":"24 Hours",

"id":"The_Pretend_Hotel"

};

concierge.createWorkspace(data).then(function(reply){

console.log('Watson Conversation Bot created', reply);

});

createWhiskActions(data)

The createWhiskActions function creates a public-facing API call to allow your chatbot to be seen by the outside world. It creates
a Node.js OpenWhisk action in your Bluemix account using the wsk command-line tool and then exposes that code as an API call
that can be used by any web page.

var data ={

"username":"MYWATSONCONVERSATIONUSERNAME",

"password":"MYWATSONCONVERSATIONPASSWORD",

"cloudanturl":"https://MYUSERNAME:MYPASSWORD@MYHOST.cloudant.com",

"cloudantdbname":"concierge"

};

concierge.createWhiskActions(data).then(function(reply){

console.log('OpenWhisk action created', reply);

});

getTemplateHTML(url, workspace)

The getTemplateHTML function creates a snippet of HTML code to be pasted into your website given