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

- [Docs for the new version 2.0 can be found here.](/content/docs/rasa/index.html)

## User Guide

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

## NLU

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

## Core

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

## Conversation Design

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

## API Reference

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

## Migrate from (beta)

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

## Reference

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

## Versions

viewing: 1.10.17

## Events

Conversations in Rasa are represented as a sequence of events.  This page lists the event types defined in Rasa Core.

Note

If you are using the Rasa SDK to write custom actions in python, you need to import the events from `rasa_sdk.events`, not from `rasa.core.events`. If you are writing actions in another language, your events should be formatted like the JSON objects on this page.

### General Purpose Events

- [Set a Slot](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#set-a-slot)
- [Restart a conversation](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#restart-a-conversation)
- [Reset all Slots](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#reset-all-slots)
- [Schedule a reminder](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#schedule-a-reminder)
- [Cancel a reminder](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#cancel-a-reminder)
- [Pause a conversation](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#pause-a-conversation)
- [Resume a conversation](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#resume-a-conversation)
- [Force a followup action](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#force-a-followup-action)

### Automatically tracked events

- [User sent message](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#user-sent-message)
- [Bot responded message](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#bot-responded-message)
- [Undo a user message](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#undo-a-user-message)
- [Undo an action](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#undo-an-action)
- [Log an executed action](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#log-an-executed-action)
- [Start a new conversation session](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#start-a-new-conversation-session)

### [Set a Slot](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#set-a-slot)

Short

Event to set a slot on a tracker

JSON

```
evt = {"event": "slot", "name": "departure_airport", "value": "BER"}
```

Class_class_`rasa.core.events.``SlotSet`( _key_, _value=None_, _timestamp=None_, _metadata=None_)

The user has specified their preference for the value of a `slot`.

Every slot has a name and a value. This event can be used to set a
value for a slot on a conversation.

### [Restart a conversation](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#restart-a-conversation)

Short

Resets anything logged on the tracker.

JSON

```
evt = {"event": "restart"}
```

Class_class_`rasa.core.events.``Restarted`( _timestamp=None_, _metadata=None_)

Conversation should start over & history wiped.

### [Reset all Slots](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#reset-all-slots)

Short

Resets all the slots of a conversation.

JSON

```
evt = {"event": "reset_slots"}
```

Class_class_`rasa.core.events.``AllSlotsReset`( _timestamp=None_, _metadata=None_)

### [Schedule a reminder](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#schedule-a-reminder)

Short

Schedule an intent to be triggered in the future.

JSON

```
evt = {
  "event": "reminder",
  "intent": "my_intent",
  "entities": {"entity1": "value1", "entity2": "value2"},
  "date_time": "2018-09-03T11:41:10.128172",
  "name": "my_reminder",
  "kill_on_user_msg": true,
}
```

### [Cancel a reminder](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#cancel-a-reminder)

Short

Cancel one or more reminders.

JSON

```
evt = {
  "event": "cancel_reminder",
  "name": "my_reminder",
  "intent": "my_intent",
  "entities": [
        {"entity": "entity1", "value": "value1"},
        {"entity": "entity2", "value": "value2"},
    ],
  "date_time": "2018-09-03T11:41:10.128172",
}
```

### [Pause a conversation](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#pause-a-conversation)

Short

Stops the bot from responding to messages. Action prediction
will be halted until resumed.

JSON

```
evt = {"event": "pause"}
```

### [Resume a conversation](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#resume-a-conversation)

Short

Resumes a previously paused conversation. The bot will start
predicting actions again.

JSON

```
evt = {"event": "resume"}
```

### [Force a followup action](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#force-a-followup-action)

Short

Instead of predicting the next action, force the next action
to be a fixed one.

JSON

```
evt = {"event": "followup", "name": "my_action"}
```

### [User sent message](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#user-sent-message)

Short

Message a user sent to the bot.

JSON

```
evt = {
    "event": "user",
    "text": "Hey",
    "parse_data": {
        "intent": {
            "name": "greet",
            "confidence": 0.9
        },
        "entities": []
    },
    "metadata": {},
}
```

### [Bot responded message](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#bot-responded-message)

Short

Message a bot sent to the user.

JSON

```
evt = {"event": "bot", "text": "Hey there!", "data": {}}
```

### [Undo a user message](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#undo-a-user-message)

Short

Undoes all side effects that happened after the last user message
(including the `user` event of the message).

JSON

```
evt = {"event": "rewind"}
```

### [Undo an action](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#undo-an-action)

Short

Undoes all side effects that happened after the last action
(including the `action` event of the action).

JSON

```
evt = {"event": "undo"}
```

### [Log an executed action](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#log-an-executed-action)

Short

Logs an action the bot executed to the conversation. Events that
action created are logged separately.

JSON

```
evt = {"event": "action", "name": "my_action"}
```

### [Start a new conversation session](https://legacy-docs-v1.rasa.com/1.10.17/api/events/#start-a-new-conversation-session)

Short

Marks the beginning of a new conversation session. Resets the tracker and
triggers an `ActionSessionStart` which by default applies the existing
`SlotSet` events to the new session.

JSON

```
evt = {"event": "session_started"}
```

**Warning:** This document is for an old version of Rasa. The latest version is 1.10.26.