বিজ্ঞপ্তি টেমপ্লেট ব্যবহার করে বিজ্ঞপ্তি সেট-আপ করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

বিজ্ঞপ্তি টেমপ্লেট কী?

মনিটাইজেশন, বিভিন্ন ধরনের ইভেন্ট বিজ্ঞপ্তির জন্য স্যাম্পেল টেক্সট নির্ধারণ করে এমন টেমপ্লেটের একটি সেট প্রদান করে। আপনি এইসব টেমপ্লেটের যেকোনও একটি কাস্টমাইজ করে এগুলি করতে পারবেন:

• নতুন প্রোডাক্ট, শর্তাবলী ও নিয়মের নতুন ভার্সন বা নতুন রেট প্ল্যানের মতো ইভেন্ট সম্পর্কে সব ডেভেলপারকে বিজ্ঞপ্তি পাঠান।
• সংশোধিত রেট প্ল্যানের মতো ইভেন্ট সম্পর্কে প্রভাবিত ডেভেলপারদের বিজ্ঞপ্তি পাঠানো।
• কোনও API প্রদানকারীকে ডেভেলপার-সম্পর্কিত ইভেন্ট সম্পর্কে বিজ্ঞপ্তি পাঠানো, যেমন, কোনও ডেভেলপার অ্যাকাউন্টের জন্য রেজিস্টার করলে বা কোনও ডেভেলপার রেট প্ল্যানে সাইন-আপ করলে।
• নির্দিষ্ট ইভেন্ট সম্পর্কে কোম্পানির সব অ্যাডমিনিস্ট্রেটরকে বিজ্ঞপ্তি পাঠান।

অথবা, আপনি একটি ওয়েবহুক তৈরি করতে পারেন যা HTTP কলব্যাক হ্যান্ডলারকে সংজ্ঞায়িত করে, তারপরে ওয়েবহুক ব্যবহার করে বিজ্ঞপ্তি সেট-আপ করুন নিবন্ধে বর্ণিত শর্ত কনফিগার করুন যা ওয়েবহুককে ট্রিগার করে।

বিজ্ঞপ্তি পৃষ্ঠা এক্সপ্লোর করা

নিচে যেভাবে বর্ণনা করা হয়েছে সেইভাবে বিজ্ঞপ্তি পৃষ্ঠা অ্যাক্সেস করুন।

বিজ্ঞপ্তি এডিট করা

UI ব্যবহার করে বিজ্ঞপ্তি এডিট করতে:

1. বিজ্ঞপ্তি পৃষ্ঠা অ্যাক্সেস করুন।
2. আপনি যে বিজ্ঞপ্তি এডিট করতে চান, তার বিবরণ বড় করে দেখতে, সেটির পাশে থাকা আইকনে ক্লিক করুন।
3. প্রয়োজন অনুযায়ী বিষয়, মূল অংশ ও প্রাপক (উপলভ্য থাকলে) ফিল্ড এডিট করুন।

   বিজ্ঞপ্তি টেমপ্লেটের মধ্যে নির্দিষ্ট করা যেতে পারে এমন ভেরিয়েবল সম্পর্কে তথ্য পেতে, বিজ্ঞপ্তি টেমপ্লেটে ভেরিয়েবল ব্যবহার করা দেখুন।

   প্রতিটি বিভাগে বিজ্ঞপ্তি এডিট করা সম্পর্কে আরও তথ্য পেতে, নিম্নলিখিত বিভাগগুলি দেখুন:

   • সব ডেভেলপারকে জানানোর জন্য বিজ্ঞপ্তি এডিট করা
   • প্রভাবিত ডেভেলপারদের জানানোর জন্য বিজ্ঞপ্তি এডিট করা
   • Notify API প্রদানকারীকে বিজ্ঞপ্তি এডিট করা
4. কোনও বিজ্ঞপ্তির পাশে থাকা চেকবক্সে টিকচিহ্ন দিয়ে সেটি চালু করুন।
5. অতিরিক্ত বিজ্ঞপ্তি এডিট করতে ২ থেকে ৪ নম্বর ধাপ আবার অনুসরণ করুন।
6. সব পরিবর্তন সেভ করতে সেভ করুন বিকল্পে ক্লিক করুন।

বিজ্ঞপ্তি সেভ করা হয়েছে তা কনফার্ম করতে একটি মেসেজ দেখানো হয়। সেভ করার প্রসেস সম্পূর্ণ হতে কয়েক মিনিট সময় লাগতে পারে।

সব ডেভেলপারকে বিজ্ঞপ্তি পাঠানোর জন্য বিজ্ঞপ্তি এডিট করা

সব ডেভেলপারকে বিজ্ঞপ্তি পাঠান বিভাগে আপনি যেসব ইভেন্টের ধরন বেছে নেবেন সেইসব ইভেন্টের বিজ্ঞপ্তি সব ডেভেলপারকে পাঠানো হবে।

দিনের শেষে বিজ্ঞপ্তি চালানোর জন্য শিডিউল করা হয়। বিজ্ঞপ্তি পাঠানোর পরে ইভেন্টের চেকবক্স অটোমেটিক মুছে যায়। সংশ্লিষ্ট ইভেন্টের ধরনের জন্য বিজ্ঞপ্তি শিডিউল করতে হলে আপনাকে সেগুলি আবার বেছে নিতে হবে।

'সব ডেভেলপারকে বিজ্ঞপ্তি পাঠান' বিভাগে ইভেন্টের ধরন অনুযায়ী বিজ্ঞপ্তিগুলি নিম্নলিখিত সারণীতে তালিকাভুক্ত করা হয়েছে। আরও তথ্যের জন্য, UI ব্যবহার করে বিজ্ঞপ্তি এডিট করা দেখুন।

প্রভাবিত ডেভেলপারদের জানানোর জন্য বিজ্ঞপ্তি এডিট করা

প্রভাবিত ডেভেলপারদের বিজ্ঞপ্তি দিন বিভাগে আপনি যেসব ইভেন্টের ধরন বেছে নেন, সেইসব ইভেন্টের ধরন দ্বারা প্রভাবিত ডেভেলপারদেরই শুধুমাত্র বিজ্ঞপ্তি পাঠানো হয়। যেমন, আপনি যদি সংশোধিত রেট প্ল্যান ইভেন্ট বেছে নেন, তাহলে শুধুমাত্র সেইসব ডেভেলপারদের বিজ্ঞপ্তি পাঠানো হবে যারা রেট প্ল্যান গ্রহণ করেছেন।

প্রভাবিত ডেভেলপারদের জানান বিভাগে ইভেন্টের ধরন অনুযায়ী বিজ্ঞপ্তিগুলির তালিকা নিচে দেওয়া হল। আরও তথ্যের জন্য, UI ব্যবহার করে বিজ্ঞপ্তি এডিট করা দেখুন।

Notify API প্রদানকারীদের বিজ্ঞপ্তি এডিট করা

বিজ্ঞপ্তি API প্রদানকারী বিভাগে আপনি যেসব ইভেন্টের ধরন বেছে নেন সেগুলির বিজ্ঞপ্তি আপনার নির্দিষ্ট করা API প্রদানকারীকে পাঠানো হয়।

Notify API প্রদানকারী বিভাগে ইভেন্টের ধরন অনুযায়ী বিজ্ঞপ্তিগুলির তালিকা নিচে দেওয়া হল। আরও তথ্যের জন্য, UI ব্যবহার করে বিজ্ঞপ্তি এডিট করা দেখুন।

কোনও বিজ্ঞপ্তি চালু বা বন্ধ করা

UI ব্যবহার করে কোনও বিজ্ঞপ্তি চালু বা বন্ধ করতে:

1. বিজ্ঞপ্তি পৃষ্ঠা অ্যাক্সেস করুন।
2. কোনও বিজ্ঞপ্তি চালু বা বন্ধ করতে, সেটির ঠিক পাশে থাকা চেকবক্সে টিকচিহ্ন দিন বা টিকচিহ্ন সরিয়ে দিন।
3. সব পরিবর্তন সেভ করতে সেভ করুন বিকল্পে ক্লিক করুন।

সেভ করার প্রসেস সম্পূর্ণ হতে কয়েক মিনিট সময় লাগতে পারে। বিজ্ঞপ্তি সেভ করা হয়েছে তা কনফার্ম করতে একটি মেসেজ দেখানো হয়।

API ব্যবহার করে টেমপ্লেট ব্যবহার করে বিজ্ঞপ্তি সেট-আপ করা

নিম্নলিখিত বিভাগে বর্ণিত API ব্যবহার করে বিজ্ঞপ্তি সেট-আপ করুন।

API ব্যবহার করে বিজ্ঞপ্তি টেমপ্লেট ম্যানেজ করা

নিম্নলিখিত বিভাগে বর্ণিত API ব্যবহার করে বিজ্ঞপ্তি টেমপ্লেট ম্যানেজ করুন:

• API ব্যবহার করে সব বিজ্ঞপ্তি টেমপ্লেট দেখা
• API ব্যবহার করে বিজ্ঞপ্তি টেমপ্লেট দেখা
• API ব্যবহার করে বিজ্ঞপ্তি টেমপ্লেট এডিট করা

API ব্যবহার করে সব বিজ্ঞপ্তি টেমপ্লেট দেখা

মনিটাইজেশন থেকে পাওয়া সব বিজ্ঞপ্তি টেমপ্লেট আপনি /mint/organizations/{org_name}/notification-email-templates-এ GET অনুরোধ করে তালিকাভুক্ত করতে পারবেন। যেমন:

curl -H "Accept:application/json" -X GET \
  "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/notification-email-templates" \
  -u email:password

যেমন, নিচে একটি ইভেন্ট টেমপ্লেট দেওয়া হল যা নতুন API প্রোডাক্টের উপলভ্যতা সম্পর্কে ডেভেলপারদের নোটিফিকেশন পাঠায়:

{
    "createdDate" : 1376975394984,
    "htmlImage" : "<p>Dear ${developer.legalName} , ${developer.name} <br /> Introducing _________. For more details visit us at _________________</p>",
    "id" : "4d81ea64-d005-4010-b0a7-6ec8a5c3954b",
    "name" : "DEFAULT_NEW_PRODUCT_TEMPLATE",
    "orgId" : "myorg",
    "source" : "Mail Man Test",
    "subject" : "Notification of new product",
    "updatedDate" : 1376975394984
}

API ব্যবহার করে বিজ্ঞপ্তি টেমপ্লেট দেখা

/mint/organizations/{org_name}/notification-email-templates/{template_id}-এ GET অনুরোধ ইস্যু করে বিজ্ঞপ্তি টেমপ্লেট দেখুন, {template_id} হল টেমপ্লেটের আইডি। যেমন:

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-email-templates/4d81ea64-d005-4010-b0a7-6ec8a5c3954b" \
  -H "Accept:application/json"  \
  -u email:password

টেমপ্লেটে $ দিয়ে শুরু হওয়া আইটেমগুলি হল ভেরিয়েবল। আরও তথ্যের জন্য, বিজ্ঞপ্তি টেমপ্লেটে ভেরিয়েবল ব্যবহার করা দেখুন। ধরে নিন যে বিজ্ঞপ্তিতে ভেরিয়েবলগুলি নিম্নলিখিত ভ্যালু হিসেবে মূল্যায়ন করা হয়েছে:

• ${developer.legalName}.XYZ company
• ${developer.name}.DEV1
• ${QUOTA_TYPE}.Transactions
• ${PERCENT}.90%
• ${QUOTA_UNIT}.Calls
• ${QUOTA_LIMIT}.100
• ${ratePlan.monetizationPackage.products.name}.X
• ${EXPIRY_DATE}.2016-09-30

টেমপ্লেট থেকে পাওয়া বিজ্ঞপ্তি মেসেজটি হল:

    "Dear XYZ company, DEV1
    You have exceeded Transactions of 90% calls of 100 calls for X product. Your API calls will be blocked till 2016-09-30"

API ব্যবহার করে বিজ্ঞপ্তি টেমপ্লেট এডিট করা

/nint/organizations/{org_name}/notification-email-templates/{template_id}-এ PUT অনুরোধ পাঠিয়ে বিজ্ঞপ্তি টেমপ্লেট এডিট করুন। অনুরোধের বডিতে টেমপ্লেটের পরিবর্তিত কন্টেন্ট প্রদান করুন।

বিজ্ঞপ্তি টেমপ্লেটে মেসেজ কাস্টমাইজ করার সময়, আপনি এক বা একাধিক ভেরিয়েবল যোগ করতে পারবেন। আরও তথ্যের জন্য, বিজ্ঞপ্তিতে ভেরিয়েবল ব্যবহার করা টেমপ্লেট দেখুন।

যেমন, নিম্নলিখিত অনুরোধটি একটি নতুন API প্রোডাক্ট বিজ্ঞপ্তির কন্টেন্ট এডিট করে:

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-email-templates/4d81ea64-d005-4010-b0a7-6ec8a5c3954b " \
  -H "Content-Type: application/json" \
  -d '{
    "id" : "4d81ea64-d005-4010-b0a7-6ec8a5c3954b",
    "htmlImage" : "<p>Exciting news, we have added a new product :${Product.name}. See details in <a href="${Product.url}">New Products</a> </p>",
    "name" : "NewProductNotification",
    "organization": {
    "id": "{org_name}"
    },
    "source" : "Mail Man Test ",
    "subject" : "New Product Available: ${Product.name}"
  }' \
  -u email:password

API ব্যবহার করে বিজ্ঞপ্তির কন্ডিশন ও অ্যাকশন ম্যানেজ করা

নিম্নলিখিত বিভাগে বর্ণিত API ব্যবহার করে বিজ্ঞপ্তি সংক্রান্ত শর্তাবলী ও অ্যাকশন ম্যানেজ করুন।

• API ব্যবহার করে বিজ্ঞপ্তি সংক্রান্ত কন্ডিশন ও অ্যাকশন তৈরি করা
• API ব্যবহার করে বিজ্ঞপ্তির কন্ডিশন ও অ্যাকশন দেখা
• API ব্যবহার করে বিজ্ঞপ্তির কন্ডিশন ও অ্যাকশন এডিট করা
• API ব্যবহার করে বিজ্ঞপ্তির কন্ডিশন ও অ্যাকশন মোছা

API ব্যবহার করে বিজ্ঞপ্তি সংক্রান্ত শর্ত ও অ্যাকশন তৈরি করা

বিজ্ঞপ্তির কন্ডিশন ও অ্যাকশন তৈরি করুন যার ফলে /mint/organizations/{org_name}/notification-conditions-এ POST অনুরোধ পাঠিয়ে অটোমেটিক বিজ্ঞপ্তি জারি করা হয়।

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

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

actions নির্ধারণ করার সময়, প্রযোজ্য বিজ্ঞপ্তি টেমপ্লেট রেফারেন্স হিসেবে ব্যবহার করুন। অ্যাকশনের তালিকার জন্য বিজ্ঞপ্তি অ্যাকশনের জন্য কনফিগারেশন প্রপার্টি দেখুন।

যেমন, নিম্নলিখিত অনুরোধে উল্লেখ করা হয়েছে যে অ্যাট্রিবিউট NEW_PRODUCT এবং অ্যাট্রিবিউটের ভ্যালু PUBLISHED true হলে, ID 01191bf9-5fdd-45bf-8130-3f024694e63 সহ টেমপ্লেটে বিজ্ঞপ্তি পাঠাও (এটি হল DEFAULT_NEW_PRODUCT_TEMPLATE)।

curl -X POST "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-conditions" \
  -H "Content-Type:application/json"
  -d '{
    "notificationCondition": [
    {
      "attribute": "NEW_PRODUCT"
    },
    {
      "attribute": "PUBLISHED",
      "value": "true"
    }
    ],
    "actions": [{
      "actionAttribute": "DEV_ID",
      "value": "ANY",
      "templateId": "01191bf9-5fdd-45bf-8130-3f024694e63"
    }]
  }' \
  -u email:password

API ব্যবহার করে বিজ্ঞপ্তি সংক্রান্ত কন্ডিশন ও অ্যাকশন দেখা

organizations/{org_name}/notification-conditions/{condition_Id}-এ GET অনুরোধ পাঠিয়ে বিজ্ঞপ্তির কন্ডিশন ও অ্যাকশন দেখুন, যেখানে {condition_Id} হল কন্ডিশনের আইডি। বিজ্ঞপ্তি কন্ডিশন তৈরি করলে আইডিটি রিটার্ন করা হয়। যেমন:

curl -X GET "https://api.enterprise.apigee.com /v1/mint/organizations/{org_name}/notification-conditions/2d08d03f-8a54-4e75-bd6f-9c9da2f53fc4" \
  -H "Accept:application/json" \
  -u email:password

উত্তরের একটি উদাহরণ নিচে দেওয়া হল:

    {
    "actions" : [ {
    "actionAttribute" : "DEV_ID",
    "id" : "141ba00c-d7bd-4fef-b339-9d58b83255f4",
    "templateId" : "766aba4f-0f7a-4555-b48e-d707c48b8f4c",
    "value" : "ANY"
    }, {
    "actionAttribute" : "ORG_EMAIL",
    "id" : "21486ce1-4290-4a55-b415-165af3e93c9d",
    "templateId" : "efa4ce63-7c08-4876-984b-6878ec435994",
    "value" : "DEFAULT_LIMIT_NOTIFICATION_EMAIL"
    } ],
    "notificationCondition" : [ {
    "attribute" : "Balance",
    "id" : "2d08d03f-8a54-4e75-bd6f-9c9da2f53fc4",
    "organization" : {
    ...
    },
    "value" : "< 0"
    } ]
    }

API ব্যবহার করে বিজ্ঞপ্তির কন্ডিশন ও অ্যাকশন এডিট করা

organizations/{org_name}/notification-conditions/{condition_Id}-এ POST অনুরোধ ইস্যু করে বিজ্ঞপ্তি সংক্রান্ত শর্ত ও অ্যাকশন এডিট করুন, যেখানে {condition_Id} হল শর্তের আইডি। বিজ্ঞপ্তি কন্ডিশন তৈরি করলে আইডিটি রিটার্ন করা হয়। অনুরোধ করার সময়, বিজ্ঞপ্তি সংক্রান্ত শর্ত বা অ্যাকশনে আপনি যেসব পরিবর্তন করতে চান সেগুলি অনুরোধের বডিতে উল্লেখ করুন।

যেমন:

   $ curl -H "Content-Type:application/json" -X POST -d \
    ' {
    "notificationCondition": [
    {
      "attribute": "NEW_PRODUCT"
    },
    {
    "attribute": "PUBLISHED",
    "value": "true"
    }
    ],
    "actions": [{
      "actionAttribute": "DEV_ID",
      "value": "ANY",
      "templateId": "01191bf9-5fdd-45bf-8130-3f024694e63"
    }]
    }' \
    "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-conditions/2d08d03f-8a54-4e75-bd6f-9c9da2f53fc4" \
  -u email:password

API ব্যবহার করে বিজ্ঞপ্তি সংক্রান্ত কন্ডিশন ও অ্যাকশন মোছা

organizations/{org_name}notification-conditions/{condition_Id}-এ DELETE অনুরোধ পাঠিয়ে বিজ্ঞপ্তির শর্ত মুছে দিন। যেমন:

curl -X DELETE "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/notification-conditions/2d08d03f-8a54-4e75-bd6f-9c9da2f53fc4"  \
  -H "Accept:application/json"  \
  -u email:password

বিজ্ঞপ্তির শর্তের জন্য কনফিগারেশন প্রপার্টি

API ব্যবহার করার সময় বিজ্ঞপ্তির শর্তের জন্য নিম্নলিখিত কনফিগারেশন প্রপার্টি উপলভ্য থাকে।

বিজ্ঞপ্তি অ্যাকশনের জন্য কনফিগারেশন প্রপার্টি

API ব্যবহার করার সময় বিজ্ঞপ্তি অ্যাকশনের জন্য নিম্নলিখিত কনফিগারেশন প্রপার্টি উপলভ্য।

বিজ্ঞপ্তি টেমপ্লেটে ভেরিয়েবল ব্যবহার করা

আপনি যখন কোনও বিজ্ঞপ্তি টেমপ্লেটে মেসেজ এডিট করেন, তখন ট্রানজ্যাকশন অবজেক্টে ফিরে আসা মানগুলি দেখানোর জন্য, Spring Expression Language (SpEL) ব্যবহার করে এক বা একাধিক ভেরিয়েবল যোগ করতে পারেন।

নিচে দেওয়া সারণীতে সবচেয়ে বেশি ব্যবহৃত বিজ্ঞপ্তি টেমপ্লেট ভেরিয়েবলগুলির সংক্ষিপ্তসার দেওয়া হল।

আপনার উত্তর দেওয়ার ইমেল আইডি কাস্টমাইজ করা

মনিটাইজেশনের জন্য, কোম্পানি ও ডেভেলপারদের পাঠানো ইমেল বিজ্ঞপ্তির জন্য একটি ডিফল্ট noreply@apigee.com ঠিকানা কনফিগার করা হয়। আপনার প্রতিষ্ঠানের জন্য কাস্টম উত্তর দেওয়ার নাম ও ঠিকানা কনফিগার করতে Apigee সহায়তা টিমের সাথে যোগাযোগ করুন।