Commit 69d47199 authored by murtaza98's avatar murtaza98

Update Readme.md

parent d4a9ae89
# Apps.Rasa
Integration between Rocket.Chat and the RASA Chatbot platform
### Some Important Concepts of App.Rasa
This app can operate in 2 modes:
1. Synchronous mode
In synchronous mode, the app will make use of Rasa's REST API to exchange message. The app will make use of Rasa's [RESTInput](https://rasa.com/docs/rasa/user-guide/connectors/your-own-website/#restinput) channel.
If you are using this mode, make your you have enabled rest api in `credentials.yml` in your rasa bot. More info about it [here](https://rasa.com/docs/rasa/user-guide/connectors/your-own-website/#restinput)
2. Asynchronous / Callback Mode
In asynchronous mode, the app will make use of callbacks to receive messages from Rasa. The app will make use of Rasa's [CallbackInput](https://rasa.com/docs/rasa/user-guide/connectors/your-own-website/#callbackinput) channel.
Note that if you are using [`Reminders and External events`](https://rasa.com/docs/rasa/core/reminders-and-external-events/#reminders-and-external-events) in your Rasa Chatbot, then you will find this mode useful, as these features are only work in this mode.
If you are using this mode, you will have to make following configuration to Rasa
1. You need to supply a `credentials.yml` with the following content:
```
callback:
url: "http://localhost:3000/api/apps/public/646b8e7d-f1e1-419e-9478-10d0f5bc74d9/callback
"
```
> Find the correct url in the App Details page, under API section.
### Installation steps:
#### Option 1
Download directly from Rocket.Chat marketplace
#### Option 2 (Manual Install)
1. Clone this repo and Change Directory: </br>
`git clone https://github.com/RocketChat/Apps.Rasa.git && cd Apps.Rasa/`
2. Install the required packages from `package.json`: </br>
`npm install`
3. Deploy Rocket.Chat app: </br>
`rc-apps deploy --url http://localhost:3000 --username user_username --password user_password`
Where:
- `http://localhost:3000` is your local server URL (if you are running in another port, change the 3000 to the appropriate port)
- `user_username` is the username of your admin user.
- `user_password` is the password of your admin user.
For more info refer [this](https://rocket.chat/docs/developer-guides/developing-apps/getting-started/) guide
### Rocket.Chat Apps Setup
1. First go ahead n create a Bot User. Login as administrator, then goto `Setting > Users`. There create a new Bot User. This new user should have these 2 roles.</br>
1. bot
2. livechat-agent
2. Then configure the app to automatically assign a livechat-visitor to this bot. To do so, goto `Setting > Livechat > Routing` or `Setting > Omnichannel > Routing`. There enable `Assign new conversations to bot agent` Setting.
3. The app needs some configurations to work, so to setup the app Go to `Setting > Apps > Rasa`. There, fill all the necessary fields in `SETTINGS` and click SAVE. Note all fields are required.
Some of the fields in `SETTING` include
1. Bot Username (required)
- This should contain the same bot username which we created above in Step 1
2. Rasa Server Url (required)
- URL for the Rasa Server goes here. Eg:- `http://localhost:5005`
3. Service Unavailable Message (optional)
- The Bot will send this message to Visitor if service is unavailable like suppose if no agents are online.
4. Close Chat Message (optional)
- This message will be sent automatically when a chat is closed
5. Handover Message (optional)
- The Bot will send this message to Visitor upon handover
6. Enable Callbacks
- Enabling this setting will allow the app to use only callback messages. This feature is useful when you are using Reminder messages in your RASA bot.
### Apps.Rasa's API
The app provides API to trigger specific actions. The URL for the API can be found on the Apps Page(`Setting > Apps > Rasa`). Currently the app provides 2 APIs.
1. Incoming API/Endpoint
This endpoint can be used to trigger specific actions. The list of supported actions include
1. **Close Chat**<br/>
To close a chat
- REST API Documentation for this endpoint can be found [here](./docs/api-endpoints/close-chat.md)
2. **Handover**<br/>
To perform a handover
- REST API Documentation for this endpoint can be found [here](./docs/api-endpoints/perform-handover.md)
2. Callback API/Endpoint
This Endpoint is needed when the App runs in `Asynchronous / Callback Mode` mode. You will have to copy this url to `credentials.yml` file.
### Adding Quick Replies support to your Rasa Bot
- Rasa App provides out of the box support for quick replies. To add quick-replies, you can follow the structure defined in Rasa [here](https://rasa.com/docs/rasa/core/domains/#images-and-buttons)
......@@ -11,5 +11,5 @@
"name": "Rasa",
"nameSlug": "rasa",
"classFile": "RasaApp.ts",
"description": "Integration between Rocket.Chat and the RASA Chatbot platform"
"description": "Integration between Rocket.Chat and the RASA Chatbot platform. Documentation available at: https://github.com/RocketChat/Apps.Rasa"
}
**Close Chat**
----
Action to Close a Chat Session
* **URL**
REST API URL can be found on Apps Page <br />
Sample Url for eg: <br /> `http://localhost:3000/api/apps/public/646b8e7d-f1e1-419e-9478-10d0f5bc74d9/incoming`
* **Method:**
`POST`
* **Input Data Format**
`JSON`
* **Data Params**
**Required:**
1. `action`=`close-chat` <br/>
2. `sessionId=[string]`
> Note. Session Id is the same session of Rasa
* **Success Response:**
* **Code:** 200 <br />
**Content:** `Close chat request handled successfully`
* **Error Response:**
* **Code:** 400 BAD REQUEST <br />
**Content:** <br/>
`{
error: "Error: Session Id not present in request"
}`
OR
* **Code:** 500 Internal Server Error <br />
**Content:** <br />
`{ error : "Error!! Invalid Action type" }`
OR
* **Code:** 500 Internal Server Error <br />
**Content:** <br />
`{ error : "Error occurred while processing close-chat. Details:- [Error Details]" }`
* **Sample Call:**
**Curl**
```bash
curl "http://localhost:3000/api/apps/public/646b8e7d-f1e1-419e-9478-10d0f5bc74d9/incoming" \
-X POST \
-d "{\n \"sessionId\": \"2Sfq8wXw4fYPMf6r4\"\n}" \
-H "Content-Type: application/json"
```
**HTTP**
```HTTP
POST /api/apps/public/646b8e7d-f1e1-419e-9478-10d0f5bc74d9/incoming HTTP/1.1
Host: localhost:3000
Content-Type: application/json
{
"action": "close-chat",
"sessionId": "2Sfq8wXw4fYPMf6r4"
}
```
**Perform Handover**
----
Action to Perform an Handover
* **URL**
REST API URL can be found on Apps Page <br />
Sample Url for eg: <br /> `http://localhost:3000/api/apps/public/646b8e7d-f1e1-419e-9478-10d0f5bc74d9/incoming`
* **Method:**
`POST`
* **Input Data Format**
`JSON`
* **Data Params**
**Required:**
1. `action` = `handover` <br/>
2. `sessionId=[string]`
> Note. Session Id is the same session of Dialogflow
**Optional:**
```
actionData: {
`targetDepartment=[string]`
}
```
* **Success Response:**
* **Code:** 200 <br />
**Content:** `{ result: "Perform Handover request handled successfully" }`
* **Error Response:**
* **Code:** 400 BAD REQUEST <br />
**Content:** <br/>
`{
error: "Error: Session Id not present in request"
}`
OR
* **Code:** 500 Internal Server Error <br />
**Content:** <br />
`{ error : "Error occurred while processing perform-handover. Details:- [Error Details]" }`
* **Sample Call:**
**Curl**
```bash
curl "http://localhost:3000/api/apps/public/646b8e7d-f1e1-419e-9478-10d0f5bc74d9/incoming" \
-X POST \
-d "{\n \"action\": \"close-chat\",\n \"sessionId\": \"GeTEX3iLYpByZWSze\",\n \"actionData\": {\n \"targetDepartment\": \"SalesDepartment\"\n }\n}" \
-H "Content-Type: application/json" \
-H "content-length: 65"
```
**HTTP**
```HTTP
POST /api/apps/public/646b8e7d-f1e1-419e-9478-10d0f5bc74d9/incoming HTTP/1.1
Host: localhost:3000
Content-Type: application/json
{
"action": "handover",
"sessionId": "hmZ9EGL3LFvHSeG2q",
"actionData": {
"targetDepartment": "SalesDepartment"
}
}
```
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment