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

### User Guide

- [Installation](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/installation/)
- [Tutorial: Rasa Basics](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/rasa-tutorial/)
- [Tutorial: Building Assistants](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/building-assistants/)
- [Command Line Interface](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/command-line-interface/)
- [Architecture](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/architecture/)
- [Messaging and Voice Channels](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/messaging-and-voice-channels/)
- [Evaluating Models](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/evaluating-models/)
- [Validate Data](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/validate-files/)
- [Configuring the HTTP API](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/configuring-http-api/)
- [Deploying your Rasa Assistant](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/how-to-deploy/)
- [Cloud Storage](https://legacy-docs-v1.rasa.com/1.8.1/user-guide/cloud-storage/)

### NLU

- [About](https://legacy-docs-v1.rasa.com/1.8.1/nlu/about/)
- [Using NLU Only](https://legacy-docs-v1.rasa.com/1.8.1/nlu/using-nlu-only/)
- [Training Data Format](https://legacy-docs-v1.rasa.com/1.8.1/nlu/training-data-format/)
- [Choosing a Pipeline](https://legacy-docs-v1.rasa.com/1.8.1/nlu/choosing-a-pipeline/)
- [Language Support](https://legacy-docs-v1.rasa.com/1.8.1/nlu/language-support/)
- [Entity Extraction](https://legacy-docs-v1.rasa.com/1.8.1/nlu/entity-extraction/)
- [Components](https://legacy-docs-v1.rasa.com/1.8.1/nlu/components/)

### Core

- [About](https://legacy-docs-v1.rasa.com/1.8.1/core/about/)  
- [Stories](https://legacy-docs-v1.rasa.com/1.8.1/core/stories/)  
- [Domains](https://legacy-docs-v1.rasa.com/1.8.1/core/domains/)  
- [Responses](https://legacy-docs-v1.rasa.com/1.8.1/core/responses/)  
- [Actions](https://legacy-docs-v1.rasa.com/1.8.1/core/actions/)  
- [Reminders and External Events](https://legacy-docs-v1.rasa.com/1.8.1/core/reminders-and-external-events/)  
- [Policies](https://legacy-docs-v1.rasa.com/1.8.1/core/policies/)  
- [Slots](https://legacy-docs-v1.rasa.com/1.8.1/core/slots/)  
- [Forms](https://legacy-docs-v1.rasa.com/1.8.1/core/forms/)  
- [Retrieval Actions](https://legacy-docs-v1.rasa.com/1.8.1/core/retrieval-actions/)  
- [Interactive Learning](https://legacy-docs-v1.rasa.com/1.8.1/core/interactive-learning/)  
- [Fallback Actions](https://legacy-docs-v1.rasa.com/1.8.1/core/fallback-actions/)  
- [Knowledge Base Actions](https://legacy-docs-v1.rasa.com/1.8.1/core/knowledge-bases/)

### Conversation Design

- [Dialogue Elements](https://legacy-docs-v1.rasa.com/1.8.1/dialogue-elements/dialogue-elements/)  
- [Small Talk](https://legacy-docs-v1.rasa.com/1.8.1/dialogue-elements/small-talk/)  
- [Completing Tasks](https://legacy-docs-v1.rasa.com/1.8.1/dialogue-elements/completing-tasks/)  
- [Guiding Users](https://legacy-docs-v1.rasa.com/1.8.1/dialogue-elements/guiding-users/)

### API Reference

- [Action Server](https://legacy-docs-v1.rasa.com/1.8.1/api/action-server/)  
- [HTTP API](https://legacy-docs-v1.rasa.com/1.8.1/api/http-api/)  
- [Jupyter Notebooks](https://legacy-docs-v1.rasa.com/1.8.1/api/jupyter-notebooks/)  
- [Agent](https://legacy-docs-v1.rasa.com/1.8.1/api/agent/)  
- [Custom NLU Components](https://legacy-docs-v1.rasa.com/1.8.1/api/custom-nlu-components/)  
- [Rasa SDK](https://legacy-docs-v1.rasa.com/1.8.1/api/rasa-sdk/)  
- [Events](https://legacy-docs-v1.rasa.com/1.8.1/api/events/)  
- [Tracker](https://legacy-docs-v1.rasa.com/1.8.1/api/tracker/)  
- [Tracker Stores](https://legacy-docs-v1.rasa.com/1.8.1/api/tracker-stores/)  
- [Event Brokers](https://legacy-docs-v1.rasa.com/1.8.1/api/event-brokers/)  
- [Lock Stores](https://legacy-docs-v1.rasa.com/1.8.1/api/lock-stores/)  
- [Training Data Importers](https://legacy-docs-v1.rasa.com/1.8.1/api/training-data-importers/)  
- [Featurization of Conversations](https://legacy-docs-v1.rasa.com/1.8.1/api/core-featurization/)  
- [TensorFlow Configuration](https://legacy-docs-v1.rasa.com/1.8.1/api/tensorflow_usage/)  
- [Migration Guide](https://legacy-docs-v1.rasa.com/1.8.1/migration-guide/)  
- [Rasa Open Source Change Log](https://legacy-docs-v1.rasa.com/1.8.1/changelog/)

### Migrate from (beta)

- [Dialogflow](https://legacy-docs-v1.rasa.com/1.8.1/migrate-from/google-dialogflow-to-rasa/)  
- [Wit.ai](https://legacy-docs-v1.rasa.com/1.8.1/migrate-from/facebook-wit-ai-to-rasa/)  
- [LUIS](https://legacy-docs-v1.rasa.com/1.8.1/migrate-from/microsoft-luis-to-rasa/)  
- [IBM Watson](https://legacy-docs-v1.rasa.com/1.8.1/migrate-from/ibm-watson-to-rasa/)

### Reference

- [Glossary](https://legacy-docs-v1.rasa.com/1.8.1/glossary/)

### Versions

Viewing: 1.8.1

### Telegram

You first have to create a Telegram bot to get credentials. Once you have them you can add these to your `credentials.yml`.

#### Getting Credentials

**How to get the Telegram credentials:**  
You need to set up a Telegram bot.

1. To create the bot, go to [Bot Father](https://web.telegram.org/#/im?p=@BotFather), enter `/newbot` and follow the instructions.
2. At the end you should get your `access_token` and the username you set will be your `verify`.
3. If you want to use your bot in a group setting, it’s advisable to turn on group privacy mode by entering `/setprivacy`. Then the bot will only listen when a user’s message starts with `/bot`.

For more information, check out the [Telegram HTTP API](https://core.telegram.org/bots/api).

#### Running on Telegram

If you want to connect to telegram using the run script, e.g. using:
```bash
rasa run
```

you need to supply a `credentials.yml` with the following content:
```yaml
telegram:
  access_token: "490161424:AAGlRxinBRtKGb21_rlOEMtDFZMXBl6EC0o"
  verify: "your_bot"
  webhook_url: "https://your_url.com/webhooks/telegram/webhook"
```

👋 I can help you get started with Rasa and answer your technical questions.
