---
title: "채팅 조회"
slug: "b2bpls-chats"
updated: 2026-10-20T01:00:35Z
published: 2026-10-20T03:00:25Z
canonical: "api.ncloud-docs.com/b2bpls-chats"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 채팅 조회

채팅을 조회하는 API입니다. B2B PRISM Live Studio에서의 사용 플로우를 확인하려면 [채팅 프로세스](https://guide.ncloud-docs.com/docs/b2bpls-chat)를 참고해 주십시오.

참고

- 라이브에 채팅을 전송하고 조회하고 삭제합니다.
- 채팅 조회는 약 5초 간격으로 라이브가 종료될 때까지 조회합니다.
- 채팅 전송/조회/삭제 API가 제공되지 않을 경우, 채팅 기능을 사용할 수 없습니다.
- 채팅 전송 API만을 제공할 수 있습니다. 단, 이 경우 채팅을 확인할 수 없습니다.

## 요청

요청 형식은 다음과 같습니다.

```
POST /prism/v1/service/live/{liveId}/chat
```

### 요청 헤더

헤더에 대한 설명은 다음과 같습니다.

| 이름 | 타입 | 설명 | 필수 여부 |
| --- | --- | --- | --- |
| x-prism-access-token | String | OAuth2.0 인증을 통해 발급한 Access Token | Y |

### 요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

| 이름 | 타입 | 설명 | 필수 여부 |
| --- | --- | --- | --- |
| liveId | String | 라이브 ID | Y |

### 요청 바디

바디에 대한 설명은 다음과 같습니다.

| 이름 | 타입 | 설명 | 필수 여부 |
| --- | --- | --- | --- |
| maxResults | Number | 가져올 채팅 메시지 최대 개수최대값은 100이며, 0 또는 100이상일 경우 100개만 제공 | Y |
| pageToken | String | 이전 페이지에서 가져온 데이터 이후의 데이터를 가져올 때 사용pageToken != null 일 경우, 지정된 pageToken 이후의 채팅 메시지 목록을 전달pageToken = null & maxResults != 0 일 경우, 최근 메시지 - maxCount만큼 제공pageToken = null & maxResults = 0 일 경우, 최근 메시지 - 100만큼 제공 | N |

## 응답

응답 형식을 설명합니다.

참고

기본 응답 형식은 [API 응답 기본 형식](/docs/b2bpls-overview#%EA%B8%B0%EB%B3%B8%EC%9D%91%EB%8B%B5%ED%98%95%EC%8B%9D)을 참고해 주십시오.

| 이름 | 타입 | 설명 | 필수 여부 |
| --- | --- | --- | --- |
| liveId | String | 라이브 ID | Y |
| nextPageToken | String | 이전에 API로 조회하여 얻은 nextPageToken을 pageToken에 입력하여 조회하면, 새로 입력된 채팅 메시지부터 조회만일 새로 입력된 채팅 메시지가 없을 경우, nextPageToken은 요청한 pageToken과 동일한 값을 제공 | Y |
| messages | Object | 채팅 메시지 목록채팅 메시지가 없을 경우, 해당 항목은 empty array로 제공 | Y |

### message dto

message dto에 대한 설명은 다음과 같습니다.

| 이름 | 타입 | 설명 | 필수 여부 |
| --- | --- | --- | --- |
| messageId | String | 채팅 메시지 ID만일 채팅 삭제 기능이 제공되지 않는다면, messageId는 제공하지 않아도 가능 | N |
| message | String | 채팅 메시지 | Y |
| messageAt | Date | 채팅 메시지가 입력된 시간ISO 8601 형식으로 제공 | N |
| authorId | String | 채팅 메시지를 입력한 userId | Y |
| authorName | String | 채팅 메시지를 입력한 user의 이름이름이 없는 user의 채팅 메시지는 무시 가능 | Y |
| authorProfileThumbnail | String | 채팅 메시지를 입력한 user의 Thumbnail 이미지 authorProfileThumbnail가 없을 경우, thumbnail은 노출되지 않음 | N |
| isLiveOwner | Boolean | 해당 채팅의 유저가 현재 라이브의 스트리머인지 여부프리즘 내 아이디가 다르게 표시될 수 있음없는 경우, 일반 채팅과 동일하게 표시 | N |
| isLiveManager | Boolean | 매니저 기능을 제공하는 경우, 해당 채팅의 유저가 매니저인지 여부프리즘 내 아이디가 다르게 표시될 수 있음없는 경우, 일반 채팅과 동일하게 표시 | N |

### page token 제공 방법

page token 제공 방법은 다음과 같습니다.

![b2bpls-chats_page-token_ko](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/b2bpls-chats_page-token_ko.png?sv=2026-02-06&spr=https&st=2026-10-26T20%3A11%3A43Z&se=2026-10-26T21%3A11%3A43Z&sr=c&sp=r&sig=w8zRukQZlsBIUukwSBjl8d9RhjR6wzcbfl6QVBHrC%2Fo%3D)

## 예시

구문 예시를 소개합니다.

### 요청 예시

구문 예시는 다음과 같습니다.

```
curl -X POST /prism/v1/service/live/{liveId}/chat
    -H "x-prism-access-token: {access-token}"
```

### 응답 예시

구문 예시는 다음과 같습니다.

```
{
    "success": true,
    "errorCode": 0,
    "errorName": null,
    "message": null,
    "data": {
        "liveId": 6,
        "nextPageToken": 8239,
        "messages": [
            {
                "messageId": 12,
                "message": "채팅 작성 테스트 2023-09-05 11:10:27",
                "messageAt": "2023-09-05T11:10:27+09:00",
                "authorId": "admin",
                "authorName": "관리자",
                "authorProfileThumbnail": null,
                "isLiveOwner": true,
                "isLiveManager": false
            },
            {
                "messageId": 13,
                "message": "채팅 작성 테스트 2023-09-05 11:25:11",
                "messageAt": "2023-09-05T11:25:11+09:00",
                "authorId": "admin",
                "authorName": "관리자",
                "authorProfileThumbnail": null,
                "isLiveOwner": true,
                "isLiveManager": false
            }
        ]
    }
}
```