RiveScript is a simple scripting language for chatbots with a friendly, easy to learn syntax.
botpress-rivescript implements the RiveScript language as an incoming middleware and adds extra support for executing arbitraty code. Combining the simplicity of RiveScript and the flexibility of Botpress allows people to create very complex and rich dialogs, including sending Cards, Quick Replies, Buttons, Webviews, etc...
Supported connectors: botpress-messenger
botpress install rivescript
The rivescript module should now be available in your bot UI, and the APIs exposed.
You can split your dialog into multiple Rive files. By default, two files are provided (star.rive and begin.rive), as advised by the official RiveScript documentation.
There's a built-in conversation simulator so that you can test your scripts right from the interface. The simulator also supports JS Code execution, including asynchronous invocations.
If provided, the content of the MiddlewareEvent['user'] is injected into the variables.
For Facebook, first_name, last_name, timezone, locale, gender, avatar_url are available.
+ what is my name
- According to your facebook profile, your name is <get first_name> <get last_name>
The platform is injected in the user variables as the platform name.
+ what platform am i using
- Your talking to me on <get platform>, silly!
+ toc toc
- <call>wait 2000</call>who is there?
+ execute
- JS: console.log(rs, bp, event) // all available
+ log
- JS: bp.logger.info('Hello from RiveScript')
+ quick replies
- JS: bp.messenger.sendText(event.user.id, 'Buy?', { quick_replies: ['Yes', 'No'] })
List all the scripting files and their content.
Create or replace a Rive scripting file. This will automatically trigger an Engine reload.
{
name: string, // *required*, the name of the Rive scripting file
content: string, // *required*, the full content of the script, must be valid RiveScript language
overwrite: boolean // defaults to *false*
}Status 200
Delete a scripting file. This will automatically trigger an Engine reload.
Simulate an incoming message into the RiveScript engine. Does not pass through the middlewares, goes directly to the RiveScript engine. Returns a response.
{
text: string // *required*, the text to send to the RiveScript engine
}"Hello, Human!"
Restart a conversation from scratch, erasing all variables or previous conversational state.
Pull requests are welcomed! We believe that it takes all of us to create something big and impactful.
We have a Public Chatroom, everybody is invited to come and share ideas, issues or simply get in touch.
botpress-rivescript is licensed under AGPL-3.0