# 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  
**Short**  
Event to set a slot on a tracker  
**JSON**  
```json
evt = {"event": "slot", "name": "departure_airport", "value": "BER"}
```  
The user has specified their preference for the value of a `slot`.

### Restart a conversation  
**Short**  
Resets anything logged on the tracker.  
**JSON**  
```json
evt = {"event": "restart"}
```  
Conversation should start over & history wiped.

### Reset all Slots  
**Short**  
Resets all the slots of a conversation.  
**JSON**  
```json
evt = {"event": "reset_slots"}
```  
If you want to keep the dialogue history and only want to reset the slots, you can use this event to set all the slots to their initial values.

### Schedule a reminder  
**Short**  
Schedule an intent to be triggered in the future.  
**JSON**  
```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,
}
```  
Schedules the asynchronous triggering of a user intent (with entities if needed) at a given time.

### Cancel a reminder  
**Short**  
Cancel one or more reminders.  
**JSON**  
```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",
}
```  
Cancel certain jobs.

### Pause a conversation  
**Short**  
Stops the bot from responding to messages. Action prediction will be halted until resumed.  
**JSON**  
```json
evt = {"event": "pause"}
```  
Ignore messages from the user to let a human take over.

### Resume a conversation  
**Short**  
Resumes a previously paused conversation. The bot will start predicting actions again.  
**JSON**  
```json
evt = {"event": "resume"}
```  
Bot takes over conversation.

### Force a followup action  
**Short**  
Instead of predicting the next action, force the next action to be a fixed one.  
**JSON**  
```json
evt = {"event": "followup", "name": "my_action"}
```  
Enqueue a followup action.

## Automatically tracked events

### User sent message  
**Short**  
Message a user sent to the bot.  
**JSON**  
```json
evt = {
    "event": "user",
    "text": "Hey",
    "parse_data": {
        "intent": {
            "name": "greet",
            "confidence": 0.9
        },
        "entities": []
    },
    "metadata": {},
}
```  
The user has said something to the bot.

### Bot responded message  
**Short**  
Message a bot sent to the user.  
**JSON**  
```json
evt = {"event": "bot", "text": "Hey there!", "data": {}}
```  
The bot has said something to the user.

### Undo a user message  
**Short**  
Undoes all side effects that happened after the last user message (including the `user` event of the message).  
**JSON**  
```json
evt = {"event": "rewind"}
```  
Bot reverts everything until before the most recent user message.

### Undo an action  
**Short**  
Undoes all side effects that happened after the last action (including the `action` event of the action).  
**JSON**  
```json
evt = {"event": "undo"}
```  
Bot undoes its last action.

### Log an executed action  
**Short**  
Logs an action the bot executed to the conversation. Events that action created are logged separately.  
**JSON**  
```json
evt = {"event": "action", "name": "my_action"}
```  
An operation describes an action taken + its result.

### 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**  
```json
evt = {"event": "session_started"}
```  
Mark the beginning of a new conversation session.