ইনবাউন্ড ওয়েবহুক ইন্টিগ্রেশন

ডেভেলপারের সহায়তা প্রয়োজন

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

ইনবাউন্ড ওয়েবহুকগুলি বাহ্যিক পরিষেবাগুলিকে সরাসরি Pushwoosh-এ ইভেন্ট পাঠাতে দেয়। যখন একটি তৃতীয় পক্ষের সিস্টেম একটি ওয়েবহুক ট্রিগার করে, Pushwoosh অনুরোধটি প্রমাণীকরণ করে, সাবস্ক্রাইবারকে শনাক্ত করে এবং ম্যাপ করা ইভেন্টটি ফায়ার করে। এরপর ইভেন্টটি একটি জার্নি শুরু করতে বা এগিয়ে নিয়ে যেতে পারে।

আপনার নিজের সার্ভার তৈরি বা রক্ষণাবেক্ষণ না করেই CRM, ই-কমার্স প্ল্যাটফর্ম বা বিশ্লেষণ পরিষেবার মতো টুলগুলিকে সংযুক্ত করতে ইনবাউন্ড ওয়েবহুক ব্যবহার করুন। প্রতিটি ইনবাউন্ড ওয়েবহুক একটি Pushwoosh ইভেন্ট ট্রিগার করে যখন একটি ম্যাচিং অনুরোধ সফলভাবে গৃহীত এবং প্রক্রিয়াজাত হয়।

শুরু করার আগে

ওয়েবহুক সেটআপ খোলার আগে নিম্নলিখিতগুলি প্রস্তুত করুন।

1. সিদ্ধান্ত নিন কোন Pushwoosh ইভেন্টটি ওয়েবহুক ফায়ার করবে। আপনার প্রজেক্ট থেকে একটি বিদ্যমান ইভেন্ট বেছে নিন যা আপনি তৃতীয় পক্ষের পরিষেবা থেকে ট্রিগার করতে চান। উদাহরণস্বরূপ, CheckoutSuccess। যদি আপনার কাছে এখনও উপযুক্ত ইভেন্ট না থাকে, তাহলে ইনকামিং ডেটা থেকে পূরণ করতে চান এমন অ্যাট্রিবিউটসহ একটি তৈরি করুন।

2. নিশ্চিত করুন যে আপনার তৃতীয় পক্ষের পরিষেবা ওয়েবহুক পাঠাতে পারে। পরিষেবাটিকে একটি বাহ্যিক URL-এ একটি HTTP POST অনুরোধ পাঠাতে সক্ষম হতে হবে যখন আপনার কাঙ্ক্ষিত ইভেন্টটি ঘটে, উদাহরণস্বরূপ একটি নতুন অর্ডার বা একটি ফর্ম জমা দেওয়া।

3. আপনার তৃতীয় পক্ষের পরিষেবা থেকে একটি নমুনা JSON পেলোড পান। এটি প্রতিটি ইভেন্টে পরিষেবাটি যে ডেটা পাঠায় তার একটি ছোট উদাহরণ। পেলোড ফিল্ডগুলিকে Pushwoosh ইভেন্ট অ্যাট্রিবিউটে ম্যাপ করার জন্য আপনার এটি প্রয়োজন হবে।

একটি ওয়েবহুক তৈরি করুন

1. আপনার Pushwoosh অ্যাকাউন্টে, সেটিংস → ইন্টিগ্রেশন → ইনবাউন্ড ওয়েবহুক-এ যান এবং সেটিংস-এ ক্লিক করুন।

2. সেটআপ ফ্লো খুলতে ওয়েবহুক তৈরি করুন-এ ক্লিক করুন।

3. একটি ওয়েবহুক নাম লিখুন যাতে আপনি পরে তালিকায় ওয়েবহুকটি শনাক্ত করতে পারেন।

4. সেই Pushwoosh ইভেন্টটি নির্বাচন করুন যা ওয়েবহুক একটি বৈধ অনুরোধ পেলে ফায়ার করবে। আপনি আপনার প্রজেক্টে ইতিমধ্যে বিদ্যমান ইভেন্টগুলি থেকে বেছে নিতে পারেন। যদি আপনাকে প্রথমে একটি ইভেন্ট তৈরি করতে হয়, তাহলে ইভেন্টস দেখুন।

নোট

একটি ওয়েবহুক শুধুমাত্র একটি ইভেন্ট ট্রিগার করে।

5. ইনকামিং ডেটা ম্যাচ করুন-এ, আপনার তৃতীয় পক্ষের পরিষেবা থেকে একটি নমুনা JSON পেলোড পেস্ট করুন। Pushwoosh স্বয়ংক্রিয়ভাবে ড্রপডাউনে পেলোড ফিল্ডগুলি লোড করে।

নোট

আপনি যদি পরে পেলোড আপডেট করেন, ড্রপডাউন রিফ্রেশ করতে নির্বাচন বিকল্পগুলি পুনরায় লোড করুন-এ ক্লিক করুন। এটি আপনার বর্তমান ফিল্ড ম্যাপিং রিসেট করে। আপনাকে আপনার অ্যাট্রিবিউটগুলি পুনরায় ম্যাপ করতে হবে।

নমুনা পেলোড:

{
  "user_id": "12345",
  "email_address": "jane@example.com",
  "mobile": "+15551234567",
  "purchase_date": "2024-03-15",
  "order_number": "ORD-001",
  "price": 99.99,
  "payment_state": "success"
}

6. ব্যবহারকারীদের শনাক্ত করুন-এ, নির্বাচন করুন কিভাবে Pushwoosh ইনকামিং অনুরোধটি একজন ব্যবহারকারীর সাথে মেলাবে:

• ইউজার আইডি: Pushwoosh-এর অভ্যন্তরীণ ইউজার আইডি দ্বারা ম্যাচ করে।
• ইমেল: ইমেল ঠিকানা দ্বারা ম্যাচ করে।
• ফোন: ফোন নম্বর দ্বারা ম্যাচ করে।
• HWID: ডিভাইস, ব্রাউজার বা ইমেল আইডেন্টিফায়ার দ্বারা ম্যাচ করে।

পেলোড ফিল্ড-এ, ম্যাচিং মান ধারণকারী ফিল্ডটি নির্বাচন করুন।

7. প্রতিটি ইভেন্ট অ্যাট্রিবিউটকে একটি পেলোড ফিল্ডে ম্যাপ করুন। প্রতিটি ম্যাপিং সারিতে:

• ইভেন্ট অ্যাট্রিবিউট: Pushwoosh-এ অ্যাট্রিবিউটের নাম। এই ইভেন্টের জন্য সংজ্ঞায়িত অ্যাট্রিবিউটগুলি থেকে নির্বাচন করুন।
• পেলোড ফিল্ড: ইনকামিং পেলোড থেকে ফিল্ড যা মান ধারণ করে।

উদাহরণস্বরূপ, email-কে email_address-এ, total-কে price-এ, এবং order_id-কে order_number-এ ম্যাপ করুন।

একটি সারি যোগ করতে + অ্যাট্রিবিউট যোগ করুন-এ ক্লিক করুন। একটি সরাতে ×-এ ক্লিক করুন।

8. কনফিগারেশন সম্পূর্ণ হলে, সক্ষম করুন-এ ক্লিক করুন। ওয়েবহুক URL উইন্ডোটি খুলবে।

ডেভেলপারের সহায়তা প্রয়োজন

পরবর্তী পদক্ষেপগুলির জন্য আপনার তৃতীয় পক্ষের পরিষেবার ওয়েবহুক সেটিংসে অ্যাক্সেসের প্রয়োজন। URL এবং সিক্রেট আপনার ডেভেলপমেন্ট টিমের সাথে শেয়ার করুন।

মানগুলি কপি করুন এবং আপনার বাহ্যিক সিস্টেমের ওয়েবহুক সেটিংসে পেস্ট করুন:

• URL কপি করুন এবং এটিকে আপনার তৃতীয় পক্ষের পরিষেবাতে ওয়েবহুক গন্তব্য হিসাবে সেট করুন।
• সিক্রেট কপি করুন এবং এটিকে আপনার বাহ্যিক পরিষেবাতে Authorization হেডার মান হিসাবে পেস্ট করুন। মানটিতে Bearer উপসর্গ অন্তর্ভুক্ত রয়েছে, তাই এটি যেমন আছে তেমনই ব্যবহার করুন। Pushwoosh এমন যেকোনো অনুরোধ প্রত্যাখ্যান করে যেখানে এই হেডারটি অনুপস্থিত বা মেলে না।

9. উইন্ডোটি একটি নমুনা POST অনুরোধ সহ একটি উদাহরণ অনুরোধও দেখায়। সম্পূর্ণ অনুরোধটি কপি করতে উদাহরণ ব্লকে কপি-তে ক্লিক করুন। একটি পরীক্ষার অনুরোধ পাঠাতে এবং Pushwoosh ওয়েবহুক গ্রহণ করে কিনা তা নিশ্চিত করতে এটি ব্যবহার করুন, অথবা ইন্টিগ্রেশনের জন্য একটি টেমপ্লেট হিসাবে আপনার দলের সাথে শেয়ার করুন।

আপনি ওয়েবহুক সক্ষম করার পরে, এটি ওয়েবহুক তালিকায় একটি সক্ষম স্থিতি সহ উপস্থিত হয় এবং অনুরোধ গ্রহণ করা শুরু করে।

ওয়েবহুক তালিকা

ইনবাউন্ড ওয়েবহুক তালিকা আপনার প্রজেক্টের প্রতিটি ওয়েবহুক দেখায়।

প্রতিটি সারি দেখায়:

• নাম: ওয়েবহুকের নাম।
• ইভেন্ট: Pushwoosh ইভেন্ট যা ওয়েবহুক একটি বৈধ অনুরোধ পেলে ফায়ার করে।
• স্থিতি: সক্ষম বা অক্ষম।
• প্রাপ্ত: ওয়েবহুক দ্বারা প্রাপ্ত অনুরোধের সংখ্যা।
• শেষ আপডেট: ওয়েবহুকটি শেষবার কখন পরিবর্তন করা হয়েছিল।

ওয়েবহুক পরিচালনা করুন

সারি মেনু খুলুন:

• সেটিংস সম্পাদনা করুন: ওয়েবহুক কনফিগারেশন খোলে যাতে আপনি নাম, ইভেন্ট, ফিল্ড ম্যাপিং এবং ব্যবহারকারী শনাক্তকরণ পরিবর্তন করতে পারেন।
• URL কপি করুন: ওয়েবহুক URL উইন্ডোটি URL এবং সিক্রেট সহ খোলে যাতে আপনি সেগুলি আবার কপি করতে পারেন।
• অ্যাক্টিভিটি লগ: এই ওয়েবহুকের জন্য অনুরোধ লগ খোলে।
• মুছুন: তালিকা থেকে ওয়েবহুকটি সরিয়ে দেয়।

একটি সক্ষম ওয়েবহুকের জন্য, কনফিগারেশন না মুছে এটিকে নিষ্ক্রিয় করতে অক্ষম করুন-এ ক্লিক করুন। একটি অক্ষম ওয়েবহুকের জন্য, আবার অনুরোধ গ্রহণ শুরু করতে সক্ষম করুন-এ ক্লিক করুন।

অ্যাক্টিভিটি লগ দেখুন

অ্যাক্টিভিটি লগ নির্বাচিত ওয়েবহুকের জন্য সমস্ত ইনকামিং অনুরোধ দেখায়।

সারাংশ প্যানেল

উপরে, গত ২৪ ঘন্টার সারাংশ পর্যালোচনা করুন:

• হিট: প্রাপ্ত ইনকামিং অনুরোধের মোট সংখ্যা।
• সফল: অনুরোধ যেখানে প্রমাণীকরণ পাস হয়েছে, ব্যবহারকারীকে পাওয়া গেছে এবং ইভেন্টটি ফায়ার হয়েছে।
• ব্যর্থ: যে অনুরোধগুলি প্রক্রিয়া করা হয়নি। একটি ব্যর্থ অনুরোধ ওয়েবহুক বন্ধ করে না। Pushwoosh পরবর্তী অনুরোধগুলি গ্রহণ এবং প্রক্রিয়া করা চালিয়ে যায়।

ব্যর্থতার কারণ	এর মানে কি
প্রমাণীকরণ প্রত্যাখ্যান	শেয়ার করা সিক্রেট ওয়েবহুক কনফিগারেশনের সাথে মেলে না। যদি পরপর পাঁচটি অনুরোধ এই ত্রুটির সাথে ব্যর্থ হয়, Pushwoosh আপনাকে একটি বিজ্ঞপ্তি পাঠায়। পুনরায় শুরু করতে সিক্রেট আপডেট করুন। পুনরায় সক্রিয় করার প্রয়োজন নেই।
ব্যবহারকারী শনাক্তকারী ফিল্ড অনুপস্থিত	ব্যবহারকারী শনাক্তকরণের জন্য ম্যাপ করা পেলোড ফিল্ড অনুরোধে উপস্থিত নেই।

অনুরোধ এন্ট্রি

প্রতিটি এন্ট্রি ব্যবহারকারী শনাক্তকারী (উদাহরণস্বরূপ, ইউজার আইডি বা ইমেল), একটি সফল বা ব্যর্থ ব্যাজ, অনুরোধের টাইমস্ট্যাম্প এবং প্রাপ্ত JSON পেলোডের একটি প্রিভিউ দেখায়। সম্পূর্ণ অনুরোধের বিবরণ প্রসারিত করতে দেখুন-এ ক্লিক করুন।

ইউজার এক্সপ্লোরারে ওয়েবহুক-ফায়ার্ড ইভেন্টগুলি দেখুন

যখন একটি ওয়েবহুক অনুরোধ সফলভাবে প্রক্রিয়া করা হয়, Pushwoosh ইউজার এক্সপ্লোরার-এ ইভেন্টটি রেকর্ড করে। এটি কোথায় প্রদর্শিত হবে তা নির্ভর করে আপনি কীভাবে ব্যবহারকারীকে শনাক্ত করেছেন তার উপর:

• ইউজার আইডি, ইমেল, বা ফোন: ইভেন্টটি ব্যবহারকারীর প্রোফাইলে রেকর্ড করা হয়। ব্যবহারকারী খুলুন এবং ইভেন্টস হিস্ট্রি-তে যান।
• HWID: ইভেন্টটি ম্যাচিং ডিভাইসে রেকর্ড করা হয়। ব্যবহারকারী খুলুন, সক্রিয় ব্যবহারকারী ডিভাইস-এ ডিভাইসটি খুঁজুন এবং এর ইভেন্টস হিস্ট্রি ট্যাবে যান।

নাম দ্বারা ইভেন্টটি খুঁজুন এবং ম্যাপ করা অ্যাট্রিবিউটগুলি (উদাহরণস্বরূপ, price বা products) এবং ওয়েবহুক আইডি সহ __webhook অ্যাট্রিবিউট দেখতে এটি প্রসারিত করুন।

জার্নির সাথে ইনবাউন্ড ওয়েবহুক ব্যবহার করুন

একটি ওয়েবহুক সক্ষম হওয়ার এবং সফলভাবে ইভেন্ট ফায়ার করার পরে, নির্বাচিত ইভেন্টটিকে একটি ট্রিগার-ভিত্তিক জার্নি এন্ট্রি হিসাবে ব্যবহার করুন। যখন ওয়েবহুক একটি বৈধ অনুরোধ পায়, Pushwoosh ম্যাপ করা ইভেন্টটি ফায়ার করে। যে কোনো জার্নি যা এই ইভেন্টটিকে একটি এন্ট্রি ট্রিগার হিসাবে ব্যবহার করে তা ম্যাচ করা ব্যবহারকারীর জন্য স্বয়ংক্রিয়ভাবে শুরু হয়।