Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Use Recast.ai to chat with your Botkit-powered Bot !

This middleware plugin for Botkit allows you to seamlessly integrate Recast.ai natural language intent APIs into your Botkit bot.

You can use the Recast.AI API to analyse your text or your audio file, and extract useful informations from it, to personalize your IoT, classify your data or create bots.

Requirements

Set up your Recast.AI account

  • Log into your Recast.AI account and create a new bot.

Get your token

  • In your profile, click your bot.
  • In the tab-menu, click on the little screw.
  • Here is the request access token you will need to configure your bot.

Set up your Botkit based project

  • Add botkit-middleware-recastai as a dependency to your Botkit bot :

npm install --save botkit-middleware-recastai

  • Enable the middleware :
const RecastaiMiddleware = require('botkit-middleware-recastai')({
        request_token: '322e96b09ef75ad32bfc8b6f22b857ef',
        confidence: 0.4
});

controller.middleware.receive.use(RecastaiMiddleware.receive);

controller.hears(['news'],'message_received', RecastaiMiddleware.hears,function(bot, message) {

 // ...
});

What it does

Using this middleware with Botkit causes every message sent to your bot to be first sent through recast API for processing. The response from recast is then returned in the incoming messages as seen below :

"intents": [
  {
    "slug": "weather",
    "confidence": 0.95
  }
],
"act": "wh-query",
"sentiment": "neutral",
"entities": {
  "location": [
    {
      "formatted": "London, UK",
      "lng": -0.1277583,
      "lat": 51.5073509,
      "type": "locality",
      "place": "ChIJdd4hrwug2EcRmSrV3Vo6llI",
      "raw": "London",
      "confidence": 0.99
    }
  ],
  "datetime": [
    {
      "formatted": "Thursday, 06 October 2016 at 09:00:00 AM",
      "iso": "2016-10-06T09:00:00Z",
      "accuracy": "day",
      "chronology": "future",
      "raw": "next Thursday",
      "confidence": 0.95
    }
  ]
}

Using the recast hears middleware tells Botkit to look for Recast intents information, and match using this information instead of the built in pattern matching function.

Have fun coding your bot :)

License

This project is licensed under the terms of the MIT license. Full license text is available in LICENSE.md.

About

Middleware for using Recast.ai with Botkit-powered bots

Topics

Resources

License

Packages

No packages published