메인 콘텐츠로 건너뛰기
GET
/
projects
/
{projectId}
/
users
/
{userId}
/
message-history
get-user-message-history
curl --request GET \
  --url https://api.notifly.tech/projects/{projectId}/users/{userId}/message-history \
  --header 'Authorization: <api-key>'
{
  "data": {
    "message_history": [
      {
        "id": "abc123",
        "event_name": "send_success",
        "channel": "push-notification",
        "resource_id": "camp_001",
        "sub_resource_id": "var_001",
        "resource_type": "campaign",
        "created_at": "2026-03-30T12:00:00.000Z",
        "updated_at": "2026-03-30T12:00:00.000Z"
      },
      {
        "id": "def456",
        "event_name": "push_click",
        "channel": "push-notification",
        "resource_id": "camp_001",
        "sub_resource_id": "var_001",
        "resource_type": "campaign",
        "created_at": "2026-03-30T12:05:00.000Z",
        "updated_at": "2026-03-30T12:05:00.000Z"
      }
    ],
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wMy0zMFQxMjowNTowMC4wMDBaIn0="
  },
  "error": null
}
Cursor 기반 페이지네이션이 API는 cursor 기반 페이지네이션을 사용합니다. 응답의 next_cursor 값을 다음 요청의 cursor 파라미터로 전달하여 다음 페이지를 조회합니다. next_cursor가 null이면 마지막 페이지입니다.
주요 이벤트명
이벤트명설명
send_success발송 성공
send_failure발송 실패
push_click푸시 클릭
push_delivered푸시 도달
in_app_message_show인앱 메시지 노출
in_web_message_show인웹 메시지 노출
main_button_click메인 버튼 클릭
close_button_click닫기 버튼 클릭
failover_text_message_send_success대체 문자 발송 성공
failover_text_message_send_failure대체 문자 발송 실패
이 외에도 채널별로 추가 이벤트가 존재할 수 있습니다.
날짜 필터 사용 시 주의사항start_date와 end_date를 사용할 경우, timezone 파라미터가 반드시 함께 전달되어야 합니다. 또한 start_date와 end_date는 항상 쌍으로 사용해야 합니다.

인증

​
Authorization
string
header
필수

POST /authenticate로 발급받은 인증 토큰

경로 매개변수

​
projectId
string
필수

프로젝트 ID (32자 hex string)

Pattern: ^[0-9a-f]{32}$
​
userId
string
필수

유저의 external_user_id

Minimum string length: 1

쿼리 매개변수

​
page_size
integer
기본값:20

페이지 크기 (1~100, 기본값 20)

필수 범위: 1 <= x <= 100
​
cursor
string

이전 응답의 next_cursor 값

​
channel
enum<string>

채널 필터

사용 가능한 옵션:
push-notification,
web-push-notification,
email,
text-message,
kakao-alimtalk,
kakao-friendtalk,
kakao-brand-message,
line,
in-app-message,
in-web-message,
webhook
​
resource_type
enum<string>

리소스 유형 (campaign 또는 user_journey)

사용 가능한 옵션:
campaign,
user_journey
​
resource_id
string

리소스 ID (사용 시 resource_type 필수)

​
start_date
string<date>

조회 시작 날짜 (YYYY-MM-DD, inclusive, end_date 및 timezone과 함께 사용)

​
end_date
string<date>

조회 종료 날짜 (YYYY-MM-DD, inclusive, start_date 및 timezone과 함께 사용)

​
timezone
string

날짜 해석 기준 timezone (IANA 형식, 예: Asia/Seoul)

응답

성공적인 메시지 히스토리 조회입니다

​
data
object
​
error
string | null