তৈরি এবং আপডেট করুন

এই এন্ডপয়েন্টগুলি জার্নির সংজ্ঞা তৈরি এবং সম্পাদনা করে: এর শিরোনাম, সেটিংস এবং ক্যানভাসের পয়েন্টগুলি। তারা জার্নি শুরু করে না। এর জন্য লাইফসাইকেল ব্যবহার করুন।

উভয়ই জার্নি অবজেক্ট গ্রহণ করে এবং রিটার্ন করে।

টিপ

JSON-এ একটি সম্পূর্ণ জার্নি গ্রাফ লেখা কঠিন। প্রতিটি পয়েন্টের নিজস্ব চ্যানেল ফিল্ড এবং শর্তাবলী রয়েছে (পয়েন্ট রেফারেন্স)। সবচেয়ে নির্ভরযোগ্য ওয়ার্কফ্লো হলো Customer Journey builder-এ একবার জার্নি তৈরি করা, একটি তৈরি/আপডেট প্রতিক্রিয়া থেকে এটি পড়া, তারপর প্রোগ্রাম্যাটিকভাবে এটি ক্লোন বা সামঞ্জস্য করতে এই এন্ডপয়েন্টগুলি ব্যবহার করা।

তৈরি করুন

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

STATUS_DRAFT অবস্থায় একটি নতুন জার্নি তৈরি করে।

অনুরোধ

ফিল্ড	প্রয়োজনীয়	টাইপ	বিবরণ
title	হ্যাঁ	string	জার্নির নাম।
params	হ্যাঁ	JourneyParams	জার্নি-ব্যাপী কনফিগারেশন। params.application_code প্রয়োজন।
points	না	array of Point	ক্যানভাসে জার্নির উপাদান এবং তাদের সংযোগ।
comments	না	array of JourneyComment	ক্যানভাসের মন্তব্য।

অনুরোধের উদাহরণ

একটি জার্নি তৈরি করুন

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": "Welcome series",
    "params": { "application_code": "XXXXX-XXXXX" },
    "points": [],
    "comments": []
  }'

প্রতিক্রিয়া

নতুন জার্নি অবজেক্ট রিটার্ন করে। info.uuid থেকে জার্নির UUID পড়ুন এবং পরবর্তী আপডেট এবং লাইফসাইকেল কলের জন্য এটি ব্যবহার করুন।

প্রতিক্রিয়ার উদাহরণ

{
  "info": {
    "uuid": "11111111-2222-3333-4444-555555555555",
    "title": "Welcome series",
    "status": "STATUS_DRAFT",
    "params": { "application_code": "XXXXX-XXXXX" }
  },
  "points": [],
  "comments": []
}

সম্পূর্ণ জার্নির উদাহরণ

একটি ছোট ওয়েলকাম ফ্লো-এর জন্য একটি সম্পূর্ণ Create বডি। গ্রাফটি হলো:

Start by segment ──default──▶ Send push ──default──▶ Wait 1 day ──default──▶ Boolean splitter ──output1──▶ Send email ──default──▶ Exit
                                                                                              └──default───────────────────────────▶ Exit

পয়েন্টগুলি প্রতিটি আউটপুটের info.next_point_uuid-এর মাধ্যমে একসাথে সংযুক্ত থাকে। আউটপুট কী নোট করুন: প্রতিটি পয়েন্ট default ব্যবহার করে, বুলিয়ান স্প্লিটার ছাড়া, যা ম্যাচ-করা শর্তের শাখার জন্য output1 যোগ করে (default হলো এর ফলব্যাক)। এক্সিট পয়েন্টের কোনো আউটপুট নেই।

{
  "title": "Welcome series",
  "params": {
    "application_code": "XXXXX-XXXXX",
    "user_id_track_change_policy": "TRACK"
  },
  "points": [
    {
      "uuid": "11111111-1111-1111-1111-111111111111",
      "title": "New signups",
      "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": "Welcome push",
      "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": "Welcome!",
          "content": "Thanks for joining — here's how to get started."
        }
      }
    },
    {
      "uuid": "33333333-3333-3333-3333-333333333333",
      "title": "Wait 1 day",
      "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": "Opened the push?",
      "point_type": "POINT_TYPE_BOOLEAN_SPLITTER",
      "position": { "x": 860, "y": 200 },
      "outputs": [
        { "identity": { "key": "output1", "order": 1 },
          "info": { "title": "Matched", "next_point_uuid": "55555555-5555-5555-5555-555555555555" } },
        { "identity": { "key": "default", "order": 0 },
          "info": { "title": "Everyone else", "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": "Follow-up email",
      "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": "Exit",
      "point_type": "POINT_TYPE_EXIT",
      "position": { "x": 1380, "y": 200 },
      "outputs": [],
      "point_data": {
        "terminator": {}
      }
    }
  ],
  "comments": []
}

আপডেট করুন

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

বিদ্যমান জার্নির সংজ্ঞা প্রতিস্থাপন করে। সম্পূর্ণ সংজ্ঞা পাঠান। আপনার জমা দেওয়া পয়েন্ট এবং মন্তব্যগুলি বর্তমানগুলিকে প্রতিস্থাপন করবে।

পাথ প্যারামিটার

নাম	টাইপ	বিবরণ
uuid	string	আপডেট করার জন্য জার্নি আইডি।

অনুরোধ

ফিল্ড	টাইপ	বিবরণ
title	string	নতুন জার্নির নাম।
params	JourneyParams	নতুন জার্নি-ব্যাপী কনফিগারেশন।
points	array of Point	পয়েন্টের নতুন সম্পূর্ণ সেট।
comments	array of JourneyComment	মন্তব্যের নতুন সম্পূর্ণ সেট।
autosave	bool	যখন true হয়, পরিবর্তনটি একটি এডিটর অটোসেভ হিসাবে বিবেচিত হয়। ডিফল্ট false।

অনুরোধের উদাহরণ

একটি জার্নির পুনঃনামকরণ এবং পুনঃকনফিগার করুন

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": "Welcome series v2",
    "params": { "application_code": "XXXXX-XXXXX" },
    "points": [],
    "comments": []
  }'

প্রতিক্রিয়া

আপডেট করা জার্নি অবজেক্ট রিটার্ন করে।

আপডেট এবং পুনরায় শুরু করুন

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

একটি জার্নিতে সম্পাদনা প্রয়োগ করে এবং একটি একক কলে এটি পুনরায় শুরু করে। এটি একটি আপডেট এবং তারপরে একটি লাইফসাইকেল স্টার্ট-এর সমতুল্য। অনুরোধের বডি আপডেট-এর সাথে মেলে। আপনি যখন একটি পজ করা জার্নি সম্পাদনা করছেন এবং এটিকে STATUS_RUNNING অবস্থায় ফিরিয়ে আনতে চান তখন এটি ব্যবহার করুন।

পুনঃনামকরণ করুন

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

শুধুমাত্র জার্নির শিরোনাম পরিবর্তন করে, এর পয়েন্ট বা সেটিংস স্পর্শ না করে।

ফিল্ড	প্রয়োজনীয়	টাইপ	বিবরণ
title	হ্যাঁ	string	নতুন জার্নির নাম।

অনুরোধের উদাহরণ

একটি জার্নির পুনঃনামকরণ করুন

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": "Welcome series (Q3)" }'

সম্পর্কিত

জার্নি অবজেক্ট

লাইফসাইকেল

API দ্বারা শুরু করুন