feat: add plex media ratingKey and ratingKey4k to webhook payload and… (#1812)

Author: death2all110

docs/using-seerr/notifications/webhook.md

@@ -95,15 +95,17 @@ The `{{media}}` will be `null` if there is no relevant media object for the noti
 
 These following special variables are only included in media-related notifications, such as requests.
 
-| Variable                      | Value                                                                                                          |
-| ------------------------------| -------------------------------------------------------------------------------------------------------------- |
-| `{{media_type}}`              | The media type (`movie` or `tv`)                                                                               |
-| `{{media_imdbid}}`            | The media's IMDb ID                                                                                            |
-| `{{media_tmdbid}}`            | The media's TMDB ID                                                                                            |
-| `{{media_tvdbid}}`            | The media's TheTVDB ID                                                                                         |
-| `{{media_status}}`            | The media's availability status (`UNKNOWN`, `PENDING`, `PROCESSING`, `PARTIALLY_AVAILABLE`, or `AVAILABLE`)    |
-| `{{media_status4k}}`          | The media's 4K availability status (`UNKNOWN`, `PENDING`, `PROCESSING`, `PARTIALLY_AVAILABLE`, or `AVAILABLE`) |
-| `{{media_jellyfinMediaId}}`   | The media's Jellyfin Media ID                                                                                  |
+| Variable                    | Value                                                                                                          |
+| ----------------------------| -------------------------------------------------------------------------------------------------------------- |
+| `{{media_type}}`            | The media type (`movie` or `tv`)                                                                               |
+| `{{media_imdbid}}`          | The media's IMDb ID                                                                                            |
+| `{{media_tmdbid}}`          | The media's TMDB ID                                                                                            |
+| `{{media_tvdbid}}`          | The media's TheTVDB ID                                                                                         |
+| `{{media_status}}`          | The media's availability status (`UNKNOWN`, `PENDING`, `PROCESSING`, `PARTIALLY_AVAILABLE`, or `AVAILABLE`)    |
+| `{{media_status4k}}`        | The media's 4K availability status (`UNKNOWN`, `PENDING`, `PROCESSING`, `PARTIALLY_AVAILABLE`, or `AVAILABLE`) |
+| `{{media_jellyfinMediaId}}` | The media's Jellyfin Media ID                                                                                  |
+| `{{media_plexRatingKey}}`   | The media's Plex ratingKey, if available (for standard library match)                                          |
+| `{{media_plexRatingKey4k}}` | The media's Plex ratingKey for 4K match, if available                                                          |
 
 #### Request
 

server/lib/notifications/agents/webhook.ts

@@ -35,6 +35,8 @@ const KeyMap: Record<string, string | KeyMapFunction> = {
     payload.media ? MediaStatus[payload.media.status] : '',
   media_status4k: (payload) =>
     payload.media ? MediaStatus[payload.media.status4k] : '',
+  media_plexRatingKey: (payload) => payload.media?.ratingKey ?? '',
+  media_plexRatingKey4k: (payload) => payload.media?.ratingKey4k ?? '',
   request_id: 'request.id',
   requestedBy_jellyfinUserId: 'request.requestedBy.jellyfinUserId',
   requestedBy_username: 'request.requestedBy.displayName',