আপনার জার্নিতে ওয়েবhooks রেসপন্স ডেটা ব্যবহার করা

সংক্ষিপ্ত বিবরণ

যখন আপনি একটি ওয়েবhooks রেসপন্স থেকে মান ম্যাপ করেন, Pushwoosh সেগুলোকে ভেরিয়েবল হিসেবে সংরক্ষণ করে যা আপনি জার্নির পরবর্তী পর্যায়ে ব্যবহার করতে পারেন, যেখানে আপনি অন্যথায় একটি Event attribute ব্যবহার করতেন।

নোট

একটি Webhook এলিমেন্ট যোগ করতে এবং Response mapping কনফিগার করতে, দেখুন Webhook।

Update user profile ব্যবহার করে একটি ওয়েবhooks মান Tag হিসেবে সংরক্ষণ করুন

একটি Webhook একটি বাহ্যিক সিস্টেম থেকে ডেটা ফেরত দিতে পারে, যেমন একটি CRM ইউজার আইডি বা সাবস্ক্রিপশন স্ট্যাটাস, যা Pushwoosh এখনও ইউজার প্রোফাইলে সংরক্ষণ করে না। Update user profile ম্যাপ করা মানগুলিকে Tags হিসেবে সংরক্ষণ করে যাতে আপনি সেগুলিকে segments, dynamic content, এবং পরবর্তী জার্নি ধাপে ব্যবহার করতে পারেন।

উদাহরণ: একটি CRM ইউজার আইডি Tag হিসেবে সংরক্ষণ করুন

একজন নতুন ব্যবহারকারী আপনার অ্যাপে সাইন আপ করে, এবং জার্নি আপনার CRM-এ একটি ম্যাচিং রেকর্ড তৈরি করে। ফেরত আসা CRM ইউজার আইডি একটি Tag হিসেবে সংরক্ষণ করলে আপনি পরে একই CRM রেকর্ড রেফারেন্স বা আপডেট করতে পারবেন, উদাহরণস্বরূপ অন্য একটি জার্নি বা একটি ফলো-আপ Webhook কল থেকে, ব্যবহারকারী প্রতিবার জার্নিতে পুনরায় প্রবেশ করার সময় একটি ডুপ্লিকেট রেকর্ড তৈরি করার পরিবর্তে।

জার্নি ফ্লো: Trigger-based Entry → Webhook → Update user profile → ব্রাঞ্চ শেষ করুন

1. SignUp ইভেন্টে Trigger-based Entry সহ একটি জার্নি তৈরি করুন।
2. এন্ট্রি স্টেপের পরে একটি Webhook এলিমেন্ট যোগ করুন। এর একটি নাম দিন (উদাহরণস্বরূপ, Create user in CRM) এবং রিকোয়েস্ট URL আপনার CRM create-user এন্ডপয়েন্টে সেট করুন।
3. Response mapping-এ, Path রেসপন্সের আইডি ফিল্ডে সেট করুন (উদাহরণস্বরূপ, data.user.id) এবং Attribute crm_user_id-এ সেট করুন।

4. Webhook স্টেপের পরে একটি Update user profile এলিমেন্ট যোগ করুন।

5. Dynamic Tag Value-তে, + Dynamic Value-তে ক্লিক করুন। Tag-এ, যে Tag CRM আইডি সংরক্ষণ করে সেটি নির্বাচন করুন (প্রয়োজনে আগে থেকে তৈরি করুন)। Event-এ, আপনার দেওয়া নাম (Create user in CRM) দ্বারা ওয়েবhooks স্টেপ নির্বাচন করুন। Dynamic Value-তে, crm_user_id নির্বাচন করুন।

6. ব্রাঞ্চ শেষ করুন — একটি Exit এলিমেন্ট যোগ করুন অথবা এটিকে একটি আউটগোয়িং সংযোগ ছাড়াই ছেড়ে দিন।

সতর্কতা

যদি কোনো ব্যবহারকারীর জন্য ওয়েবhooks মান অনুপস্থিত থাকে (রেসপন্সটি JSON ছিল না, Path সমাধান করা যায়নি, বা কল ব্যর্থ হয়েছে), Pushwoosh সেই Tag আপডেটটি এড়িয়ে যায়। Tag তার আগের মান ধরে রাখে বা আনসেট থাকে, এবং জার্নি এই ধাপে কোনো ত্রুটি ছাড়াই চলতে থাকে। আপনার ম্যাপিং নিশ্চিত করতে লঞ্চের আগে Test webhook চালান। আরও জানুন।

Time Delay ব্যবহার করে একটি ওয়েবhooks মান থেকে একটি বিলম্ব নির্ধারণ করুন

ভিজিটের তারিখ, রিনিউয়ালের শেষ তারিখ, এবং ডেলিভারির সময়সীমা প্রায়শই একটি বাহ্যিক বুকিং বা বিলিং সিস্টেমে থাকে। একটি Webhook API রেসপন্স থেকে তারিখ ম্যাপ করার পরে, Time Delay সেই মুহূর্ত পর্যন্ত জার্নিকে বিরতি দিতে পারে, উদাহরণস্বরূপ একটি অ্যাপয়েন্টমেন্টের ২ দিন আগে, যাতে পরবর্তী বার্তাটি সময়মতো পাঠানো হয়।

উদাহরণ: রেসপন্সের একটি তারিখ থেকে একটি রিমাইন্ডার নির্ধারণ করুন

একজন ব্যবহারকারী আপনার অ্যাপে একটি অ্যাপয়েন্টমেন্ট বুক করে। জার্নি আপনার বুকিং সিস্টেম থেকে ভিজিটের তারিখ নিয়ে আসে এবং ভিজিটের ২ দিন আগে একটি পুশ রিমাইন্ডার পাঠায়।

1. AppointmentBooked ইভেন্টে Trigger-based Entry সহ একটি জার্নি তৈরি করুন।
2. এন্ট্রি স্টেপের পরে একটি Webhook এলিমেন্ট যোগ করুন। এর একটি নাম দিন (উদাহরণস্বরূপ, Get appointment details) এবং রিকোয়েস্ট URL আপনার বুকিং সিস্টেম API-তে সেট করুন।
3. Response mapping-এ, Path রেসপন্সের তারিখ ফিল্ডে সেট করুন (উদাহরণস্বরূপ, appointment.date) এবং Attribute visit_date-এ সেট করুন।

4. Webhook স্টেপের পরে একটি Time Delay এলিমেন্ট যোগ করুন। Based on user/event data নির্বাচন করুন, Get date from Event-এ সেট করুন, Event আপনার দেওয়া নাম (Get appointment details) দ্বারা ওয়েবhooks স্টেপে সেট করুন, Event value visit_date-এ সেট করুন, এবং বিলম্ব Before 2 Days-এ সেট করুন।

5. যদি ব্যবহারকারীরা ভিজিটের ২ দিনের কম আগে বুক করতে পারে, তাহলে Time Delay এলিমেন্টে Split to branches if the date’s in the past or date is empty সক্ষম করুন। এটি দুটি ব্রাঞ্চ তৈরি করে, In the past এবং In the future। দেখুন তারিখ অতীতে বা খালি থাকলে ব্রাঞ্চ বিভক্ত করুন।
6. আপনার রিমাইন্ডার বার্তা সহ একটি Push স্টেপ যোগ করুন। যদি বিভাজন সক্ষম করা থাকে, তাহলে উভয় ব্রাঞ্চে এই Push যোগ করুন: In the past (অবিলম্বে পাঠান) এবং In the future (Time Delay-এর পরে)।
7. প্রতিটি ব্রাঞ্চ শেষ করুন — একটি Exit এলিমেন্ট যোগ করুন অথবা এটিকে একটি আউটগোয়িং সংযোগ ছাড়াই ছেড়ে দিন।

সতর্কতা

যদি ম্যাপ করা মানটি অনুপস্থিত বা একটি বৈধ তারিখ না হয়, তাহলে ব্যবহারকারী এই ধাপে একটি ত্রুটি সহ জার্নি থেকে বেরিয়ে যায়।

যদি ভিজিটটি ২ দিনের কম সময়ের মধ্যে হয়, তাহলে Before 2 Days টার্গেটটি ব্যবহারকারী Time Delay-তে পৌঁছানোর সময় ইতিমধ্যেই অতীতে থাকে, এবং ব্যবহারকারী কোনো ত্রুটি এবং কোনো রিমাইন্ডার ছাড়াই জার্নি ছেড়ে দেয় যদি না আপনি Split to branches if the date’s in the past or date is empty সক্ষম করেন।

Update user profile-এর বিপরীতে, যা Tag অপরিবর্তিত রেখে চলতে থাকে, Time Delay ব্যবহারকারীকে থামিয়ে দেয় যখন তারিখটি অনুপস্থিত, অবৈধ, বা অতীতে থাকে (ব্রাঞ্চ বিভাজন ছাড়া)। নিশ্চিত করুন যে আপনার ওয়েবhooks একটি সমর্থিত ফরম্যাটে নির্ভরযোগ্যভাবে একটি তারিখ ফেরত দেয়। লঞ্চের আগে Test webhook চালান। আরও জানুন।

মনে রাখার বিষয়

• Path সিনট্যাক্স: একটি ডট-সেপারেটেড পাথ ব্যবহার করুন (উদাহরণস্বরূপ, data.user.id)। ওয়াইল্ডকার্ড এবং ফিল্টার সমর্থিত নয়। বিস্তারিত জানতে Webhook response mapping দেখুন।
• রেসপন্সের আকার: ৬৪ KB-এর চেয়ে বড় রেসপন্স ম্যাপিংয়ের জন্য প্রক্রিয়া করা হয় না।
• টেস্টিং: একটি লাইভ জার্নিতে ম্যাপ করা মান ব্যবহার করার আগে Webhook এলিমেন্টে Test webhook চালান।