멘션

채널 메시지에서 특정 사용자를 언급(멘션)하여 알림을 보낼 수 있는 기능입니다.

'멘션' 기능의 동작 방식은 아래와 같습니다.

'멘션' 기능만을 위한 독립적인 API는 존재하지 않으며, 기존 API 응답 데이터에 '멘션' 정보를 포함하는 방식으로 동작합니다.
멘션된 유저는 별도의 푸시 알림(리모트 푸시, SDK 사용 필요)을 수신합니다.

'멘션' 정보를 포함한 API 응답¶

기존 채널 메시지 내역 조회 API 응답에 포함된 '멘션' 정보를 설명합니다.

Response body > data > content > pluginData¶

채널 메시지에 '멘션' 정보가 있을 경우, 채널 메시지 내역 조회 API 응답 본문 중 data > content > pluginData 에 mentions 필드가 포함됩니다.

필드명	설명	타입
mentions	멘션 정보	object array

Response body > data > content > pluginData > mentions¶

필드명	설명	타입
playerId	멘션된 유저의 Player ID	long

Response sample¶

{
  // ... 중략
        "content": [
            {
                "gameIndex": 1374,
                "from": 1,
                "messageId": "ggJ5Csh15J-mI3i5",
                "extraData": "",
                "pluginData": {
                    "mentions": [
                        {
                            "playerId": 101
                        }
                    ]
                },
                "to": "public:10",
                "message": "aaa",
                "langCode": "ko",
                "timestamp": "2025-07-17T00:56:17.156Z",
                "timestampMillis": 1752713777156
            }
        ]
  // ... 중략
}