appless-botkit-adapter

AppLess BotKit Adapter

Usage no npm install needed!

<script type="module">
  import applessBotkitAdapter from 'https://cdn.skypack.dev/appless-botkit-adapter';
</script>

README

appless-botkit-adapter

Connect Botkit or BotBuilder to AppLess.

This package contains an adapter that communicates directly with the AppLess API, and translates messages to and from a standard format used by your bot. This package can be used alongside your favorite bot development framework to build bots that work with AppLess.

Install Package

Add this package to your project using npm:

npm install --save appless-botkit-adapter

Import the adapter class into your code:

const { AppLessAdapter } = require("appless-botkit-adapter");

Get Started

If you are starting a brand new project, follow these instructions to create a customized application template.

Use AppLessAdapter in your App

AppLessAdapter provides a translation layer for Botkit and BotBuilder so that bot developers can connect to AppLess and have access to the AppLess's API.

Botkit Basics

When used in concert with Botkit, developers need only pass the configured adapter to the Botkit constructor, as seen below. Botkit will automatically connect to AppLess's API in order to receive messages and events.

Developers can then bind to Botkit's event emitting system using controller.on and controller.hears to filter and handle incoming events from the messaging platform. Learn more about Botkit's core feature →.

const adapter = new AppLessAdapter({
    auth_token: process.env.APPLESS_API_HEADER_AUTH_KEY,
    api_host: process.env.APPLESS_API_URL,
});

const controller = new Botkit({
    adapter,
    // ...other options
});

controller.on("message", async (bot, message) => {
    await bot.reply(message, "I heard a message!");
});

BotBuilder Basics

Alternately, developers may choose to use AppLessAdapter with BotBuilder. With BotBuilder, the adapter is used more directly with a webserver, and all incoming events are handled as Activities.

const adapter = new AppLessAdapter({
    auth_token: process.env.APPLESS_API_HEADER_AUTH_KEY,
    api_host: process.env.APPLESS_API_URL,
});

// Create HTTP server.
let server = restify.createServer();
server.listen(process.env.port || process.env.PORT || 3000, function () {
    console.log(`\n${server.name} listening to ${server.url}`);
});

// Listen for incoming requests at /api/messages.
server.use(restify.plugins.bodyParser());
server.post("/api/messages", (req, res) => {
    // Use the adapter to process the incoming web request into a TurnContext object.
    adapter.processActivity(req, res, async (turnContext) => {
        // Do something with this incoming activity!
        if (turnContext.activity.type === "message") {
            // Get the user's text
            const utterance = turnContext.activity.text;
            // send a reply
            await turnContext.sendActivity(`I heard you say ${utterance}`);
        }
    });
});

Event List

Botkit will emit the following events:

Event Description
message a message from a user received in a shared channel

About Botkit

Botkit is a part of the Microsoft Bot Framework.

Botkit is released under the MIT Open Source license