These docs are for version 1.x of Rasa Open Source.

User Guide
----------

- **[Installation](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/installation/)**
- **[Tutorial: Rasa Basics](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/rasa-tutorial/)**
- **[Tutorial: Building Assistants](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/building-assistants/)**
- **[Command Line Interface](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/command-line-interface/)**
- **[Architecture](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/architecture/)**
- **[Messaging and Voice Channels](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/messaging-and-voice-channels/)**
- **[Testing Your Assistant](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/testing-your-assistant/)**
- **[Setting up CI/CD](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/setting-up-ci-cd/)**
- **[Validate Data](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/validate-files/)**
- **[Configuring the HTTP API](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/configuring-http-api/)**
- **[Deploying Your Rasa Assistant](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/how-to-deploy/)**
- **[Cloud Storage](https://legacy-docs-v1.rasa.com/1.10.12/user-guide/cloud-storage/)**

Cisco Webex Teams
-----------------

You first have to create a Cisco Webex app to get credentials. Once you have them you can add these to your `credentials.yml`.

### Getting Credentials

**How to get the Cisco Webex Teams credentials:**

You need to set up a bot. Please visit below link to create a bot [Webex Authentication](https://developer.webex.com/authentication.html).

After you have created the bot through Cisco Webex Teams, you need to create a room in Cisco Webex Teams. Then add the bot in the room the same way you would add a person in the room.

You need to note down the room ID for the room you created. This room ID will be used in `room` variable in the `credentials.yml` file.

Please follow this link below to find the room ID `https://developer.webex.com/endpoint-rooms-get.html`

### Running on Cisco Webex

If you want to connect to the `webexteams` input channel using the run script, e.g. using:

```
rasa run
```

you need to supply a `credentials.yml` with the following content:

```
webexteams:
  access_token: "YOUR-BOT-ACCESS-TOKEN"
  room: "YOUR-CISCOWEBEXTEAMS-ROOM-ID"
```

The endpoint for receiving Cisco Webex Teams messages is `http://localhost:5005/webhooks/webexteams/webhook`, replacing the host and port with the appropriate values. This is the URL you should add in the OAuth & Permissions section.

**Note**  
If you do not set the `room` keyword argument, messages will be delivered back to the user who sent them.