# online_status

Fires when bot's online status changes.

# Incoming and outgoing parameters

The input parameters is being sent to your HTTP script along with this event. Output parameters (if any) should be generated by your script.

## Input parameters

| Parameter | Required | Value |
|-----------|----------|-------|
| action    | yes      | = online_status |
| bot_name  | yes      | the SL name of your bot |
| channel   | yes      | the unique bot id |
| cid       | yes      | internal HTTP connection identifier (you can ignore this value) |

## Input parameters specific for `online_status`

| Parameter | Required | Description |
|-----------|----------|-------------|
| status    | yes      | connection status, one of: LOGGED_OUT, CONNECTING, ONLINE, LOGGING_OUT, LOGIN_ERROR |
| details   | yes      | free-form detailed text about the new status |
| location  | yes      | bot's location, Region/X/Y/Z |