ইমেইল API

createEmailMessage

একটি ইমেইল বার্তা তৈরি করে।

POST https://api.pushwoosh.com/json/1.3/createEmailMessage

অনুরোধের বডি প্যারামিটার

নাম	টাইপ	আবশ্যক	বিবরণ
auth	string	হ্যাঁ	Pushwoosh কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন।
application	string	হ্যাঁ	Pushwoosh অ্যাপ্লিকেশন কোড
notifications	array	হ্যাঁ	JSON অ্যারে যা ইমেইল বার্তার বিবরণ ধারণ করে। নিচের নোটিফিকেশন প্যারামিটার টেবিল দেখুন।

নোটিফিকেশন প্যারামিটার

নাম	টাইপ	আবশ্যক	বিবরণ
send_date	string	হ্যাঁ	কখন ইমেইল পাঠাতে হবে তা নির্ধারণ করে। ফরম্যাট: YYYY-MM-DD HH:mm অথবা "now"।
preset	string	হ্যাঁ	ইমেইল প্রিসেট কোড। Pushwoosh কন্ট্রোল প্যানেলের ইমেইল কন্টেন্ট এডিটর এর URL বার থেকে কপি করুন।
subject	string বা object	না	ইমেইলের বিষয় লাইন। ইমেইলটি সর্বদা কন্টেন্টের ভাষায় হবে। যদি subject-এ content-এর জন্য কোনো মিল থাকা ভাষা না থাকে, তাহলে বিষয় খালি থাকবে।
content	string বা object	না	ইমেইলের বডি কন্টেন্ট। প্লেইন HTML কন্টেন্টের জন্য একটি স্ট্রিং অথবা স্থানীয় সংস্করণগুলির জন্য একটি অবজেক্ট হতে পারে।
attachments	array	না	ইমেইলের সংযুক্তি। শুধুমাত্র দুটি সংযুক্তি উপলব্ধ। প্রতিটি সংযুক্তি 1MB (base64 এনকোডেড) এর বেশি হতে পারবে না।
list_unsubscribe	string	না	”Link-Unsubscribe” হেডারের জন্য কাস্টম URL সেট করার অনুমতি দেয়।
campaign	string	না	একটি নির্দিষ্ট ক্যাম্পেইনের সাথে ইমেইলটি সংযুক্ত করার জন্য ক্যাম্পেইন কোড।
ignore_user_timezone	boolean	না	যদি true হয়, ব্যবহারকারীর টাইমজোন উপেক্ষা করে অবিলম্বে ইমেইল পাঠায়।
timezone	string	না	ব্যবহারকারীর টাইমজোন অনুযায়ী ইমেইল পাঠায়। উদাহরণ: "America/New_York"।
filter	string	না	একটি নির্দিষ্ট ফিল্টার শর্ত পূরণকারী ব্যবহারকারীদের কাছে ইমেইল পাঠায়।
devices	array	না	লক্ষ্যযুক্ত ইমেইল পাঠানোর জন্য ইমেইল ঠিকানার তালিকা (সর্বোচ্চ 1000)। যদি ব্যবহার করা হয়, বার্তাটি শুধুমাত্র এই ঠিকানাগুলিতে পাঠানো হয়। অ্যাপ্লিকেশন গ্রুপ ব্যবহার করা হলে উপেক্ষা করা হয়।
use_auto_registration	boolean	না	যদি true হয়, devices প্যারামিটার থেকে ইমেইলগুলি স্বয়ংক্রিয়ভাবে নিবন্ধন করে।
users	array	না	যদি সেট করা হয়, ইমেইল বার্তাটি শুধুমাত্র নির্দিষ্ট ইউজার আইডি-তে পাঠানো হবে (/registerEmail কলের মাধ্যমে নিবন্ধিত)। একটি অ্যারেতে 1000-এর বেশি ইউজার আইডি নয়। যদি “devices” প্যারামিটার নির্দিষ্ট করা হয়, তাহলে “users” প্যারামিটার উপেক্ষা করা হবে।
dynamic_content_placeholders	object	না	ডিভাইস ট্যাগ মানের পরিবর্তে ডাইনামিক কন্টেন্টের জন্য প্লেসহোল্ডার।
conditions	array	না	ট্যাগ ব্যবহার করে সেগমেন্টেশন শর্ত। উদাহরণ: [["Country", "EQ", "BR"]]।
from	object	না	অ্যাপ্লিকেশন প্রোপার্টিতে ডিফল্ট প্রেরকের নাম এবং ইমেইল ওভাররাইড করে একটি কাস্টম প্রেরক নির্দিষ্ট করুন।
reply-to	object	না	অ্যাপ্লিকেশন প্রোপার্টিতে ডিফল্ট রিপ্লাই-টু ইমেইল ওভাররাইড করে একটি কাস্টম রিপ্লাই-টু ইমেইল নির্দিষ্ট করুন।
email_type	string	না	ইমেইলের ধরন নির্দিষ্ট করুন: "marketing" অথবা "transactional"।
email_category	string	email_type যখন "marketing" হয় তখন আবশ্যক।	সাবস্ক্রিপশন প্রেফারেন্স সেন্টারে কনফিগার করা ক্যাটাগরির নামগুলির মধ্যে একটি নির্দিষ্ট করুন (যেমন নিউজলেটার, প্রোমোশনাল, প্রোডাক্ট আপডেট)।
transactionId	string	না	নেটওয়ার্ক সমস্যার ক্ষেত্রে পুনরায় পাঠানো রোধ করার জন্য অনন্য বার্তা শনাক্তকারী। Pushwoosh-এর দিকে 5 মিনিটের জন্য সংরক্ষিত থাকে।
capping_days	integer	না	একটি ডিভাইসের জন্য ফ্রিকোয়েন্সি ক্যাপিং প্রয়োগ করার দিনের সংখ্যা (সর্বোচ্চ 30)। দ্রষ্টব্য: কন্ট্রোল প্যানেলে গ্লোবাল ফ্রিকোয়েন্সি ক্যাপিং কনফিগার করা আছে তা নিশ্চিত করুন।
capping_count	integer	না	একটি capping_days সময়কালের মধ্যে একটি নির্দিষ্ট অ্যাপ থেকে একটি নির্দিষ্ট ডিভাইসে পাঠানো যেতে পারে এমন সর্বোচ্চ ইমেইলের সংখ্যা। যদি তৈরি করা বার্তাটি একটি ডিভাইসের জন্য capping_count সীমা অতিক্রম করে, তবে এটি সেই ডিভাইসে পাঠানো হবে না।
capping_exclude	boolean	না	যদি true তে সেট করা হয়, তাহলে এই ইমেইলটি ভবিষ্যতের ইমেইলের জন্য ক্যাপিংয়ের দিকে গণনা করা হবে না।
capping_avoid	boolean	না	যদি true তে সেট করা হয়, তাহলে এই নির্দিষ্ট ইমেইলে ক্যাপিং প্রয়োগ করা হবে না।
send_rate	integer	না	সমস্ত ব্যবহারকারীর মধ্যে প্রতি সেকেন্ডে কতগুলি বার্তা পাঠানো যেতে পারে তা সীমিত করুন। উচ্চ-ভলিউম পাঠানোর সময় ব্যাকএন্ড ওভারলোড প্রতিরোধে সহায়তা করে।
send_rate_avoid	boolean	না	যদি true তে সেট করা হয়, তাহলে এই নির্দিষ্ট ইমেইলে থ্রটলিং সীমা প্রয়োগ করা হবে না।

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

{
  "request": {
    "auth": "API_ACCESS_TOKEN",         // আবশ্যক। Pushwoosh কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন
    "application": "APPLICATION_CODE",  // আবশ্যক। Pushwoosh অ্যাপ্লিকেশন কোড।
    "notifications": [{
      "send_date": "now",               // আবশ্যক। YYYY-MM-DD HH:mm অথবা 'now'
      "preset": "ERXXX-32XXX",          // আবশ্যক। Pushwoosh কন্ট্রোল প্যানেলের ইমেইল কন্টেন্ট এডিটর পেজের URL বার থেকে ইমেইল প্রিসেট কোড কপি করুন।
      "subject": {                      // ঐচ্ছিক। ইমেইল বার্তার বিষয় লাইন।
        "de": "subject de",
        "en": "subject en"
      },
      "content": {                      // ঐচ্ছিক। ইমেইল বডি কন্টেন্ট।
        "de": "<html><body>de Hello, moto</body></html>",
        "default": "<html><body>default Hello, moto</body></html>"
      },
      "attachments": [{                 // ঐচ্ছিক। ইমেইল সংযুক্তি
        "name": "image.png",            //           "name" - ফাইলের নাম
        "content": "iVBANA...AFTkuQmwC" //           "content" - ফাইলের base64 এনকোডেড কন্টেন্ট
      }, {
        "name": "file.pdf",
        "content": "JVBERi...AFTarEGC"
      }],
      "list_unsubscribe": "URL",        // ঐচ্ছিক। "Link-Unsubscribe" হেডারের জন্য কাস্টম URL সেট করার অনুমতি দেয়
      "campaign": "CAMPAIGN_CODE",      // ঐচ্ছিক। এই ইমেইল বার্তাটিকে একটি নির্দিষ্ট ক্যাম্পেইনে বরাদ্দ করতে,
                                        //           এখানে একটি ক্যাম্পেইন কোড যোগ করুন।
      "ignore_user_timezone": true,     // ঐচ্ছিক।
      "timezone": "America/New_York",   // ঐচ্ছিক। ব্যবহারকারীর ডিভাইসে সেট করা টাইমজোন অনুযায়ী
                                        //           বার্তা পাঠাতে নির্দিষ্ট করুন।
      "filter": "FILTER_NAME",          // ঐচ্ছিক। ফিল্টার শর্ত পূরণকারী নির্দিষ্ট ব্যবহারকারীদের কাছে বার্তা পাঠান।
      "devices": [                      // ঐচ্ছিক। লক্ষ্যযুক্ত ইমেইল বার্তা পাঠানোর জন্য ইমেইল ঠিকানা নির্দিষ্ট করুন।
        "email_address1",               //           একটি অ্যারেতে 1000-এর বেশি ঠিকানা নয়।
        "email_address2"                //           যদি সেট করা হয়, বার্তাটি শুধুমাত্র তালিকার ঠিকানাগুলিতে পাঠানো হবে।
      ],                                //           অ্যাপ্লিকেশন গ্রুপ ব্যবহার করা হলে উপেক্ষা করা হয়।
      "use_auto_registration": true,    // ঐচ্ছিক। "devices" প্যারামিটারে নির্দিষ্ট করা ইমেইলগুলি স্বয়ংক্রিয়ভাবে নিবন্ধন করুন
      "users": [                        // ঐচ্ছিক। যদি সেট করা হয়, ইমেইল বার্তাটি শুধুমাত্র নির্দিষ্ট
        "userId1",                      //           ইউজার আইডিগুলিতে পাঠানো হবে (/registerEmail কলের মাধ্যমে নিবন্ধিত)।
        "userId2"                       //           একটি অ্যারেতে 1000-এর বেশি ইউজার আইডি নয়।
      ],                                //           যদি "devices" প্যারামিটার নির্দিষ্ট করা হয়,
                                        //           "users" প্যারামিটার উপেক্ষা করা হবে।
      "dynamic_content_placeholders": { // ঐচ্ছিক। ডিভাইস ট্যাগ মানের পরিবর্তে ডাইনামিক কন্টেন্টের জন্য প্লেসহোল্ডার।
        "firstname": "John",
        "firstname_en": "John"
      },
      "conditions": [                   // ঐচ্ছিক। সেগমেন্টেশন শর্ত, নিচের মন্তব্য দেখুন।
        ["Country", "EQ", "BR"],
        ["Language", "EQ", "pt"]
      ],
      "from": {                         // ঐচ্ছিক। একটি প্রেরকের নাম এবং প্রেরকের ইমেইল ঠিকানা নির্দিষ্ট করুন
        "name": "alias from",           //           অ্যাপ্লিকেশন প্রোপার্টিতে সেট করা ডিফল্ট "From name" এবং "From email"
        "email": "from-email@email.com" //           প্রতিস্থাপন করতে।
      },
      "reply-to": {                     // ঐচ্ছিক। একটি ইমেইল ঠিকানা নির্দিষ্ট করুন
        "name": "alias reply to ",      //           অ্যাপ্লিকেশন প্রোপার্টিতে সেট করা ডিফল্ট "Reply to" প্রতিস্থাপন করতে।
        "email": "reply-to@email.com"
      },
      "email_type": "marketing",        // ঐচ্ছিক। "marketing" অথবা "transactional"।
      "email_category": "category name",// email_type যখন "marketing" হয় তখন আবশ্যক। ক্যাটাগরির নাম।
      "transactionId": "unique UUID",   // ঐচ্ছিক। নেটওয়ার্ক সমস্যার ক্ষেত্রে পুনরায় পাঠানো রোধ করার জন্য
                                        //           অনন্য বার্তা শনাক্তকারী। Pushwoosh-এর দিকে
                                        //           5 মিনিটের জন্য সংরক্ষিত থাকে।
      // ফ্রিকোয়েন্সি ক্যাপিং প্যারামিটার। কন্ট্রোল প্যানেলে গ্লোবাল ফ্রিকোয়েন্সি ক্যাপিং কনফিগার করা আছে তা নিশ্চিত করুন।
      "capping_days": 30,               // ঐচ্ছিক। ফ্রিকোয়েন্সি ক্যাপিংয়ের জন্য দিনের পরিমাণ (সর্বোচ্চ 30 দিন)
      "capping_count": 10,              // ঐচ্ছিক। একটি 'capping_days' সময়কালের মধ্যে একটি নির্দিষ্ট অ্যাপ থেকে
                                        //           একটি নির্দিষ্ট ডিভাইসে পাঠানো যেতে পারে এমন সর্বোচ্চ ইমেইলের সংখ্যা।
                                        //           যদি তৈরি করা বার্তাটি একটি ডিভাইসের জন্য 'capping_count'
                                        //           সীমা অতিক্রম করে, তবে এটি সেই ডিভাইসে পাঠানো হবে না।
      "capping_exclude": true,          // ঐচ্ছিক। যদি true তে সেট করা হয়, তাহলে এই ইমেইলটি
                                        //           ভবিষ্যতের ইমেইলের জন্য ক্যাপিংয়ের দিকে গণনা করা হবে না।
      "capping_avoid": true,            // ঐচ্ছিক। যদি true তে সেট করা হয়, তাহলে ক্যাপিং এই নির্দিষ্ট
                                        //           ইমেইলে প্রয়োগ করা হবে না।
      "send_rate": 100,                 // ঐচ্ছিক। থ্রটলিং সীমা।
                                        //           সমস্ত ব্যবহারকারীর মধ্যে প্রতি সেকেন্ডে কতগুলি বার্তা পাঠানো যেতে পারে তা সীমিত করুন।
                                        //           উচ্চ-ভলিউম পাঠানোর সময় ব্যাকএন্ড ওভারলোড প্রতিরোধে সহায়তা করে।
      "send_rate_avoid": true,          // ঐচ্ছিক। যদি true তে সেট করা হয়, তাহলে থ্রটলিং সীমা এই নির্দিষ্ট
                                        //           ইমেইলে প্রয়োগ করা হবে না।
    }]
  }
}

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

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

403

{
  "status_code": 403,
  "status_message": "Token restrictions forbid this operation",
  "response": null
}

ট্যাগ শর্ত

প্রতিটি ট্যাগ শর্ত একটি অ্যারে যেমন [tagName, operator, operand] যেখানে

• tagName: একটি ট্যাগের নাম
• operator: “EQ” | “IN” | “NOTEQ” | “NOTIN” | “LTE” | “GTE” | “BETWEEN”
• operand: string | integer | array | date

অপারেন্ডের বিবরণ

• EQ: ট্যাগের মান অপারেন্ডের সমান;
• IN: ট্যাগের মান অপারেন্ডের সাথে ছেদ করে (অপারেন্ড সর্বদা একটি অ্যারে হতে হবে);
• NOTEQ: ট্যাগের মান একটি অপারেন্ডের সমান নয়;
• NOTIN: ট্যাগের মান অপারেন্ডের সাথে ছেদ করে না (অপারেন্ড সর্বদা একটি অ্যারে হতে হবে);
• GTE: ট্যাগের মান অপারেন্ডের চেয়ে বড় বা সমান;
• LTE: ট্যাগের মান অপারেন্ডের চেয়ে ছোট বা সমান;
• BETWEEN: ট্যাগের মান সর্বনিম্ন অপারেন্ড মানের চেয়ে বড় বা সমান কিন্তু সর্বোচ্চ অপারেন্ড মানের চেয়ে ছোট বা সমান (অপারেন্ড সর্বদা একটি অ্যারে হতে হবে)।

স্ট্রিং ট্যাগ

বৈধ অপারেটর: EQ, IN, NOTEQ, NOTIN
বৈধ অপারেন্ড:

• EQ, NOTEQ: অপারেন্ড একটি স্ট্রিং হতে হবে;
• IN, NOTIN: অপারেন্ড একটি স্ট্রিং-এর অ্যারে হতে হবে যেমন ["value 1", "value 2", "value N"];

ইন্টিজার ট্যাগ

বৈধ অপারেটর: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE
বৈধ অপারেন্ড:

• EQ, NOTEQ, GTE, LTE: অপারেন্ড একটি ইন্টিজার হতে হবে;
• IN, NOTIN: অপারেন্ড একটি ইন্টিজারের অ্যারে হতে হবে যেমন [value 1, value 2, value N];
• BETWEEN: অপারেন্ড একটি ইন্টিজারের অ্যারে হতে হবে যেমন [min_value, max_value]।

তারিখ ট্যাগ

বৈধ অপারেটর: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE
বৈধ অপারেন্ড:

• "YYYY-MM-DD 00:00" (স্ট্রিং)
• ইউনিক্স টাইমস্ট্যাম্প 1234567890 (ইন্টিজার)
• "N days ago" (স্ট্রিং) অপারেটর EQ, BETWEEN, GTE, LTE এর জন্য

বুলিয়ান ট্যাগ

বৈধ অপারেটর: EQ
বৈধ অপারেন্ড: 0, 1, true, false

তালিকা ট্যাগ

বৈধ অপারেটর: IN
বৈধ অপারেন্ড: অপারেন্ড একটি স্ট্রিং-এর অ্যারে হতে হবে যেমন ["value 1", "value 2", "value N"]।

বিপদ

মনে রাখবেন যে “filter” এবং “conditions” প্যারামিটারগুলি একসাথে ব্যবহার করা উচিত নয়।
এছাড়াও, যদি একই অনুরোধে “devices” প্যারামিটার ব্যবহার করা হয়, তবে উভয়ই উপেক্ষা করা হবে।

নোট

দেশ এবং ভাষা ট্যাগ

ভাষা ট্যাগের মান ISO-639-1 অনুযায়ী একটি ছোট হাতের দুই-অক্ষরের কোড।
দেশ ট্যাগের মান ISO_3166-2 অনুযায়ী একটি বড় হাতের দুই-অক্ষরের কোড।
উদাহরণস্বরূপ, ব্রাজিলের পর্তুগিজ-ভাষী গ্রাহকদের কাছে পুশ নোটিফিকেশন পাঠাতে, আপনাকে নিম্নলিখিত শর্তটি নির্দিষ্ট করতে হবে: "conditions": [["Country", "EQ", "BR"],["Language", "EQ", "pt"]]

registerEmail

অ্যাপের জন্য ইমেইল ঠিকানা নিবন্ধন করে।

POST https://api.pushwoosh.com/json/1.3/registerEmail

অনুরোধের হেডার

নাম	আবশ্যক	মান	বিবরণ
Authorization	হ্যাঁ	Token XXXX	ডিভাইস API অ্যাক্সেস করার জন্য API ডিভাইস টোকেন। XXXX কে আপনার আসল ডিভাইস API টোকেন দিয়ে প্রতিস্থাপন করুন।

অনুরোধের বডি

নাম	টাইপ	বিবরণ
application*	string	Pushwoosh অ্যাপ্লিকেশন কোড
email*	string	ইমেইল ঠিকানা।
language	string	ডিভাইসের ভাষা লোকেল। ISO-639-1 মান অনুযায়ী একটি ছোট হাতের দুই-অক্ষরের কোড হতে হবে।
userId	string	ইমেইল ঠিকানার সাথে যুক্ত করার জন্য ইউজার আইডি।
tz_offset	integer	সেকেন্ডে টাইমজোন অফসেট।
tags	object	নিবন্ধিত ডিভাইসে বরাদ্দ করার জন্য ট্যাগ মান।

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

উদাহরণ

{
  "request": {
    "application": "APPLICATION_CODE",   // আবশ্যক। Pushwoosh অ্যাপ্লিকেশন কোড।
    "email":"email@domain.com",          // আবশ্যক। নিবন্ধন করার জন্য ইমেইল ঠিকানা।
    "language": "en",                    // ঐচ্ছিক। ভাষা লোকেল।
    "userId": "userId",                  // ঐচ্ছিক। ইমেইল ঠিকানার সাথে যুক্ত করার জন্য ইউজার আইডি।
    "tz_offset": 3600,                   // ঐচ্ছিক। সেকেন্ডে টাইমজোন অফসেট।
    "tags": {                            // ঐচ্ছিক। নিবন্ধিত ডিভাইসের জন্য সেট করার জন্য ট্যাগ মান।
       "StringTag": "string value",
       "IntegerTag": 42,
       "ListTag": ["string1","string2"], // তালিকা ধরনের ট্যাগের জন্য মানের তালিকা সেট করে
       "DateTag": "2024-10-02 22:11",    // মনে রাখবেন সময় UTC তে হওয়া উচিত
       "BooleanTag": true                // বৈধ মানগুলি হল: true, false
    }
  }
}

deleteEmail

আপনার ব্যবহারকারী বেস থেকে ইমেইল ঠিকানা মুছে ফেলে।

POST https://api.pushwoosh.com/json/1.3/deleteEmail

অনুরোধের হেডার

নাম	আবশ্যক	মান	বিবরণ
Authorization	হ্যাঁ	Token XXXX	ডিভাইস API অ্যাক্সেস করার জন্য API ডিভাইস টোকেন। XXXX কে আপনার আসল ডিভাইস API টোকেন দিয়ে প্রতিস্থাপন করুন।

অনুরোধের বডি

নাম	টাইপ	বিবরণ
application	string	Pushwoosh অ্যাপ্লিকেশন কোড
email	string	/registerEmail অনুরোধে ব্যবহৃত ইমেইল ঠিকানা।

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

উদাহরণ

{
  "request": {
    "application": "APPLICATION_CODE",  // আবশ্যক। Pushwoosh অ্যাপ্লিকেশন কোড
    "email": "email@domain.com"         // আবশ্যক। অ্যাপ গ্রাহকদের থেকে মুছে ফেলার জন্য ইমেইল।
  }
}

setEmailTags

ইমেইল ঠিকানার জন্য ট্যাগ মান সেট করে।

POST https://api.pushwoosh.com/json/1.3/setEmailTags

অনুরোধের হেডার

নাম	আবশ্যক	মান	বিবরণ
Authorization	হ্যাঁ	Token XXXX	ডিভাইস API অ্যাক্সেস করার জন্য API ডিভাইস টোকেন। XXXX কে আপনার আসল ডিভাইস API টোকেন দিয়ে প্রতিস্থাপন করুন।

অনুরোধের বডি

নাম	টাইপ	বিবরণ
application	string	Pushwoosh অ্যাপ্লিকেশন কোড
email	string	ইমেইল ঠিকানা।
tags	object	সেট করার জন্য ট্যাগের JSON অবজেক্ট, মান মুছে ফেলার জন্য ‘null’ পাঠান।
userId	string	ইমেইল ঠিকানার সাথে যুক্ত ইউজার আইডি।

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "skipped": []
  }
}

উদাহরণ

{
  "request": {
    "email": "email@domain.com",                  // আবশ্যক। ট্যাগ সেট করার জন্য ইমেইল ঠিকানা।
    "application": "APPLICATION_CODE",            // আবশ্যক। Pushwoosh অ্যাপ্লিকেশন কোড।
    "tags": {
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"],
      "DateTag": "2024-10-02 22:11",              // সময় UTC তে
      "BooleanTag": true                          // বৈধ মানগুলি হল: true, false
    },
    "userId": "userId"                            // ঐচ্ছিক। ইমেইল ঠিকানার সাথে যুক্ত ইউজার আইডি।
  }
}

নোট

অন্যান্য ধরনের ডিভাইসের জন্য 200 OK ফেরত দেওয়া হবে, যদিও ট্যাগগুলি সংরক্ষণ করা হবে না।

সতর্কতা

অনুগ্রহ করে একটি /setEmailTags অনুরোধে 50টির বেশি ট্যাগ মান সেট করা থেকে বিরত থাকুন।

registerEmailUser

একটি নির্দিষ্ট ইমেইল ঠিকানার সাথে একটি বাহ্যিক ইউজার আইডি যুক্ত করে।

POST https://api.pushwoosh.com/json/1.3/registerEmailUser

নোট

অনুগ্রহ করে মনে রাখবেন যে এই পদ্ধতিটি আপনার ব্যবহারকারী বেসে একটি ইমেইল ঠিকানা নিবন্ধন করে না; এটি শুধুমাত্র /registerEmail অনুরোধ দ্বারা ইতিমধ্যে নিবন্ধিত ইমেইল ঠিকানাগুলিতে ইউজার আইডি বরাদ্দ করার জন্য ব্যবহার করা উচিত।

/createEmailMessage API কলে ব্যবহার করা যেতে পারে (‘users’ প্যারামিটার)।

অনুরোধের হেডার

নাম	আবশ্যক	মান	বিবরণ
Authorization	হ্যাঁ	Token XXXX	ডিভাইস API অ্যাক্সেস করার জন্য API ডিভাইস টোকেন। XXXX কে আপনার আসল ডিভাইস API টোকেন দিয়ে প্রতিস্থাপন করুন।

অনুরোধের বডি

নাম	টাইপ	বিবরণ
application*	string	Pushwoosh অ্যাপ্লিকেশন কোড
email*	string	ইমেইল ঠিকানা।
userId*	string	ইমেইল ঠিকানার সাথে যুক্ত করার জন্য ইউজার আইডি।
tz_offset	integer	সেকেন্ডে টাইমজোন অফসেট।

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

400

{
  "status_code": 400,
  "status_message": "Request format is not valid."
}

403

{
  "status_code": 403,
  "status_message": "Forbidden."
}

উদাহরণ

{
  "request": {
    "application": "APPLICATION_CODE", // আবশ্যক। Pushwoosh অ্যাপ্লিকেশন কোড।
    "email": "email@domain.com",       // আবশ্যক। ব্যবহারকারীর ইমেইল ঠিকানা।
    "userId": "userId",                // আবশ্যক। ইমেইল ঠিকানার সাথে যুক্ত করার জন্য ইউজার আইডি।
    "tz_offset": 3600                  // ঐচ্ছিক। সেকেন্ডে টাইমজোন অফসেট।
  }
}

নোট

সফট বাউন্স, হার্ড বাউন্স, এবং ইমেইল অভিযোগের ডেটা পুনরুদ্ধার করতে, যার মধ্যে তারিখ, ইমেইল ঠিকানা, এবং প্রতিটি বাউন্সের কারণ অন্তর্ভুক্ত, BouncedEmails পদ্ধতি ব্যবহার করুন।