Salesforce Skype Bot

By Raj Vakati October 28, 2017 Chatbot 0 Comments

Introduction

In this blog, I am going to explain the step by step how to set up a skype bot with salesforce by using node js,jsforce, and botbuilder.

Setup Node Js Project

1. Create an empty folder to start the node js project.
2. Create a new package.json file and paste the below code into the package.json file

{
  "name": "bot",
  "version": "1.0.0",
  "description": "",
  "main": "app.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node app.js"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "botbuilder": "^3.1.1",
    "jsforce": "^1.8.0",
    "restify": "^4.1.1"
  }
}

{

"name": "bot",

"version": "1.0.0",

"description": "",

"main": "app.js",

"scripts": {

"test": "echo \"Error: no test specified\" && exit 1",

"start": "node app.js"

"author": "",

"license": "ISC",

"dependencies": {

"botbuilder": "^3.1.1",

"jsforce": "^1.8.0",

"restify": "^4.1.1"

}

3. Run npm install from the command promote to load all the node modules from the package.json
4.Now create a new file and name it as app.js and paste this code into app.js file.

var restify = require('restify');
var builder = require('botbuilder');
var server = restify.createServer();
var jsforce = require('jsforce');

server.listen(process.env.port || process.env.PORT || 8080, function () {
console.log('%s listening to %s', server.name, server.url);
});
var connector = new builder.ChatConnector({
appId: "Microsoft App Id",
appPassword: "App password"
});
var conn = new jsforce.Connection({
loginUrl: 'https://login.salesforce.com'
});
var username = 'salesforce user name';
var password = 'password and token';
conn.login(username, password, function (err, userInfo) {
if (err) { return console.error(err); }
});
console.log(conn);

var bot = new builder.UniversalBot(connector);
server.post('/api/messages', connector.listen());

bot.on('conversationUpdate', function (message) {
// Check for group conversations
if (message.address.conversation.isGroup) {
    // Send a hello message when bot is added
    if (message.membersAdded) {
        message.membersAdded.forEach(function (identity) {
            if (identity.id === message.address.bot.id) {
                var reply = new builder.Message()
                    .address(message.address)
                    .text("Hello everyone!");
                bot.send(reply);
            }
        });
    }

    // Send a goodbye message when bot is removed
    if (message.membersRemoved) {
        message.membersRemoved.forEach(function (identity) {
            if (identity.id === message.address.bot.id) {
                var reply = new builder.Message()
                    .address(message.address)
                    .text("Goodbye");
                bot.send(reply);
            }
        });
    }
}
});

bot.on('contactRelationUpdate', function (message) {
if (message.action === 'add') {
    var name = message.user ? message.user.name : null;
    var reply = new builder.Message()
        .address(message.address)
        .text("Hello %s... Thanks for adding me. Say 'hello' to see some great demos.", name || 'there');
    bot.send(reply);
} else {
    // delete their data
}
});

bot.on('deleteUserData', function (message) {
// User asked to delete their data
});

bot.use(builder.Middleware.dialogVersion({ version: 1.0, resetCommand: /^reset/i }));
bot.endConversationAction('goodbye', 'Goodbye :)', { matches: /^goodbye/i });
bot.beginDialogAction('help', '/help', { matches: /^help/i });
bot.dialog('/', [
function (session) {
    // Send a greeting and show help.
    var card = new builder.HeroCard(session)
        .title("Salesforce Skype Bot")
        .images([
            builder.CardImage.create(session, "https://c1.sfdcstatic.com/content/dam/web/en_us/www/images/home/sfdc-jetpack-card.jpg")
        ]);
    var msg = new builder.Message(session).attachments([card]);
    session.send(msg);
    session.beginDialog('/menu');
},
function (session, results) {
    // Display menu
    session.beginDialog('/menu');
},
function (session, results) {
    // Always say goodbye
    session.send("Ok... See you later!");
}
]);

bot.dialog('/menu', [
function (session) {
    builder.Prompts.choice(session, "What would you like to do?", "posttochat|CreateOrder|ContactDetails|(quit)");
},
function (session, results) {
    if (results.response && results.response.entity != '(quit)') {
        // Launch demo dialog
        session.beginDialog('/' + results.response.entity);
    } else {
        // Exit the menu
        session.endDialog();
    }
},
function (session, results) {
    // The menu runs a loop until the user chooses to (quit).
    session.replaceDialog('/menu');
}
]).reloadAction('reloadMenu', null, { matches: /^menu|show menu/i });

bot.dialog('/posttochat', [
function (session) {
    builder.Prompts.text(session, "Please say the message to post to chatter?");
},
function (session, results) {
    // session.userData.name = results.response;
    //builder.Prompts.number(session, "Hi " + results.response + ", How many years have you been coding?");
    conn.chatter.resource('/feed-elements').create({
        body: {
            messageSegments: [{
                type: 'Text',
                text: results.response
            }]
        },
        feedElementType: 'FeedItem',
        subjectId: 'me'
    }, function (err, result1) {
        if (err) { return console.error(err); }
        console.log("Id: " + result1.id);
        console.log("URL: " + result1.url);
        console.log("Body: " + result1.body.messageSegments[0].text);
        console.log("Comments URL: " + result1.capabilities.comments.page.currentPageUrl);
        session.send("Message is posted Succefully: Record is for your reference " + result1.id);

    });

},
function (session, results) {
    // The menu runs a loop until the user chooses to (quit).
    session.replaceDialog('/menu');
}
]);

bot.dialog('/CreateOrder', [

function (session) {
    builder.Prompts.text(session, "What is the name of the order");
},
function (session, results) {
    conn.sobject("Order").create({ Name: results.Name, EffectiveDate: '2018-02-01', Status: 'Draft', Contract: '8006A0000000N5M', Account: '0016A000004BtSv' }, function (err, ret) {
        if (err || !ret.success) { return console.error(err, ret); }
        session.send("Order is created with record is  " + ret.id);
    });
},
function (session, results) {
    // The menu runs a loop until the user chooses to (quit).
    session.replaceDialog('/menu');
}

]);

bot.dialog('/ContactDetails', [
function (session, results) {
    session.send("No Logic is implemented here Simply");
    session.replaceDialog('/menu');
}

]);

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

var restify = require('restify');

var builder = require('botbuilder');

var server = restify.createServer();

var jsforce = require('jsforce');

server.listen(process.env.port || process.env.PORT || 8080, function () {

console.log('%s listening to %s', server.name, server.url);

});

var connector = new builder.ChatConnector({

appId: "Microsoft App Id",

appPassword: "App password"

});

var conn = new jsforce.Connection({

loginUrl: 'https://login.salesforce.com'

});

var username = 'salesforce user name';

var password = 'password and token';

conn.login(username, password, function (err, userInfo) {

if (err) { return console.error(err); }

});

console.log(conn);

var bot = new builder.UniversalBot(connector);

server.post('/api/messages', connector.listen());

bot.on('conversationUpdate', function (message) {

// Check for group conversations

if (message.address.conversation.isGroup) {

// Send a hello message when bot is added

if (message.membersAdded) {

message.membersAdded.forEach(function (identity) {

if (identity.id === message.address.bot.id) {

var reply = new builder.Message()

.address(message.address)

.text("Hello everyone!");

bot.send(reply);

}

});

}

// Send a goodbye message when bot is removed

if (message.membersRemoved) {

message.membersRemoved.forEach(function (identity) {

if (identity.id === message.address.bot.id) {

var reply = new builder.Message()

.address(message.address)

.text("Goodbye");

bot.send(reply);

}

});

}

});

bot.on('contactRelationUpdate', function (message) {

if (message.action === 'add') {

var name = message.user ? message.user.name : null;

var reply = new builder.Message()

.address(message.address)

.text("Hello %s... Thanks for adding me. Say 'hello' to see some great demos.", name || 'there');

bot.send(reply);

} else {

// delete their data

}

});

bot.on('deleteUserData', function (message) {

// User asked to delete their data

});

bot.use(builder.Middleware.dialogVersion({ version: 1.0, resetCommand: /^reset/i }));

bot.endConversationAction('goodbye', 'Goodbye :)', { matches: /^goodbye/i });

bot.beginDialogAction('help', '/help', { matches: /^help/i });

bot.dialog('/', [

function (session) {

// Send a greeting and show help.

var card = new builder.HeroCard(session)

.title("Salesforce Skype Bot")

.images([

builder.CardImage.create(session, "https://c1.sfdcstatic.com/content/dam/web/en_us/www/images/home/sfdc-jetpack-card.jpg")

]);

var msg = new builder.Message(session).attachments([card]);

session.send(msg);

session.beginDialog('/menu');

function (session, results) {

// Display menu

session.beginDialog('/menu');

function (session, results) {

// Always say goodbye

session.send("Ok... See you later!");

}

]);

bot.dialog('/menu', [

function (session) {

builder.Prompts.choice(session, "What would you like to do?", "posttochat|CreateOrder|ContactDetails|(quit)");

function (session, results) {

if (results.response && results.response.entity != '(quit)') {

// Launch demo dialog

session.beginDialog('/' + results.response.entity);

} else {

// Exit the menu

session.endDialog();

}

function (session, results) {

// The menu runs a loop until the user chooses to (quit).

session.replaceDialog('/menu');

}

]).reloadAction('reloadMenu', null, { matches: /^menu|show menu/i });

bot.dialog('/posttochat', [

function (session) {

builder.Prompts.text(session, "Please say the message to post to chatter?");

function (session, results) {

// session.userData.name = results.response;

//builder.Prompts.number(session, "Hi " + results.response + ", How many years have you been coding?");

conn.chatter.resource('/feed-elements').create({

body: {

messageSegments: [{

type: 'Text',

text: results.response

}]

feedElementType: 'FeedItem',

subjectId: 'me'

}, function (err, result1) {

if (err) { return console.error(err); }

console.log("Id: " + result1.id);

console.log("URL: " + result1.url);

console.log("Body: " + result1.body.messageSegments[0].text);

console.log("Comments URL: " + result1.capabilities.comments.page.currentPageUrl);

session.send("Message is posted Succefully: Record is for your reference " + result1.id);

});

function (session, results) {

// The menu runs a loop until the user chooses to (quit).

session.replaceDialog('/menu');

}

]);

bot.dialog('/CreateOrder', [

function (session) {

builder.Prompts.text(session, "What is the name of the order");

function (session, results) {

conn.sobject("Order").create({ Name: results.Name, EffectiveDate: '2018-02-01', Status: 'Draft', Contract: '8006A0000000N5M', Account: '0016A000004BtSv' }, function (err, ret) {

if (err || !ret.success) { return console.error(err, ret); }

session.send("Order is created with record is " + ret.id);

});

function (session, results) {

// The menu runs a loop until the user chooses to (quit).

session.replaceDialog('/menu');

}

]);

bot.dialog('/ContactDetails', [

function (session, results) {

session.send("No Logic is implemented here Simply");

session.replaceDialog('/menu');

}

]);

5.Change appId & appPassword with your own appId and appPassword for chatbot and Salesforce username and password to get data from the salesforce.To get App Id and password follow below steps.

6.First login into your Microsoft account.

7.Goto this link: Click Here and complete sign in process

8.Click on Register a bot and create a new bot.

9.Click create button to register your bot Register an existing bot built using Bot Builder SDK

10.Now fill in your required details, select your bot image as shown below

11.Click on Create Microsoft App ID and password and then click on generate app Password to continue

12.Now You got your App ID and Password and update them in code.

13.Now you need to add https messaging endpoint to listen for requests.

14.You can create one for free that will run locally on your system using the tool called ngrok and Download ngrok from here Click Here .You will get a zip file, Extract that zip file into any folder and then open the file named ngrok.exe

15.Type and enter : ngrok http 8080

16.Now copy the https address from the command line of ngrok. Make sure you don’t close the ngrok after creating address cause then the endpoint address will not listen to any request.

17.Now paste this address into endpoint field and add “api/messages” in the end as shown below on Bot Registration configuration sections.

18.Click on the register and save the bot.
19.Now go back to command prompt and type ‘ node app.js ‘ to start your node js application.
20.After the application starts you can test from the test section on the application.

Then type /help to start the bot conversion as shown below.

As shown in the above image you can post to chatter from the skype chatbot. once you test your application you can push the skype and use it.

Understand the Code

You can register the bot chat connect from the below code and it is going to Create chat connector for communicating with the Bot Framework Service

var connector = new builder.ChatConnector({
appId: "7fd91532-0cb1-49e6-8100-883682ece5da",
appPassword: "twrITAZ192>_aarsGUG69;&"
});

var connector = new builder.ChatConnector({

appId: "7fd91532-0cb1-49e6-8100-883682ece5da",

appPassword: "twrITAZ192>_aarsGUG69;&"

});

And most important think how we are going to establish the conversation as the communication between a bot and a user through one or more dialogs. A dialog, at its most basic level, is a reusable module that performs an operation or collects information from a user. the below code shows how to start the dialog

bot.dialog('/', [
function (session) {
    // Send a greeting and show help.
    var card = new builder.HeroCard(session)
        .title("Salesforce Skype Bot")
        .images([
            builder.CardImage.create(session, "https://c1.sfdcstatic.com/content/dam/web/en_us/www/images/home/sfdc-jetpack-card.jpg")
        ]);
    var msg = new builder.Message(session).attachments([card]);
    session.send(msg);
    session.beginDialog('/menu');
},
function (session, results) {
    // Display menu
    session.beginDialog('/menu');
},
function (session, results) {
    // Always say goodbye
    session.send("Ok... See you later!");
}
]);

bot.dialog('/', [

function (session) {

// Send a greeting and show help.

var card = new builder.HeroCard(session)

.title("Salesforce Skype Bot")

.images([

builder.CardImage.create(session, "https://c1.sfdcstatic.com/content/dam/web/en_us/www/images/home/sfdc-jetpack-card.jpg")

]);

var msg = new builder.Message(session).attachments([card]);

session.send(msg);

session.beginDialog('/menu');

function (session, results) {

// Display menu

session.beginDialog('/menu');

function (session, results) {

// Always say goodbye

session.send("Ok... See you later!");

}

]);

You can refer more details on dialogs below links

https://docs.microsoft.com/en-us/bot-framework/nodejs/bot-builder-nodejs-quickstart

https://docs.microsoft.com/en-us/bot-framework/nodejs/bot-builder-nodejs-dialog-overview

Tags:Chatbot

Salesforce

Salesforce Skype Bot

Introduction

Setup Node Js Project

Understand the Code

Like this:

Related

Introduction

Setup Node Js Project

Understand the Code

Share this:

Like this:

Related

Related Posts