ইমেইল 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`	না	লক্ষ্যযুক্ত ইমেইল পাঠানোর জন্য ইমেইল ঠিকানার তালিকা (সর্বোচ্চ ১০০০)। যদি ব্যবহার করা হয়, বার্তাটি শুধুমাত্র এই ঠিকানাগুলিতে পাঠানো হয়। অ্যাপ্লিকেশন গ্রুপ ব্যবহার করা হলে উপেক্ষা করা হয়।
use_auto_registration	`boolean`	না	যদি `true` হয়, তাহলে `devices` প্যারামিটার থেকে ইমেইলগুলি স্বয়ংক্রিয়ভাবে নিবন্ধন করে।
users	`array`	না	যদি সেট করা হয়, ইমেইল বার্তাটি শুধুমাত্র নির্দিষ্ট ব্যবহারকারী আইডিগুলিতে (/registerEmail কলের মাধ্যমে নিবন্ধিত) বিতরণ করা হবে। একটি অ্যারেতে ১০০০-এর বেশি ব্যবহারকারী আইডি থাকবে না। যদি “devices” প্যারামিটার নির্দিষ্ট করা হয়, তাহলে “users” প্যারামিটার উপেক্ষা করা হবে।
dynamic_content_placeholders	`object`	না	ডিভাইস ট্যাগ মানের পরিবর্তে ডাইনামিক কন্টেন্টের জন্য প্লেসহোল্ডার।
conditions	`array`	না	ট্যাগ ব্যবহার করে সেগমেন্টেশন শর্ত। উদাহরণ: `[["Country", "EQ", "BR"]]`।
from	`object`	না	অ্যাপ্লিকেশন প্রোপার্টিজে ডিফল্টকে ওভাররাইড করে একটি কাস্টম প্রেরকের নাম এবং ইমেইল নির্দিষ্ট করুন।
reply-to	`object`	না	অ্যাপ্লিকেশন প্রোপার্টিজে ডিফল্টকে ওভাররাইড করে একটি কাস্টম রিপ্লাই-টু ইমেইল নির্দিষ্ট করুন।
bcc	`array`	না	BCC (ব্লাইন্ড কার্বন কপি): ইমেইল ঠিকানার অ্যারে যা অন্য প্রাপকদের না দেখিয়ে ইমেইলের একটি কপি পায়।
email_type	`string`	না	ইমেইলের ধরন নির্দিষ্ট করুন: `"marketing"` বা `"transactional"`। যদি বাদ দেওয়া হয়, বার্তাটি লেনদেনমূলক হিসাবে গণ্য করা হয় এবং কন্ট্রোল গ্রুপ সহ প্রত্যেককে বিতরণ করা হয়। মার্কেটিং বার্তাগুলি কন্ট্রোল গ্রুপ সদস্যদের কাছে বিতরণ করা হয় না।
email_category	`string`	`email_type` `"marketing"` হলে প্রয়োজনীয়।	সাবস্ক্রিপশন প্রেফারেন্স সেন্টারে কনফিগার করা বিভাগগুলির মধ্যে একটির নাম নির্দিষ্ট করুন (যেমন নিউজলেটার, প্রচারমূলক, পণ্য আপডেট)।
transactionId	`string`	না	নেটওয়ার্ক সমস্যার ক্ষেত্রে পুনরায় পাঠানো রোধ করতে অনন্য বার্তা শনাক্তকারী। Pushwoosh-এর দিকে ৫ মিনিটের জন্য সংরক্ষণ করা হয়।
capping_days	`integer`	না	প্রতি ডিভাইসে ফ্রিকোয়েন্সি ক্যাপিং প্রয়োগ করার জন্য দিনের সংখ্যা (সর্বোচ্চ ৩০)। দ্রষ্টব্য: কন্ট্রোল প্যানেলে গ্লোবাল ফ্রিকোয়েন্সি ক্যাপিং কনফিগার করা আছে তা নিশ্চিত করুন।
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",               //           একটি অ্যারেতে ১০০০-এর বেশি ঠিকানা থাকবে না।
        "email_address2"                //           যদি সেট করা হয়, বার্তাটি শুধুমাত্র তালিকার ঠিকানাগুলিতে
      ],                                //           পাঠানো হবে। অ্যাপ্লিকেশন গ্রুপ ব্যবহার করা হলে উপেক্ষা করা হয়।
      "use_auto_registration": true,    // ঐচ্ছিক। "devices" প্যারামিটারে নির্দিষ্ট ইমেইলগুলি স্বয়ংক্রিয়ভাবে নিবন্ধন করুন
      "users": [                        // ঐচ্ছিক। যদি সেট করা হয়, ইমেইল বার্তাটি শুধুমাত্র নির্দিষ্ট
        "userId1",                      //           ব্যবহারকারী আইডিগুলিতে (/registerEmail কলের মাধ্যমে নিবন্ধিত) বিতরণ করা হবে।
        "userId2"                       //           একটি অ্যারেতে ১০০০-এর বেশি ব্যবহারকারী আইডি থাকবে না।
      ],                                //           যদি "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"
      },
      "bcc": [                          // ঐচ্ছিক। BCC: ইমেইল ঠিকানার অ্যারে যা অন্য প্রাপকদের না দেখিয়ে একটি কপি পায়।
        "bcc1@example.com",
        "bcc2@example.com"
      ],
      "email_type": "marketing",        // ঐচ্ছিক। "marketing" বা "transactional"।
                                        // যদি বাদ দেওয়া হয়, লেনদেনমূলক হিসাবে গণ্য করা হয়: প্রত্যেককে বিতরণ করা হয়।
                                        // মার্কেটিং বার্তাগুলি কন্ট্রোল গ্রুপ সদস্যদের কাছে বিতরণ করা হয় না।
      "email_category": "category name",// email_type "marketing" হলে প্রয়োজনীয়। বিভাগের নাম।
      "transactionId": "unique UUID",   // ঐচ্ছিক। নেটওয়ার্ক সমস্যার ক্ষেত্রে পুনরায় পাঠানো রোধ করতে
                                        //           অনন্য বার্তা শনাক্তকারী। Pushwoosh-এর দিকে
                                        //           ৫ মিনিটের জন্য সংরক্ষণ করা হয়।
      // ফ্রিকোয়েন্সি ক্যাপিং প্যারামিটার। কন্ট্রোল প্যানেলে গ্লোবাল ফ্রিকোয়েন্সি ক্যাপিং কনফিগার করা আছে তা নিশ্চিত করুন।
      // ফ্রিকোয়েন্সি ক্যাপিং লেনদেনমূলক বার্তাগুলিতে প্রযোজ্য নয়।
      // অন্য সব ক্ষেত্রে, "email_type" বাদ দেওয়া সহ, ফ্রিকোয়েন্সি ক্যাপিং প্রযোজ্য।
      "capping_days": 30,               // ঐচ্ছিক। ফ্রিকোয়েন্সি ক্যাপিংয়ের জন্য দিনের পরিমাণ (সর্বোচ্চ ৩০ দিন)
      "capping_count": 10,              // ঐচ্ছিক। একটি নির্দিষ্ট অ্যাপ থেকে একটি নির্দিষ্ট ডিভাইসে 'capping_days'
                                        //           সময়ের মধ্যে পাঠানো যেতে পারে এমন সর্বোচ্চ ইমেইলের সংখ্যা।
                                        //           যদি তৈরি করা বার্তাটি একটি ডিভাইসের জন্য 'capping_count'
                                        //           সীমা অতিক্রম করে, তবে এটি সেই ডিভাইসে পাঠানো হবে না।
      "capping_exclude": true,          // ঐচ্ছিক। যদি true তে সেট করা হয়, এই ইমেইলটি ভবিষ্যতের
                                        //           ইমেইলের জন্য ক্যাপিংয়ের দিকে গণনা করা হবে না।
      "capping_avoid": true,            // ঐচ্ছিক। যদি true তে সেট করা হয়, ক্যাপিং এই নির্দিষ্ট
                                        //           ইমেইলে প্রয়োগ করা হবে না।
      "send_rate": 100,                 // ঐচ্ছিক। থ্রটলিং সীমা।
                                        //           সমস্ত ব্যবহারকারী জুড়ে প্রতি সেকেন্ডে কতগুলি বার্তা পাঠানো যেতে পারে তা সীমিত করুন।
                                        //           উচ্চ-ভলিউম পাঠানোর সময় ব্যাকএন্ড ওভারলোড প্রতিরোধে সহায়তা করে।
      "send_rate_avoid": true,          // ঐচ্ছিক। যদি true তে সেট করা হয়, তাহলে এই নির্দিষ্ট ইমেইলে
                                        //           থ্রটলিং সীমা প্রয়োগ করা হবে না।
    }]
  }
}

প্রতিক্রিয়ার উদাহরণ

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

{
  "status_code": 210,
  "status_message": "Preset content is not approved",
  "response": null
}

{
  "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

Operand-এর বিবরণ

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

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

বৈধ অপারেটর: EQ, IN, NOTEQ, NOTIN
বৈধ operand:

EQ, NOTEQ: operand একটি স্ট্রিং হতে হবে;
IN, NOTIN: operand স্ট্রিংগুলির একটি অ্যারে হতে হবে, যেমন ["value 1", "value 2", "value N"];

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

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

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

তারিখ ট্যাগ

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

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

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

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

তালিকা ট্যাগ

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

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	নিবন্ধিত ডিভাইসে বরাদ্দ করার জন্য ট্যাগ মান।

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

{
  "status_code": 210,
  "status_message": "this hwid (email) is blacklisted",
  "response": null
}

{
  "status_code": 400,
  "status_message": "Missing required argument: email",
  "response": null
}

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

{
  "status_code": 500,
  "status_message": "Internal server error",
  "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
    }
  }
}

প্রতিক্রিয়া কোড

পাবলিক API status_code-এ ফলাফল প্রদান করে। একটি ব্যর্থ কল পুনরায় চেষ্টা করা উচিত কিনা তা নির্ধারণ করতে নীচের টেবিলটি ব্যবহার করুন।

`status_code`	অর্থ	পুনরায় চেষ্টা করবেন?
`200`	সাফল্য — ইমেইল ঠিকানা নিবন্ধিত হয়েছে।	না — সম্পন্ন।
`210`	আর্গুমেন্ট/যাচাইকরণ ত্রুটি — অনুরোধটি বোঝা গেছে কিন্তু প্রত্যাখ্যান করা হয়েছে (কালো তালিকাভুক্ত ঠিকানা, অবৈধ বা ডিসপোজেবল ইমেইল, অ্যাকাউন্টের প্ল্যানের জন্য ভুল প্ল্যাটফর্ম)। নীচের 210 ত্রুটি বার্তা দেখুন।	না — একই অনুরোধ একই `210` প্রদান করবে। ঠিকানাটি লগ করুন এবং এটি এড়িয়ে যান।
`400`	ত্রুটিপূর্ণ অনুরোধ — অবৈধ JSON বা একটি প্রয়োজনীয় ফিল্ড অনুপস্থিত।	না — অনুরোধটি ঠিক করুন, এটি পুনরাবৃত্তি করবেন না।
`403`	নিষিদ্ধ — অবৈধ বা সীমাবদ্ধ ডিভাইস API টোকেন।	না — অনুমোদন ঠিক করুন।
`500`	অভ্যন্তরীণ সার্ভার ত্রুটি — অস্থায়ী অবকাঠামো সমস্যা বা সময়সীমা অতিক্রম।	হ্যাঁ, এক্সপোনেনশিয়াল ব্যাকঅফ সহ — একমাত্র অস্থায়ী ক্ষেত্র।

শুধুমাত্র 500 প্রতিক্রিয়াগুলি পুনরায় চেষ্টা করুন, এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে — এটিই একমাত্র অস্থায়ী ক্ষেত্র। একটি 210, 400, বা 403 চূড়ান্ত: সার্ভার আপনার অনুরোধটি বুঝেছে এবং এটি প্রত্যাখ্যান করেছে, তাই এটি অপরিবর্তিতভাবে পুনরাবৃত্তি করলে একই ফলাফল আসবে। পরিবর্তে ঠিকানাটি লগ করুন (210-এর জন্য) বা অনুরোধ/টোকেন ঠিক করুন (400/403-এর জন্য)।

210 ত্রুটি বার্তা

একটি 210 প্রতিক্রিয়া status_message-এ নির্দিষ্ট কারণ বহন করে।

`status_message`	অর্থ
`this hwid (email) is blacklisted`	একটি স্থায়ী (হার্ড) বাউন্সের পরে ঠিকানাটি দমন তালিকায় রয়েছে এবং পুনরায় নিবন্ধিত হবে না।
`hwid (email) is invalid` / `has invalid semantic`	ঠিকানাটি যাচাইকরণে ব্যর্থ হয়েছে।
`hwid (email) is empty`	কোনো ঠিকানা প্রদান করা হয়নি।
`hwid (email) has invalid count of parts`	অনুপস্থিত বা অতিরিক্ত `@`।
`hwid (email) has invalid local part`	`@`-এর আগের অংশটি অবৈধ।
`hwid (email) has invalid domain part`	ডোমেইন অংশটি অবৈধ।
`hwid (email) has disposable domain`	ঠিকানাটি একটি ডিসপোজেবল/অস্থায়ী ইমেইল ডোমেইন ব্যবহার করে (যেমন 10minutemail)।
`hwid is not valid`	`hwid` নিজেই ত্রুটিপূর্ণ।
`only email platform allowed for Email Only subscription`	অ্যাকাউন্টটি একটি ইমেইল অনলি প্ল্যানে রয়েছে এবং নন-ইমেইল ডিভাইস নিবন্ধন করতে পারে না।

deleteEmail

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

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

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

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

অনুরোধের বডি

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

{
  "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	ইমেইল ঠিকানার সাথে যুক্ত ব্যবহারকারী আইডি।

{
  "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"                            // ঐচ্ছিক। ইমেইল ঠিকানার সাথে যুক্ত ব্যবহারকারী আইডি।
  }
}

registerEmailUser

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

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

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

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

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

অনুরোধের বডি

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

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

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

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

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