# 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 the 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 the link 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.