> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/chinese-simplified/webhook/webhook-shi-jian.md).

# Webhook 事件

## 1. **玩家受处罚**

当对玩家实施处罚并且其 `user_status` 已更新时触发。 

*事件类型：* `player-sanctioned`

*适用于：* 聊天、语音、游戏和 Discord

*触发条件：* 当玩家通过以下任一方式受到处罚时

* GGWP 的自动审核
* 直接通过仪表板

*注意：* 如果以下情况，则不会触发该事件 [更新状态 API](/chinese-simplified/api-wen-dang-shang-xia-wen-xin-xi/wan-jia-zhuang-tai.md) 被用于更改玩家状态。

*载荷说明：*

* **类型**：webhook 事件类型。默认为 `player-sanctioned` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时的时间戳，格式为 YYYY-MM-DD HH:MM:SS，UTC。
* **data**：包含其他事件详细信息的字典。包括： 
  * **session\_id**：在适用情况下，处罚起始所在会话的标识符。
  * **incident\_id**：触发玩家处罚的事件标识符（如适用）。
  * **user\_id**：受处罚玩家的标识符。
  * **用户名**：受处罚玩家的显示名称。
  * **reputation\_score**：玩家声誉分数（150 到 850 之间）。
  * **时间戳**：处罚发生时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
  * **channel**：指示处罚应用的位置。支持的渠道有 `聊天`, `语音`, `游戏` 和 `discord`.
  * **incident\_types**：与触发玩家处罚的事件相关的事件类型列表（如适用）。
  * **严重级别**：触发玩家处罚的事件严重程度（如适用）。可能的值为 `低`, `中等`, `高`.
  * **confidence**：触发玩家处罚的事件置信度（如适用）。可能的值为 `低`, `中等`, `高`, `很高`.
  * **messages**：包含与该事件相关消息详情的字典列表（如适用）。包括：
    * **message\_id**：触发事件创建的消息标识符。
    * **audio\_id**：触发事件创建的音频片段标识符（如适用）。
    * **消息**：触发事件创建的消息。
    * **filtered\_message**：由聊天 API 返回的、已屏蔽不当内容的消息版本。
    * **时间戳**：消息发送时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
    * **语言**：消息语言。支持语言的完整列表请参见 <https://docs.ggwp.com/api-docs-chat#language-support>.
    * **元数据**：与该事件相关联的消息元数据（如适用）。
  * **player\_sanction**：描述所应用处罚的字典。包括：
    * **status**：更新后的玩家状态。可能的值为 `session-muted` 和 `已禁言`.
    * **duration**：处罚持续时间，单位为秒。如果处罚是无限期应用，此值将为 `null`.
    * **expiry\_at**：处罚到期时间。这应为将处罚持续时间加到触发时间戳后的结果。如果处罚是无限期应用，此值将为 `null`.
  * **举报者：** 过去两周内举报该受处罚玩家的玩家列表。它是一个包含其 `user_id` 和 `用户名`.
  * **sanctioned\_by：** 描述对玩家实施处罚者的字典。包括：
    * **类型：** 可以是 `humanmod` （如果由版主手动处罚）或 `自动审核` （如果由 Automod 服务自动处罚）。
    * **邮箱：** 对该玩家实施处罚的版主邮箱。 *注意：键 `email` 在以下情况缺失： `type == automod` .*
    * **名称：** 对该玩家实施处罚的版主名称。可以是 `null` 如果名称不可用，则为 null。 *注意：键 `名称` 在以下情况缺失： `type == automod` .*
  * **ladder\_level\_change：** 包含玩家受到处罚时段位变化信息的字典。其 `ladder_level_change` 可以是 `null` 如果游戏未订阅 Automod 服务，则为。

    * **current\_ladder\_level：** 保存一个整数，表示处罚生效时的段位等级。&#x20;
    * **previous\_ladder\_level：** 保存一个整数，表示处罚生效前的段位等级。

    *注意：*

    * 值 0 表示玩家尚未进入段位。
    * 如果处罚未导致段位变化，则两个值可以相同。
  * **incident\_count：** 包含玩家过去 30 天内所有非零负面事件计数的字典，按来源分组（例如， `聊天`, `player_reports`, `语音`，等等）以及 incident\_type（例如， `profanity`, `言语辱骂`，等等）。&#x20;

    *注意：*&#x20;

    * 一个事件可以关联多个事件类别。计数表示按给定类别分组的事件数。
    * 键 `incident_count` **r**eturns an empty dictionary when no incidents are recorded
  * **来源***（可选）***:** 保存事件来源。 *注意：这是一个可选键，仅在 `incident_id` 存在时发送。*

#### 示例载荷&#x20;

{% code overflow="wrap" %}

```json
{
  "type": "player-sanctioned",
  "event_id": "edce24d3-bf56-46b4-b5ea-40266mnaa5a84",
  "created_at": "2022-06-02 16:49:00",
  "data": {
    "session_id": "freeforallsession_o34u2",
    "incident_id": "20230629051500.000000-1aaf864e-1cdc-4c10-b1f2-ec90bfd4b244",
    "user_id": "12aladf91",
    "username": "sharonsfakeaccount",
    "reputation_score": 150,
    "timestamp": "2022-06-02 16:49:00",
    "channel": "chat",
    "incident_types": ["identity_hate", "chat_verbal_abuse"],
    "severity": "high",
    "confidence": "高",
    "messages": [
      {
        "message_id": "20240905234945.804840-19ea0a90-ecf8-4daa-849c-b9e0ef7cc705",
        "message": "不，你才是个婊子",
        "filtered_message": "不，你才是个 *****",
        "timestamp": "2024-09-05 23:49:45",
        "language": "英语",
        "metadata": {
          "position": {
            "x": 154,
            "y": 112,
            "z": 77
          }
        }
      }
    ],
    "player_sanction": {
      "status": "已禁言",
      "duration": 86400,
      "expiry_at": "2022-06-03 16:49:00"
    },
    "reporters": [
      {
        "username": "satish0521",
        "user_id": "101628273075088104"
      },
      {
        "username": "krishnan_ggwp_001",
        "user_id": "100730037617480092"
      },
      {
        "username": "sunandaisro",
        "user_id": "100901564882486072"
      }
    ],
    "sanctioned_by": {
      "type": "humanmod",
      "email": "sahil@fakeaccount.com",
      "name": "sahil"
    },
    "ladder_level_change": {
      "current_ladder_level": 1,
      "previous_ladder_level": 0
    },
    "incident_count": {
      "chat": {
        "chat_severe_verbal_abuse": 2,
        "identity_hate": 2,
        "threat": 2,
        "verbally_abusive_language": 2
      },
      "player_reports": {
        "cheating": 1,
        "exploiting": 1,
        "griefing": 1
      },
      "voice": {
        "sexual_reference": 2,
        "threat": 2,
        "verbally_abusive_language": 2
      }
    },
    "source": "chat"
  }
}
```

{% endcode %}

## **2. 玩家恢复**

先前受处罚的玩家现在已恢复为活跃状态。

*事件类型：* `player-reinstated`

*适用于：* 聊天、语音、游戏和 Discord

*触发条件：* 当玩家状态恢复为活跃时。这可能是由于

* 版主恢复该玩家
* 玩家已完成处罚

*注意：* 如果以下情况，则不会触发该事件 [更新状态 API](/chinese-simplified/api-wen-dang-shang-xia-wen-xin-xi/wan-jia-zhuang-tai.md) 被用于更改玩家状态。

*载荷说明：*

* **类型**：webhook 事件类型。默认为 `player-reinstated` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时的时间戳，格式为 YYYY-MM-DD HH:MM:SS，UTC。
* **data**：包含其他事件详细信息的字典。包括：&#x20;
  * **user\_id**：恢复状态玩家的标识符。
  * **用户名**：恢复状态玩家的显示名称。
  * **reputation\_score**：玩家声誉分数（150 到 850 之间）。
  * **时间戳**：恢复发生时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
  * **channel**：指示恢复发生的位置。支持的渠道有 `聊天`, `语音`, `游戏` 和 `discord`.
  * **status**：更新后的玩家状态。默认为 `active` 用于此事件。
  * **reinstated\_by：** 描述恢复该玩家者的字典。包括：
    * **类型：** 可以是 `humanmod` （如果由版主手动恢复）或 `自动审核` （当处罚完成后由 Automod 服务自动恢复时）。
    * **邮箱：** 恢复该玩家的版主邮箱。 *注意：键 `email` 在以下情况缺失： `type == automod` .*
    * **名称：** 恢复该玩家的版主名称。可以是 `null` 如果名称不可用，则为 null。 *注意：键 `名称` 在以下情况缺失： `type == automod` .*

#### 示例载荷&#x20;

{% code overflow="wrap" %}

````json
{
  "type": "player-reinstated",
  "event_id": "edce24d3-bf56-46b4-b5ea-40266mnaa5a84",
  "created_at": "2022-06-02 16:49:00",
  "data": {
    "user_id": "12aladf91",
    "username": "sharonsfakeaccount",
    "reputation_score": 150,
    "timestamp": "2022-06-02 16:49:00",
    "channel": "chat",
    "status": "active",
    "reinstated_by": {
      "type": "humanmod",
      "email": "sunanda@ggwp.com",
      "name": "sunanda"
    }
```
  }
}
````

{% endcode %}

## **3. 警告**

玩家正表现出有害行为，GGWP 希望建议向其发送警告，以缓和其有害言行。

*事件类型：* `player-warning`

*适用于：* 聊天、语音和游戏

*触发条件：* 如果 automod 因中等及以上置信度的事件而降低了玩家的声誉分数

*注意：* 该事件仅为订阅了 automod 的客户生成。

*载荷说明：*

* **类型**：webhook 事件类型。默认为 `player-warning` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时的时间戳，格式为 YYYY-MM-DD HH:MM:SS，UTC。
* **data**：包含其他事件详细信息的字典。包括：&#x20;
  * **session\_id**：警告起源所在会话的标识符。
  * **incident\_id**：触发警告的事件标识符。
  * **messages**：包含与该事件相关消息详情的字典列表（如适用）。包括：
    * **message\_id**：触发事件创建的消息标识符。
    * **audio\_id**：触发事件创建的音频片段标识符（如适用）。
    * **消息**：触发事件创建的消息。
    * **filtered\_message**：由聊天 API 返回的、已屏蔽不当内容的消息版本。
    * **时间戳**：消息发送时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
    * **语言**：消息语言。支持语言的完整列表请参见 <https://docs.ggwp.com/api-docs-chat#language-support>.
    * **元数据**：与该事件相关联的消息元数据（如适用）。
  * **user\_id**：被警告玩家的标识符。
  * **用户名**：被警告玩家的显示名称。
  * **reputation\_score**：玩家声誉分数（150 到 850 之间）。
  * **时间戳**：警告发出时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
  * **channel**：指示处罚应用的位置。支持的渠道有 `聊天`, `语音` 和 `游戏` .
  * **incident\_types**：与触发警告的事件相关的事件类型列表（如适用）。
  * **严重级别**：触发警告的事件严重程度（如适用）。可能的值为 `低`, `中等`, `高`.
  * **confidence**：触发警告的事件置信度（如适用）。可能的值为 `低`, `中等`, `高`, `很高`.
  * **warned\_by：** 描述发出警告者的字典。包括：
    * **类型：** 可以是 `humanmod` （如果由版主手动发出警告）或 `自动审核` （如果由 Automod 服务自动发出）。
    * **邮箱：** 发出警告的版主邮箱。\
      *注意：键 `email` 在以下情况缺失： `type == automod`.*
    * **名称：** 发出警告的版主名称。如果名称不可用，则可以为 null。\
      *注意：键 `名称` 在以下情况缺失： `type == automod`.*
  * **recommended\_warning**：建议包含在玩家通知中的消息。

#### 示例载荷&#x20;

{% code overflow="wrap" %}

```json
{
  "type": "player-warning",
  "event_id": "edce24d3-bf56-46b4-b5ea-40266mnaa5a84",
  "created_at": "2022-06-02 16:49:00",
  "data": {
    "session_id": "freeforallsession_o34u2",
    "incident_id": "20230629051500.000000-1aaf864e-1cdc-4c10-b1f2-ec90bfd4b244",
    "messages": [
      {
        "message_id": "20240905234945.804840-19ea0a90-ecf8-4daa-849c-b9e0ef7cc705",
        "message": "不，你才是个婊子",
        "filtered_message": "不，你才是个 *****",
        "timestamp": "2024-09-05 23:49:45",
        "language": "英语",
        "metadata": {
          "position": {
            "x": 154,
            "y": 112,
            "z": 77
          }
        }
      }
    ],
    "user_id": "12aladf91",
    "username": "sharonsfakeaccount",
    "reputation_score": 150,
    "timestamp" : "2022-06-02 16:49:00",
    "channel": "chat", 
    "incident_types": ["identity_hate", "chat_verbal_abuse"],
    "severity": "high",
    "confidence": "高",
    "warned_by": {
      "type": "humanmod",
      "email": "moderator@example.com",
      "name": "John"
    },
    "recommended_warning": "这是基于你最近聊天行为的警告。请不要再发送任何冒犯性消息，以免被禁言。"
  }
}
```

{% endcode %}

## **4. 工作流集成**

事件的任何工作流属性都可在仪表板中更改。

*事件类型：* `incident-updated`

*触发条件：* 当与事件相关的以下任一属性的值发生变化时

* `status` -> `not-reviewed`, `reviewed`,`in-process`, `archived`, `escalated-for-deeper-review`
* `confidence` -> `very_low`, `低`, `中等`, `高`, `很高`
* `严重级别` -> `低`, `中等`, `高`
* `准确性` -> `not-confirmed`, `confirm-accurate`, `mark-inaccurate`, `dismiss-incident`
* `incident_assignee` -> 指派人的邮箱 ID。如果不存在指派人，则值为 `null`
* `incident_types`

*载荷说明：*

* **类型**：webhook 事件类型。默认为 `incident-updated` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时的时间戳，格式为 YYYY-MM-DD HH:MM:SS，UTC。
* **data**：包含其他事件详细信息的字典。包括：&#x20;
  * **incident\_id**：已更新事件的标识符。
  * **时间戳**：事件更新时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
  * **user\_id**：受处罚玩家的标识符。
  * **用户名**：受处罚玩家的显示名称。
  * **reputation\_score**：玩家声誉分数（150 到 850 之间）。
  * **incident\_details**：描述事件更新的字典。包括：
    * **user**：更新事件属性的版主/管理员信息。
    * **来源：** ：指示事件应用的位置。支持的来源有 `聊天`, `语音`, `player_reports` , `discord` , `usernames`  和 `image` .
    * **session\_id**：事件起源会话的标识符（如适用）。
    * **changelog**：包含旧的和新的事件详情的字典。包括：
      * **from**：应用更新前的旧值字典。
      * **to**：应用更新后的新值字典。
  * **messages**：包含与该事件相关消息详情的字典列表（如适用）。包括：&#x20;
    * **message\_id**：触发事件创建的消息标识符。
    * **audio\_id**：触发事件创建的音频片段标识符（如适用）。
    * **消息**：触发事件创建的消息。
    * **filtered\_message**：由聊天 API 返回的、已屏蔽不当内容的消息版本。
    * **时间戳**：消息发送时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
    * **语言**：消息语言。支持语言的完整列表请参见 <https://docs.ggwp.com/api-docs-chat#language-support>.
    * **元数据**：与该事件相关联的消息元数据（如适用）。

#### 示例载荷&#x20;

* 当版主被分配到工单时

{% code overflow="wrap" %}

```json
{
  "type": "incident-updated",
  "event_id": "edce24d3-bf56-46b4-b5ea-40266mnaa5a84",
  "created_at": "2022-06-02 16:49:00",
  "data": {
    "incident_id": "20230629051500.000000-1aaf864e-1cdc-4c10-b1f2-ec90bfd4b244",
    "timestamp" : "2022-06-02 16:49:00", 
    "user_id": "12aladf91",
    "username": "sharonsfakeaccount",
    "reputation_score": 150,
    "incident_details": {
      "user": "appuser@ggwp.com",
      "source": "chat",
      "session_id": "sessio9999999",
      "changelog": {
	"from": {"incident_assignee": null},
	"to": {"incident_assignee": "newmoderator@ggwp.com"}
      }
    },
    "messages": [
      {
        "message_id": "20240905234945.804840-19ea0a90-ecf8-4daa-849c-b9e0ef7cc705",
        "message": "不，你才是个婊子",
        "filtered_message": "不，你才是个 *****",
        "timestamp": "2024-09-05 23:49:45",
        "language": "英语",
        "metadata": {
          "position": {
            "x": 154,
            "y": 112,
            "z": 77
          }
        }
      }
    ]
  }
}
```

{% endcode %}

* 当事件被标记为准确时，从而更改置信度级别

{% code overflow="wrap" %}

```json
{
  "type": "incident-updated",
  "event_id": "182a35b0-5e5c-49d3-9d91-210aaaf51497",
  "created_at": "2024-02-23 10:41:03",
  "data": {
    "incident_id": "20240223094326.000000-ee79cba4-be6d-4d50-bfa9-cec5efe64f21",
    "timestamp": "2024-02-23 10:41:03",
    "user_id": "12aladf91",
    "username": "sharonsfakeaccount",
    "reputation_score": 150,
    "incident_details": {
      "user": "appuser@ggwp.com",
      "source": "chat",
      "session_id": "sessio9999999",
      "changelog": {
        "from": {
          "status": "not-reviewed",
          "confidence": "medium",
          "accuracy": "not-confirmed"
        },
        "to": {
          "status": "reviewed",
          "confidence": "very high",
          "accuracy": "confirm-accurate"
        }
      }
    },
    "messages": [
      {
        "message_id": "20240905234945.804840-19ea0a90-ecf8-4daa-849c-b9e0ef7cc705",
        "message": "不，你才是个婊子",
        "filtered_message": "不，你才是个 *****",
        "timestamp": "2024-09-05 23:49:45",
        "language": "英语",
        "metadata": {
          "position": {
            "x": 154,
            "y": 112,
            "z": 77
          }
        }
      }
    ]
  }
}
```

{% endcode %}

* 当事件被标记为不准确且其事件类型发生变化时。请注意，置信度会更改为 `很高` 由于人工干预。

{% code overflow="wrap" %}

```json
{
  "type": "incident-updated",
  "event_id": "383a9aae-1845-4448-b485-ff72d1afee2e",
  "created_at": "2024-02-23 10:41:33",
  "data": {
    "incident_id": "20240223094326.000000-ee79cba4-be6d-4d50-bfa9-cec5efe64f21",
    "timestamp": "2024-02-23 10:41:33",
    "user_id": "12aladf91",
    "username": "sharonsfakeaccount",
    "reputation_score": 150,
    "incident_details": {
      "user": "appuser@ggwp.com",
      "source": "chat",
      "session_id": "sessio9999999",
      "changelog": {
        "from": {
          "status": "reviewed",
          "confidence": "very high",
          "incident_types": [
            "chat_offensive_language",
            "profanity"
          ],
          "accuracy": "confirm-accurate"
        },
        "to": {
          "status": "reviewed",
          "confidence": "very high",
          "incident_types": [
            "chat_verbal_abuse"
          ],
          "accuracy": "mark-inaccurate"
        }
      }
    },
    "messages": [
      {
        "message_id": "20240905234945.804840-19ea0a90-ecf8-4daa-849c-b9e0ef7cc705",
        "message": "不，你才是个婊子",
        "filtered_message": "不，你才是个 *****",
        "timestamp": "2024-09-05 23:49:45",
        "language": "英语",
        "metadata": {
          "position": {
            "x": 154,
            "y": 112,
            "z": 77
          }
        }
      }
    ]
  }
}
```

{% endcode %}

## 5. **检测到事件**

当检测到新事件时触发。

*事件类型：* `incident-detected`

*适用于：* 聊天、语音、玩家举报、Discord、用户名和图片。

*触发条件：* 当通过以下任一方式创建事件时

* 聊天消息
* 语音转录
* 玩家举报
* Discord 消息
* 用户名创建
* 图片

*载荷说明：*

* **类型**：webhook 事件类型。默认为 `incident-detected` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时的时间戳，格式为 YYYY-MM-DD HH:MM:SS，UTC。
* **data**：包含其他事件详细信息的字典。包括：&#x20;
  * **session\_id**：事件起源会话的标识符（如适用（n*ot applicable for usernames*)
  * **incident\_id**：事件的标识符。
  * **messages**：包含与该事件相关的消息详情的字典列表（a*pplicable for chat, voice, discord only*）。包括：
    * **message\_id**：触发事件创建的消息标识符。
    * **audio\_id**：触发事件创建的音频片段标识符（如适用）。
    * **消息**：触发事件创建的消息。
    * **filtered\_message**：由聊天 API 返回的、已屏蔽不当内容的消息版本。
    * **时间戳**：消息发送时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
    * **语言**：消息语言。支持语言的完整列表请参见 <https://docs.ggwp.com/api-docs-chat#language-support>.
    * **元数据**：与该事件相关联的消息元数据（如适用）。
  * **user\_id**：发送有害消息的玩家标识符（聊天、语音、Discord 和用户名）或通过玩家举报被举报的玩家标识符。
  * **用户名**：玩家的显示名称（ `null` 适用于没有用户名的用户或在用户名创建期间的无效用户）。
  * **reputation\_score**：玩家声誉分数（150 到 850 之间）（不适用于用户名）
  * **时间戳**：检测到事件的时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
  * **来源**：指示事件应用的位置。支持的来源有 `聊天`, `语音`, `player_reports` , `discord` , `usernames` 和 `image` .
  * **incident\_types**：与该事件相关的事件类型列表。
  * **严重级别**：事件严重程度。可能的值为 `低`, `中等`, `高`.
  * **confidence**：事件置信度。可能的值为 `低`, `中等`, `高`, `很高`.
  * **举报者**：举报者列表（如适用，*仅适用于 player\_reports*）。包括：
    * **user\_id**：发送举报的玩家标识符。
    * **用户名**：发送举报的玩家显示名称。
    * **comment**：解释举报原因的评论（如适用）。
  * **flagged\_usernames**：被标记的用户名列表 *（仅适用于用户名）。* 包括：
    * **用户名ID**：触发创建事件的被标记用户名的唯一标识符。
    * **用户名**：触发创建事件的用户名。
    * **时间戳**：用户名发送时间，格式为 YYYY-MM-DD HH:MM:SS，UTC 时区。
  * **被标记图像**：被标记图像列表 *（仅适用于图像）。* 包括：
    * **图像ID**：触发创建事件的被标记图像的唯一标识符。
    * **时间戳**：图像发送时间，格式为 YYYY-MM-DD HH:MM:SS，UTC 时区。

#### 示例载荷&#x20;

* 当检测到聊天事件时

{% code overflow="wrap" %}

```json
{
  "type": "incident-detected",
  "event_id": "09152afb-7a61-4348-9959-6d1938f7f044",
  "created_at": "2024-09-05 23:49:45",
  "data": {
    "session_id": "sessio9999999",
    "incident_id": "20240905234945.804840-b9da93e1-82e0-47b4-adce-ac9ee3cd8cde",
    "user_id": "12aladf91",
    "username": "sharonsfakeaccount",
    "reputation_score": 345,
    "timestamp": "2024-09-05 23:49:45",
    "incident_types": [
      "聊天语言辱骂",
      "身份仇恨"
    ],
    "severity": "high",
    "confidence": "medium",
    "source": "chat",
    "messages": [
      {
        "message_id": "20240905234945.804840-19ea0a90-ecf8-4daa-849c-b9e0ef7cc705",
        "message": "不，你才是个婊子",
        "filtered_message": "不，你才是个 *****",
        "timestamp": "2024-09-05 23:49:45",
        "language": "英语",
        "metadata": {
          "position": {
            "x": 154,
            "y": 112,
            "z": 77
          }
        }
      }
    ]
  }
}
```

{% endcode %}

* 当检测到语音事件时

{% code overflow="wrap" %}

```json
{
  "type": "incident-detected",
  "event_id": "09152afb-7a61-4348-9959-6d1938f7f044",
  "created_at": "2024-04-10 05:50:39",
  "data": {
    "session_id": "sessio9999999",
    "incident_id": "20240410054953.222782-b9da93e1-82e0-47b4-adce-ac9ee3cd8cde",
    "user_id": "12aladf91",
    "username": "sharonsfakeaccount",
    "reputation_score": 345,
    "timestamp": "2024-09-05 23:49:45",
    "incident_types": [
      "聊天语言辱骂",
      "身份仇恨"
    ],
    "severity": "high",
    "confidence": "medium",
    "source": "语音",
    "messages": [
      {
        "message_id": "20240410054953.222782-2072ec67-f3b6-4c2d-bfa4-9cc13f81b7a8",
        "audio_id": "fe8ef39c-0d70-417f-9087-6f4cf7ad5308",
        "message": "不，你是个婊子",
        "filtered_message": "不，你是个 *****",
        "timestamp": "2024-04-10 05:49:53",
        "language": "英语"
      }
    ]
  }
}
```

{% endcode %}

* 当检测到 Discord 事件时

```json
{
  "type": "incident-detected",
  "event_id": "13f219b9-2a09-4736-91ec-d783df5f5bf9",
  "created_at": "2024-09-05 23:49:45",
  "data": {
    "session_id": "1008833492383178872_1025355886220288060",
    "incident_id": "20240905234945.804840-c9f36850-0ea3-41b3-831c-647c2a81e737",
    "user_id": "8e6eebe7-944f-4209-a94e-9a79e1cb7a41",
    "username": "clive",
    "reputation_score": 450,
    "timestamp": "2024-09-05 23:49:45",
    "incident_types": [
      "chat_offensive_language",
      "批评游戏玩法"
    ],
    "severity": "低",
    "confidence": "medium",
    "source": "Discord",
    "messages": [
      {
        "message_id": "20240905234945.804840-19ea0a90-ecf8-4daa-849c-b9e0ef7cc705",
        "message": "你们真烂",
        "filtered_message": "你们 ****",
        "timestamp": "2024-09-05 23:49:45",
        "language": "英语"
      }
    ]
  }
}
```

* 当检测到玩家举报事件时

```json
{
  "type": "incident-detected",
  "event_id": "c8476d6b-fcd4-4254-b762-8b1b825d4995",
  "created_at": "2024-04-10 07:17:27",
  "data": {
    "session_id": "1008833492383178872_1025355886220288060",
    "incident_id": "12b2e6cd-7d5b-5f30-9b29-a61dc631351f",
    "user_id": "12aladf91",
    "username": "sharonsfakeaccount",
    "reputation_score": 212,
    "timestamp": "2024-04-10 07:14:51",
    "incident_types": [
      "作弊"
    ],
    "severity": "低",
    "confidence": "低",
    "source": "玩家举报",
    "reporters": [
      {
        "username": "clive",
        "user_id": "8e6eebe7-944f-4209-a94e-9a79e1cb7a41",
        "comment": "游戏里骂人"
      }
    ]
  }
}
```

* 当检测到用户名事件时

```json
{
  "type": "incident-detected",
  "event_id": "9fcea299-13d7-42e4-9317-c4a431b7a877",
  "created_at": "2025-05-27 23:39:32",
  "data": {
    "incident_id": "20250527233727-2c9b5c4f-105e-4d8c-aaa1-e3122c80f703",
    "user_id": "user1234",
    "username": null,
    "timestamp": "2025-05-27 23:37:27",
    "incident_types": [
      "色情内容",
      "语言辱骂"
    ],
    "severity": "低",
    "confidence": "高",
    "source": "用户名",
    "flagged_usernames": [
      {
        "username_id": "20250527233727-3db17bf0-4748-488c-a187-b409a9a73155",
        "username": "BigCock",
        "timestamp": "2025-05-27 23:37:27"
      }
    ]
  }
}
```

* 当检测到图像事件时

```json
{
  "type": "incident-detected",
  "event_id": "3954725b-1cb8-44dc-9827-bd839f3848bd",
  "created_at": "2026-06-18 04:13:52",
  "data": {
    "incident_id": "20260618041318.965248-14a03030-e573-4920-9e53-c9155d003b57",
    "user_id": "user1234",
    "username": null,
    "timestamp": "2026-06-18 04:13:18",
    "incident_types": [
      "酒精/毒品"
    ],
    "severity": "低",
    "confidence": "高",
    "source": "图像",
    "flagged_images": [
      {
        "image_id": "20260618041318.965248-732f7827-a53d-49c0-8f04-34e96fb7940f",
        "timestamp": "2026-06-18 04:13:18"
      }
    ]
  }
}
```

## 6. 玩家声誉分数批量导出

当声誉分数批量 CSV 准备好可供下载时触发，在调用 [声誉批量 API](/chinese-simplified/api-wen-dang-xin-yu/xin-yu-fen-shu-pi-liang.md).&#x20;

*事件类型：* `玩家声誉批量导出`

*触发条件：* 当声誉分数批量 CSV 准备好可供下载时触发

*载荷说明：*

* **类型**：webhook 事件类型。默认为 `玩家声誉批量导出` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时的时间戳，格式为 YYYY-MM-DD HH:MM:SS，UTC。
* **data**：包含其他事件详细信息的字典。包括：&#x20;
  * csv\_urls：包含所有用户声誉分数数据的 CSV 文件链接。

#### 示例载荷

{% code overflow="wrap" %}

```json
{
  "type": "player-reputation-batch-export",
  "event_id": "6dd903ba-c464-4a78-9706-88c9d5ee455e",
  "created_at": "2024-10-08 05:18:48",
  "data": {
    "csv_urls": [
      "https://ggwp-list-export.com/dev/91012e3b8a27426a95a43a3d84bad440-players.csv?AWSAccessKeyId=ASIAQEFB2&Signature=xP8B%2Bw2F1O8rFHYhfJ8Vj7p0KkI%3D&x-amz-security-token=IQoJbRjURp%3D&Expires=1728366528"
    ]
  }
}
```

{% endcode %}

**注意：** 如果用户数量超过 1,000,000，数据将拆分为多个 CSV 文件。

## 7. 诱骗警报

*事件类型：* `诱骗警报`

*适用于：* 聊天、语音和 Discord

*触发条件：* 当基于玩家沟通模式创建新的诱骗标记时触发

*载荷说明：*

* **类型**：webhook 事件类型。默认为 `诱骗警报` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时的时间戳，格式为 YYYY-MM-DD HH:MM:SS，UTC。
* **data**：包含其他事件详细信息的字典。包括：&#x20;
  * **user\_id：** 被标记为可能存在诱骗风险的玩家唯一标识符。
  * **用户名：** 玩家的显示名称。
  * **日期：** 事件被检测到的时间，格式为 YYYY-MM-DD。
  * **来源：** 检测到事件的来源。支持的值包括： `聊天`, `语音`, `discord`.
  * **风险等级：** 基于汇总指标衡量警报的置信度。可能的值包括： `低`, `中等`, `高`.&#x20;
  * **最高风险指标：** 对该警报贡献最大的指标。这些指标代表被标记用户相较于典型用户沟通表现出的异常行为信号。可能的值包括：
    * 询问年龄 - 试图确定目标的年龄。
    * 调情行为 - 对目标外表的赞美。
    * 询问性别 - 试图确定目标的性别。
    * 个人身份信息索取 - 索取可识别个人身份的信息。
    * 侵犯隐私 - 打探目标的居住情况或感情状态。
    * 索要照片 - 要求提供目标身体的图像或视频。
    * 邀请见面 - 试图安排线下会面。
    * 隐秘语言 - 鼓励目标将对话对他人保密的措辞。
    * 色情内容 - 无明确指向的露骨性语言或内容。
    * 性骚扰 - 有指向性的性语言或行为，旨在性化、物化、侮辱、施压或贬低对方。
    * 性暴力 - 涉及、威胁、美化或描述包含暴力、强迫、胁迫或缺乏同意的性行为的性语言。
  * **声誉分数：** 玩家的声誉分数（介于 150 到 850 之间）。

#### 示例载荷

{% code overflow="wrap" %}

```json
{
  "type": "grooming-alert",
  "event_id": "a914c763-22b8-4f65-b7b2-46a912e1df0a",
  "created_at": "2025-07-03 09:12:27",
  "data": {
    "user_id": "plr_5829zb",
    "username": "crimsonvale",
    "date": "2025-07-03",
    "source": "chat",
    "risk_level": "高",
    "top_risk_indicators": [
      "调情行为", 
      "侵犯隐私",
      "询问年龄"
    ],
    "reputation_score": 657
  }
}
```

{% endcode %}

## 8. 心理健康警报

*事件类型：* `心理健康警报`

*适用于：* 聊天、语音和 Discord

*触发条件：* 当基于玩家沟通模式创建新的心理健康标记时触发

*载荷说明：*

* **类型**：webhook 事件类型。默认为 `心理健康警报` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时的时间戳，格式为 YYYY-MM-DD HH:MM:SS，UTC。
* **data**：包含其他事件详细信息的字典。包括：&#x20;
  * **user\_id：** 被标记为可能存在心理健康风险的玩家唯一标识符。
  * **用户名：** 玩家的显示名称。
  * **日期：** 事件被检测到的时间，格式为 YYYY-MM-DD。
  * **来源：** 检测到事件的来源。支持的值包括： `聊天`, `语音`, `discord`.
  * **风险等级：** 基于汇总指标衡量警报的置信度。可能的值包括： `低`, `中等`, `高`.&#x20;
  * **最高风险指标：i**ndicators contributing the most to this alert. These represent communication patterns where the flagged user exhibited signs of potential distress or abnormal emotional behavior compared to typical user interactions. Possible values include:
    * 家庭冲突 - 涉及虐待、紧张的家庭关系、家庭争吵或失去家庭支持系统的内容。
    * 经济困难 - 涉及无法负担食物、住房或日常基本必需品等经济压力的内容。
    * 教育压力 - 与学业压力、倦怠、辍学或学校/大学环境中的社交困难相关的困扰。
    * 关系困扰 - 与恋爱关系相关的情绪困扰，包括感到不被爱、与伴侣冲突或害怕被抛弃。
    * 自伤 - 声称有意对自己造成身体伤害，或提及过去或持续的自伤行为。
    * 自我厌恶 - 表达对自己的深深厌恶、觉得自己不配被爱或归属，或者认为自己的存在没有价值。
    * 自杀意念 - 表达想死、觉得如果没有自己世界会更好，或正在认真考虑自杀。
  * **声誉分数：** 玩家的声誉分数（介于 150 到 850 之间）。

#### 示例载荷

{% code overflow="wrap" %}

```json
{
  "type": "mental-health-alert",
  "event_id": "f913d2e1-4b8e-4f0b-a1b7-8e4a930cd3d6",
  "created_at": "2025-08-22 11:39:28",
  "data": {
    "user_id": "plr_6729qw",
    "username": "nova_ember",
    "date": "2025-08-22",
    "source": "chat",
    "risk_level": "中",
    "top_risk_indicators": [
      "自杀意念", 
      "自伤", 
      "家庭冲突"
    ],
    "reputation_score": 328
  }
}
```

{% endcode %}

## 9. 玩家流失风险

玩家正基于行为指标显现出早期流失迹象，并可能面临较高的流失风险。处理此事件可使客户支持或 Live Ops 进行主动干预——例如提醒、优惠或复核——在玩家完全流失之前采取行动。

*事件类型：* `玩家流失风险`

*适用于：* 聊天

*触发条件：* 当玩家近期行为基于多个参与度因素超过定义的流失风险阈值时触发。只有高风险等级才会触发此事件。

*载荷说明：*

* **类型**：Webhook 事件类型。默认值为 `玩家流失风险` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时间，格式为 YYYY-MM-DD HH:MM:SS，UTC 时区。
* **data**：包含所有其他事件详情的容器。
  * **user\_id**：处于风险中的玩家唯一标识符。
  * **用户名**：玩家的显示名称。
  * **时间戳**：流失风险判定时间（UTC）。
  * **risk\_factors**：导致流失风险的参与度维度列表。每个事件仅包含最相关的指标。可能的值包括：
    * `活动稀少`
    * `社交互动少`
    * `参与度下降`
    * `消息投入减少`
    * `新玩家`
    * `协作不足`
    * `积极性有限`
    * `语言不清晰`
    * `冲突信号`
    * `技术问题`
  * **reports\_filed**：玩家在过去 30 天内提交的举报摘要。包括按类型统计的举报数量字典（例如：骚扰、作弊）
  * **reports\_received**：过去 30 天内针对该玩家提交的举报摘要。包括按类型统计的举报数量字典（例如：辱骂、刷屏）

#### 示例载荷

{% code overflow="wrap" %}

```json
{
  "type": "player-churn-risk",
  "event_id": "b328e182-d4fc-4f2b-b302-d0f9152bb08a",
  "created_at": "2025-06-12 18:45:00",
  "data": {
    "user_id": "plr_8391xa",
    "username": "runefirex",
    "timestamp": "2025-06-12 18:44:50",
    "risk_factors": [
      "参与度下降", 
      "协作不足", 
      "技术问题"
    ],
    "sessions_with_flagged_players": 15,
    "reports_filed": {
      "作弊": 4,
      "bullying": 6
    },
    "reports_received": {
      "abusing": 4,
      "作弊": 1
    }
  }
}
```

{% endcode %}

## 10. **消息反馈**&#x20;

*事件类型：* `消息反馈`

*适用于：* 聊天、语音和 Discord

*触发条件：* 当审核员为非负面事件或消息提交反馈时触发。

*载荷说明：*

* **类型**：webhook 事件类型。默认为 `消息反馈` 用于此事件。
* **event\_id**：事件的唯一标识符。
* **created\_at**：事件触发时的时间戳，格式为 YYYY-MM-DD HH:MM:SS，UTC。
* **data**：包含其他事件详细信息的字典。包括：&#x20;
  * **incident\_id**：与反馈相关的事件标识符——可以是现有的非负面事件，也可以是为该消息新建的事件。
  * **session\_id**：事件来源会话的标识符（如适用）
  * **时间戳**：反馈提交时间，格式为 YYYY-MM-DD HH:MM:SS，UTC 时区。
  * **user\_id**：发送该消息的玩家标识符。
  * **用户名**：发送该消息的玩家显示名称。
  * **reputation\_score**：玩家声誉分数（150 到 850 之间）。
  * **来源**：表示事件/消息的来源。支持的来源有 `聊天`, `语音`, `discord`.
  * **严重级别**：提交反馈的事件严重程度。可选值为 `低`, `中等`, `高`.
  * **confidence**：提交反馈的事件置信度。可选值为 `低`, `中等`, `高`, `很高`.
  * **score\_change**：提交的反馈导致的玩家分数变化
  * **incident\_types**：审核员提交的反馈中所包含的事件类型列表。
  * **反馈**：审核员提交的反馈消息
  * **submitted\_by**：提交反馈的审核员邮箱（如适用）
  * **message\_details**：包含与事件相关的消息详情的字典（如适用）。其中包括：
    * **message\_id**：提交反馈的消息标识符。
    * **audio\_id**：提交反馈的音频片段标识符（如适用）。
    * **消息**：提交反馈的消息内容。
    * **filtered\_message**：由聊天 API 返回的、已屏蔽不当内容的消息版本。
    * **时间戳**：消息发送时间，格式为 YYYY-MM-DD HH:MM:SS，UTC。
    * **语言**：消息语言。支持语言的完整列表请参见 <https://docs.ggwp.com/api-docs-chat#language-support>.
    * **元数据**：与该事件相关联的消息元数据（如适用）。

#### 示例载荷&#x20;

{% code overflow="wrap" %}

```json
{
  "type": "message-feedback",
  "event_id": "c0af414d-5bc8-4176-a574-e2e511a31980",
  "created_at": "2026-01-21 11:55:05",
  "data": {
    "incident_id": "20260121113632.810202-c49d9cc9-00a1-4246-8945-624b78818d0c",
    "session_id": "jan_20_2026_s05",
    "timestamp": "2026-01-21 11:55:05",
    "user_id": "jan_20_2026_u05",
    "username": "jan_20_2026_u05",
    "reputation_score": 450,
    "source": "chat",
    "severity": "中",
    "confidence": "very high",
    "score_change": -10,
    "incident_types": [
      "bullying"
    ],
    "feedback": "霸凌消息",
    "user": "krishnan@ggwp.com",
    "message_details": {
      "message_id": "20260121113632.810202-3e95db1f-fccc-4c60-8638-f01449e69a57",
      "message": "嘿，伙计",
      "filtered_message": "嘿，伙计",
      "timestamp": "2026-01-21 11:36:32"
      "language": "英语"
    }
  }
}
```

{% endcode %}