콘텐츠로 건너뛰기
사용자 가이드 지원 데모 요청 로그인
Pushwoosh.com

생성 및 업데이트

이 엔드포인트는 Journey 정의(제목, 설정, 캔버스 위의 포인트)를 생성하고 편집합니다. Journey를 시작하지는 않습니다. 이를 위해서는 라이프사이클을 사용하세요.

두 엔드포인트 모두 Journey 객체를 수락하고 반환합니다.

생성

Anchor link to

POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway

STATUS_DRAFT 상태로 새로운 Journey를 생성합니다.

요청

Anchor link to
필드필수유형설명
title예stringJourney 이름.
params예JourneyParamsJourney 전체 구성. params.application_code는 필수입니다.
points아니요Point 배열캔버스 위의 Journey 요소와 그 연결.
comments아니요JourneyComment 배열캔버스 주석.
요청 예시
Anchor link to
Journey 생성
curl -X POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "환영 시리즈",
    "params": { "application_code": "XXXXX-XXXXX" },
    "points": [],
    "comments": []
  }'

응답

Anchor link to

새로운 Journey 객체를 반환합니다. info.uuid에서 Journey의 UUID를 읽어 후속 업데이트 및 라이프사이클 호출에 사용하세요.

응답 예시
Anchor link to
{
  "info": {
    "uuid": "11111111-2222-3333-4444-555555555555",
    "title": "환영 시리즈",
    "status": "STATUS_DRAFT",
    "params": { "application_code": "XXXXX-XXXXX" }
  },
  "points": [],
  "comments": []
}

전체 Journey 예시

Anchor link to

작은 환영 플로우를 위한 완전한 Create 본문입니다. 그래프는 다음과 같습니다:

세그먼트로 시작 ──default──▶ 푸시 전송 ──default──▶ 1일 대기 ──default──▶ 불리언 분배기 ──output1──▶ 이메일 전송 ──default──▶ 종료
                                                                                                └──default───────────────────────────▶ 종료

포인트는 각 출력의 info.next_point_uuid를 통해 함께 연결됩니다. 출력 키에 유의하세요: 모든 포인트는 default를 사용하지만, 불리언 분배기는 일치 조건 분기를 위해 output1을 추가합니다(default는 폴백입니다). 종료 포인트에는 출력이 없습니다.

{
  "title": "환영 시리즈",
  "params": {
    "application_code": "XXXXX-XXXXX",
    "user_id_track_change_policy": "TRACK"
  },
  "points": [
    {
      "uuid": "11111111-1111-1111-1111-111111111111",
      "title": "신규 가입자",
      "point_type": "POINT_TYPE_START_BY_SEGMENT",
      "position": { "x": 80, "y": 200 },
      "outputs": [
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "", "next_point_uuid": "22222222-2222-2222-2222-222222222222" } }
      ],
      "point_data": {
        "start_by_segment": {
          "application_code": "XXXXX-XXXXX",
          "filter_code": "AAAAA-BBBBB"
        }
      }
    },
    {
      "uuid": "22222222-2222-2222-2222-222222222222",
      "title": "환영 푸시",
      "point_type": "POINT_TYPE_SEND_PUSH",
      "position": { "x": 340, "y": 200 },
      "outputs": [
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "", "next_point_uuid": "33333333-3333-3333-3333-333333333333" } }
      ],
      "point_data": {
        "send_push": {
          "application_code": "XXXXX-XXXXX",
          "title": "환영합니다!",
          "content": "가입해 주셔서 감사합니다 — 시작하는 방법은 다음과 같습니다."
        }
      }
    },
    {
      "uuid": "33333333-3333-3333-3333-333333333333",
      "title": "1일 대기",
      "point_type": "POINT_TYPE_WAIT",
      "position": { "x": 600, "y": 200 },
      "outputs": [
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "", "next_point_uuid": "44444444-4444-4444-4444-444444444444" } }
      ],
      "point_data": {
        "delay": { "sec": 86400 }
      }
    },
    {
      "uuid": "44444444-4444-4444-4444-444444444444",
      "title": "푸시를 열었나요?",
      "point_type": "POINT_TYPE_BOOLEAN_SPLITTER",
      "position": { "x": 860, "y": 200 },
      "outputs": [
        { "identity": { "key": "output1", "order": 1 },
          "info": { "title": "일치함", "next_point_uuid": "55555555-5555-5555-5555-555555555555" } },
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "그 외 모두", "next_point_uuid": "66666666-6666-6666-6666-666666666666" } }
      ],
      "point_data": {
        "boolean_splitter": {
          "split_strategy": "SPLIT_FILTER",
          "load_policy": "ALL",
          "filter_code": "CCCCC-DDDDD"
        }
      }
    },
    {
      "uuid": "55555555-5555-5555-5555-555555555555",
      "title": "후속 이메일",
      "point_type": "POINT_TYPE_SEND_EMAIL",
      "position": { "x": 1120, "y": 120 },
      "outputs": [
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "", "next_point_uuid": "66666666-6666-6666-6666-666666666666" } }
      ],
      "point_data": {
        "send_email": {
          "application_code": "XXXXX-XXXXX",
          "preset_code": "12345-67890"
        }
      }
    },
    {
      "uuid": "66666666-6666-6666-6666-666666666666",
      "title": "종료",
      "point_type": "POINT_TYPE_EXIT",
      "position": { "x": 1380, "y": 200 },
      "outputs": [],
      "point_data": {
        "terminator": {}
      }
    }
  ],
  "comments": []
}

업데이트

Anchor link to

PUT https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/{uuid}

기존 Journey의 정의를 교체합니다. 전체 정의를 보내야 합니다. 제출한 포인트와 주석이 현재의 것을 대체합니다.

경로 매개변수

Anchor link to
이름유형설명
uuidstring업데이트할 Journey ID.

요청

Anchor link to
필드유형설명
titlestring새 Journey 이름.
paramsJourneyParams새 Journey 전체 구성.
pointsPoint 배열새로운 전체 포인트 세트.
commentsJourneyComment 배열새로운 전체 주석 세트.
autosavebooltrue일 경우, 변경 사항이 편집기 자동 저장으로 처리됩니다. 기본값은 false입니다.
요청 예시
Anchor link to
Journey 이름 변경 및 재구성
curl -X PUT https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/11111111-2222-3333-4444-555555555555 \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "환영 시리즈 v2",
    "params": { "application_code": "XXXXX-XXXXX" },
    "points": [],
    "comments": []
  }'

응답

Anchor link to

업데이트된 Journey 객체를 반환합니다.

업데이트 및 재개

Anchor link to

POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/{uuid}/resume

단일 호출로 Journey에 편집 내용을 적용하고 재개합니다. 이는 업데이트 후 라이프사이클 시작을 호출하는 것과 같습니다. 요청 본문은 업데이트와 일치합니다. 일시 중지된 Journey를 다시 STATUS_RUNNING 상태로 되돌리고 싶을 때 사용하세요.

이름 변경

Anchor link to

POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/{uuid}/rename

포인트나 설정을 건드리지 않고 Journey 제목만 변경합니다.

필드필수유형설명
title예string새 Journey 이름.
요청 예시
Anchor link to
Journey 이름 변경
curl -X POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/11111111-2222-3333-4444-555555555555/rename \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "title": "환영 시리즈 (3분기)" }'

관련 항목

Anchor link to
Journey 객체
라이프사이클
API로 시작