# Media Gateway event types (/en/api-reference/api-ref/rtmp-gateway/media-gateway-event-types)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

After you enable the Agora message notification service, Agora sends channel event notifications to your server through HTTPS `POST` callbacks. When the callback request body contains `product_id: 10`, the event belongs to Media Gateway.

This page describes the Media Gateway event types returned in channel event callbacks.

## `live_stream_connected` [#live_stream_connected]

The gateway has received the RTMP or SRT stream and successfully entered the channel.

```json
{
  "sid": "55df7402-8778-11ee-92ed-07ec2e86c928",
  "region": "na",
  "domain": "rtls-ingress-prod-na.agoramdn.com",
  "streamKey": "7B***Qbs",
  "rtcInfo": {
    "channel": "123",
    "uid": "1234"
  },
  "transcoding": {
    "audio": {
      "enabled": true,
      "profile": 5
    },
    "video": {
      "enabled": true,
      "bitrate": 3800,
      "fps": 30,
      "height": 1080,
      "width": 1920
    }
  },
  "beginAt": "2023-11-21T02:27:31Z"
}
```

| Field         | Type   | Description                                                                                                                                                               |
| :------------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `sid`         | String | The unique ID of each streaming session.                                                                                                                                  |
| `region`      | String | The server area that has received the pushed stream.                                                                                                                      |
| `streamKey`   | String | The streaming key used by the stream.                                                                                                                                     |
| `rtcInfo`     | Object | RTC information, including `channel` and `uid`. When `channel` or `uid` is empty or `0` in the streaming key, this field stores the generated value used for this stream. |
| `transcoding` | Object | Transcoding configuration information used for streaming.                                                                                                                 |
| `beginAt`     | String | The streaming start time in RFC 3339 format.                                                                                                                              |

This event is followed by a corresponding `live_stream_disconnected` event.

## `live_stream_disconnected` [#live_stream_disconnected]

The gateway has actively or passively disconnected and left the channel.

```json
{
  "sid": "55df7402-8778-11ee-92ed-07ec2e86c928",
  "region": "na",
  "streamKey": "7B***Qbs",
  "domain": "rtls-ingress-prod-na.agoramdn.com:1935",
  "rtcInfo": {
    "channel": "123",
    "uid": "1234"
  },
  "streamStats": {
    "inputAudioBytes": 281799,
    "inputVideoBytes": 9244544,
    "outputAudioBytes": 130000,
    "outputVideoBytes": 6656704
  },
  "beginAt": "2023-11-21T02:27:31Z",
  "endAt": "2023-11-21T03:27:31Z"
}
```

| Field         | Type   | Description                                                                                                    |
| :------------ | :----- | :------------------------------------------------------------------------------------------------------------- |
| `sid`         | String | The unique ID of each streaming session.                                                                       |
| `region`      | String | The server area that has received the pushed stream.                                                           |
| `streamKey`   | String | The streaming key used by the stream.                                                                          |
| `rtcInfo`     | Object | RTC information, including `channel` and `uid`.                                                                |
| `streamStats` | Object | Stream statistics, including `inputAudioBytes`, `inputVideoBytes`, `outputAudioBytes`, and `outputVideoBytes`. |
| `beginAt`     | String | The streaming start time in RFC 3339 format.                                                                   |
| `endAt`       | String | The streaming end time in RFC 3339 format.                                                                     |

## `live_stream_aborted` [#live_stream_aborted]

The gateway has received an RTMP or SRT stream but terminated it for some reason. This event may be sent individually or between `live_stream_connected` and `live_stream_disconnected`.

```json
{
  "sid": "55df7402-8778-11ee-92ed-07ec2e86c928",
  "region": "na",
  "domain": "rtls-ingress-prod-na.agoramdn.com",
  "streamKey": "7B***Qbs",
  "rtcInfo": {
    "channel": "123",
    "uid": "1234"
  },
  "beginAt": "2023-11-21T02:27:31Z",
  "errorCode": 100,
  "reason": "invalid"
}
```

| Field       | Type   | Description                                          |
| :---------- | :----- | :--------------------------------------------------- |
| `sid`       | String | The unique ID of each streaming session.             |
| `region`    | String | The server area that has received the pushed stream. |
| `domain`    | String | The domain used for streaming.                       |
| `streamKey` | String | The streaming key used by the stream.                |
| `rtcInfo`   | Object | RTC information, including `channel` and `uid`.      |
| `beginAt`   | String | The streaming start time in RFC 3339 format.         |
| `errorCode` | Number | The stream termination error code.                   |
| `reason`    | String | The error message.                                   |

| `errorCode` | Description                                                                                        | Recommended action                                                                                                                                      |
| :---------- | :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `1`         | Illegal `streamKey`, for example an empty `channelName` or unsupported characters.                 | Check the `streamKey` format, especially for locally generated keys.                                                                                    |
| `2`         | Invalid `streamKey`, such as an expired or deleted key.                                            | Create a new `streamKey` and try again.                                                                                                                 |
| `3`         | No permission to use this `streamKey`, for example when the custom domain and app ID do not match. | Check whether the `streamKey` matches the domain name used for the push.                                                                                |
| `4`         | Number of concurrent streams exceeds the limit.                                                    | Wait and retry.                                                                                                                                         |
| `5`         | Conflict detected, for example pushing to the same channel at the same time.                       | If the streams are not being pushed at the same time, try again after 5 to 10 seconds.                                                                  |
| `6`         | Stream attribute exceeds the limit. Currently, this applies to bitrate only.                       | Check the streaming software configuration and lower the target bitrate.                                                                                |
| `7`         | Streaming without audio or video data for more than 10 seconds.                                    | Check whether the last push exited abnormally, and then try again.                                                                                      |
| `8`         | Failed to join the channel.                                                                        | The `reason` field provides the specific error reason, for example `connect to rtc failed, reason:$N`.                                                  |
| `9`         | Disconnected from the main network.                                                                | Try again several times. If the problem persists, contact technical support to confirm whether the app certificate provided during activation is valid. |
| `10`        | Unknown internal service error.                                                                    | Try again several times. If the problem persists, contact technical support.                                                                            |

## `live_profile_updated` [#live_profile_updated]

Stream properties have been updated. For example, the first audio or video frame has been received, or the audio or video profile has changed.

```json
{
  "sid": "55df7402-8778-11ee-92ed-07ec2e86c928",
  "region": "na",
  "domain": "rtls-ingress-prod-na.agoramdn.com",
  "streamKey": "7B***Qbs",
  "rtcInfo": {
    "channel": "123",
    "uid": "1234"
  },
  "videoProfile": {
    "codec": "H.264",
    "width": 1920,
    "height": 1080,
    "gop": 2000
  },
  "audioProfile": {
    "sampleRate": 48000,
    "channels": 2
  },
  "beginAt": "2023-11-21T02:27:31Z"
}
```

| Field          | Type   | Description                                                                                              |
| :------------- | :----- | :------------------------------------------------------------------------------------------------------- |
| `sid`          | String | The unique ID of each streaming session.                                                                 |
| `region`       | String | The server area that has received the pushed stream.                                                     |
| `streamKey`    | String | The streaming key used by the stream.                                                                    |
| `rtcInfo`      | Object | RTC information, including `channel` and `uid`.                                                          |
| `videoProfile` | Object | Video properties. Not applicable for audio-only streams. Includes `codec`, `width`, `height`, and `gop`. |
| `audioProfile` | Object | Audio properties, including `sampleRate` and `channels`.                                                 |
| `beginAt`      | String | The streaming start time in RFC 3339 format.                                                             |