Admin API인스타 DM 자동응답
대화 상세
한 상대와 주고받은 내역을 최신순으로 조회합니다.
대화 상세
한 상대와 주고받은 내역을 최신순으로, 페이지 단위로 조회합니다. 메시지마다 받은편지함(folder)이 붙습니다.
2026-10-01 응답 형태가 바뀌었습니다. data 가 배열이 아니라 items + page 객체이고, limit 대신
page·size 를 받습니다.
HTTP 요청
GET /ai/admin/ig-dm/threads/{peerIgsid}/messages?page=0&size=50&folder=ALL
Authorization: Bearer {access_token}Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
peerIgsid | String | 예 | 인스타 사용자 ID |
Query Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
page | Integer | 아니오 | 0부터 시작. 0 이 가장 최근입니다. 기본 0 |
size | Integer | 아니오 | 페이지 크기. 기본 50, 상한 200 |
folder | String | 아니오 | ALL(기본) / PARTNERSHIP / GENERAL |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "대화 내역을 조회했습니다.",
"data": {
"items": [
{
"id": 6,
"direction": "OUT",
"folder": "GENERAL",
"body": "안녕하세요, Glow.B입니다.\n연락 주셔서 감사합니다.",
"matchedRule": "GREETING",
"blockedReason": null,
"quotedAmount": null,
"quoteBase": null,
"metaCreatedAt": null,
"createdAt": "2026-08-11T12:01:07"
},
{
"id": 4,
"direction": "OUT",
"folder": "GENERAL",
"body": null,
"matchedRule": "PRICE_INQUIRY",
"blockedReason": "NO_QUOTE",
"quotedAmount": null,
"quoteBase": null,
"metaCreatedAt": null,
"createdAt": "2026-08-11T11:49:05"
}
],
"page": { "number": 0, "size": 50, "totalElements": 2, "totalPages": 1 }
}
}| 필드 | 설명 |
|---|---|
direction | IN 은 크리에이터가 보낸 것, OUT 은 우리가 보낸 것 |
folder | PARTNERSHIP = 파트너십 받은편지함 / GENERAL = 일반 DM. 같은 상대라도 두 대화가 섞여 옵니다 — 나눠 보려면 folder 로 거르세요 |
matchedRule | 걸린 규칙 이름. 매칭이 없으면 null |
blockedReason | null 이면 정상 발송. 값이 있으면 보내지 않은 것이고 그 값이 사유입니다 |
quotedAmount | 제시한 금액 |
quoteBase | 산정 기준가. 금액이 어떻게 나왔는지 사후에 재현하기 위한 값입니다 |
blockedReason 값의 의미는 개요 문서를 참고하세요.
에러 응답
| 상태 코드 | 설명 |
|---|---|
400 | folder 등 쿼리 값이 잘못됨 (code: VALIDATION_ERROR, HTTP 상태도 400) |
401 | 인증 실패 |
403 | ADMIN 권한 없음 |