S
S
Symphony Developers Documentation
Search…
Main
Building Bots on Symphony
Building Extension Applications on Symphony
Developer Certification
Developer Tools
Symphony REST API
Mobile Frameworks
Building a Chatbot using the BDK 2.0
Prerequisites
Complete the BDK 2.0 Bot Configuration guide:
1. Dive into the Code
BDK 2.0 is a library of tools and intelligent API bindings that provides an ultra simplified configuration and authentication setup, intuitive message and room management, customizable message templating, and a new activities API that makes it easy to facilitate bot workflows. The BDK 2.0 and bot project generated by the Symphony Bot Generator makes it super easy to get started!
To begin let's open up the code generated for you by the Symphony Bot Generator in your favorite IDE. Navigate to the
BotApplication.java file: Note:
As you can see below on line 32, we are leveraging the Activities API to register a slash command ("/gif"). While this functionality is provided out of the box, we will be building a new datafeed listener to keep it simple at first. For a more in depth look at the provided activity and Activities API, continue here.
BotApplication.java
1
package com.symphony.java;
2
​
3
import com.symphony.bdk.core.SymphonyBdk;
4
import com.symphony.bdk.core.service.datafeed.RealTimeEventListener;
5
import com.symphony.bdk.core.service.message.model.Message;
6
import com.symphony.bdk.gen.api.model.V4Initiator;
7
import com.symphony.bdk.gen.api.model.V4UserJoinedRoom;
8
import com.symphony.bdk.template.api.Template;
9
​
10
import org.slf4j.Logger;
11
import org.slf4j.LoggerFactory;
12
​
13
import static com.symphony.bdk.core.config.BdkConfigLoader.loadFromClasspath;
14
import static com.symphony.bdk.core.activity.command.SlashCommand.slash;
15
import static java.util.Collections.emptyMap;
16
import static java.util.Collections.singletonMap;
17
​
18
/**
19
* Simple Bot Application.
20
*/
21
public class BotApplication {
22
​
23
/** The Logger */
24
private static final Logger log = LoggerFactory.getLogger(BotApplication.class);
25
​
26
public static void main(String[] args) throws Exception {
27
​
28
// Initialize BDK entry point
29
final SymphonyBdk bdk = new SymphonyBdk(loadFromClasspath("/config.yaml"));
30
​
31
// Register a "slash" activity
32
bdk.activities().register(slash("/gif", false, context -> {
33
Template template = bdk.messages().templates().newTemplateFromClasspath("/templates/gif.ftl");
34
bdk.messages().send(context.getStreamId(), Message.builder().template(template).build());
35
}));
36
​
37
// Register a "formReply" activity that handles the Gif category form submission
38
bdk.activities().register(new GifFormActivity(bdk.messages()));
39
​
40
// Subscribe to 'onUserJoinedRoom' Real Time Event
41
bdk.datafeed().subscribe(new RealTimeEventListener() {
42
​
43
@Override
44
public void onUserJoinedRoom(V4Initiator initiator, V4UserJoinedRoom event) {
45
final String userDisplayName = event.getAffectedUser().getDisplayName();
46
Template template = bdk.messages().templates().newTemplateFromClasspath("/templates/welcome.ftl");
47
bdk.messages().send(event.getStream(),
48
Message.builder().template(template, singletonMap("name", userDisplayName)).build());
49
}
50
});
51
​
52
// finally, start the datafeed read loop
53
bdk.datafeed().start();
54
}
55
}
Copied!
To build a conversational workflow, add the following datafeed listener (
onMessageSent) to your main bot class:1
bdk.datafeed().subscribe(new RealTimeEventListener() {
2
@Override
3
public void onMessageSent(V4Initiator initiator, V4MessageSent event) {
4
if (event.getMessage().getMessage().contains("/hello")){
5
bdk.messages().send(event.getMessage().getStream(), String.format("<messageML>Hello %s </messageML>", initiator.getUser().getDisplayName()));
6
}
7
}
8
});
Copied!
The above snippet is listening for all incoming messages that contain "/hello". To see a full list of datafeed listeners provided by the BDK 2.0, navigate here. If the message received by the bot contains "/hello", the bot will respond by sending a message to the stream or conversation in context. Run your bot and let's see it in action:
As you can see, it's super easy to access the message, room, and user context from an incoming event. The
V4Initiator and V4MessageSent classes provide convenience methods that make it easy to orchestrate workflows. For a more detailed overview of how to leverage the BDK 2.0's message, room, and user management classes, continue here.2. Next Steps
Above, we showed you a simple example of how to leverage the BDK 2.0 to build a conversational bot. To see more advanced usage of the BDK 2.0 in order to build complex financial workflows, continue on to our dedicated BDK 2.0 Certification course:
Last modified 1yr ago