ডেভেলপার

DELETE/tcr/v2/campaign/{campaignId}

একটি মেসেজিং ক্যাম্পেইন নিষ্ক্রিয় করুন

একটি ক্যাম্পেইন বন্ধ করুন, সেটির নম্বর সংযুক্তিগুলো মিলিয়ে নিন এবং সফল প্রতিক্রিয়ার খালি বডির অর্থ বুঝুন।

এই পৃষ্ঠায়
  1. বিদ্যমান একটি মেসেজিং ক্যাম্পেইন নিষ্ক্রিয় করুন
  2. প্রথমে সংশ্লিষ্ট নম্বরগুলোর সংযুক্তি সরান
  3. কাঙ্ক্ষিত নিষ্ক্রিয়করণের অনুরোধ পাঠান
  4. নিবন্ধন ও নম্বরের সংযুক্তি উভয়ই যাচাই করুন
  5. ক্যাম্পেইন বন্ধ করা ও অ্যাকাউন্টের হিসাব নিষ্পত্তি আলাদা বিষয়

বিদ্যমান একটি মেসেজিং ক্যাম্পেইন নিষ্ক্রিয় করুন

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

অনুমোদিত উৎস আইপি ঠিকানা থেকে HTTPS-এর মাধ্যমে একটি সক্রিয় API অ্যাকাউন্ট দিয়ে পরিচয় প্রমাণ করুন। প্রথমে ক্যাম্পেইনের তথ্য পড়ুন এবং সংশ্লিষ্ট ব্র্যান্ড ও বার্তা পাঠানোর নম্বরগুলো পরীক্ষা করুন। নিষ্ক্রিয় করলে নিবন্ধন পরিবর্তিত হয়; এতে বিকল্প ক্যাম্পেইন তৈরি হয় না বা নম্বরগুলো অন্য ক্যাম্পেইনে সরানো হয় না।

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/campaign/$CAMPAIGN_ID"

প্রথমে সংশ্লিষ্ট নম্বরগুলোর সংযুক্তি সরান

ক্যাম্পেইনের সর্বজনীন DELETE অপারেশন মেসেজিং অপারেটর থেকে ফোন নম্বর বিচ্ছিন্ন করে না বা সেগুলোর স্থানীয় সংযুক্তি মুছে দেয় না। ক্যাম্পেইন থেকে নম্বরের সংযুক্তি সরানোর কার্যপ্রবাহ অ্যাকাউন্টের মালিকানাধীন প্রতিটি সংশ্লিষ্ট নম্বরের জন্য ব্যবহার করুন, তারপর সেটির সংযুক্তি যাচাই করুন। সংযুক্তি সরালে ফোন নম্বরটি ছেড়ে দেওয়া হয় না।

পোর্টালের আরও বিস্তৃত ‘ব্র্যান্ড মুছুন’ কার্যপ্রবাহ ব্র্যান্ডটি মোছার আগে সেটির ক্যাম্পেইন ও নম্বরগুলোর সংযুক্তি পরিষ্কার করে। ব্র্যান্ড ও সেটির অন্যান্য ক্যাম্পেইন রাখতে চাইলে ওই পদক্ষেপ ব্যবহার করবেন না। বর্তমান সাধারণ ক্যাম্পেইন সম্পাদকে এই সরাসরি API রুটের সমতুল্য আলাদা কোনো ক্যাম্পেইন মোছার বোতাম নেই।

কাঙ্ক্ষিত নিষ্ক্রিয়করণের অনুরোধ পাঠান

ক্যাম্পেইন আইডি ও সংশ্লিষ্ট বার্তা পাঠানোর ব্যবস্থা পর্যালোচনা করার পর কোনো JSON বডি ছাড়াই DELETE পাঠান:

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request DELETE \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/campaign/$CAMPAIGN_ID"

নথিভুক্ত সফল প্রতিক্রিয়া হলো খালি বডিসহ HTTP 204। JSON status/response মোড়কে প্রতিক্রিয়া পাওয়ার আশা না করে HTTP স্ট্যাটাস পরীক্ষা করুন। মোছার অনুরোধ গৃহীত হলে বর্তমান সেবা স্থানীয়ভাবে ক্যাম্পেইন রিসোর্সকে মুছে ফেলা ও মেয়াদোত্তীর্ণ হিসেবে চিহ্নিত করে এবং সেটির পুরোনো ব্যবস্থার ক্যাম্পেইন রেকর্ডকে মেয়াদোত্তীর্ণ হিসেবে চিহ্নিত করে। এর ফলে ব্র্যান্ড মুছে যায় না।

এই নির্দিষ্ট অনুরোধের জন্য একটি আইডেমপোটেন্সি কী ব্যবহার করুন এবং পুনরায় পাঠানোর জন্য মেথড, পাথ, কোয়েরি ও বডির বাইটগুলো হুবহু সংরক্ষণ করুন। প্রক্রিয়াধীন অনুরোধের সদৃশ অনুরোধে Retry-After-সহ 409 ফিরতে পারে; সম্পন্ন অনুরোধে সংরক্ষিত ফলাফল আবার ফেরত আসতে পারে। ক্যাশে থাকা ত্রুটি বা সংযোগ বিচ্ছিন্ন হওয়া থেকে নিশ্চিত হওয়া যায় না যে রেজিস্ট্রি ইতিমধ্যে কাজটি করেছে কি না। ক্যাম্পেইন আইডি এবং উপস্থিত থাকলে requestId সংরক্ষণ করুন।

নিবন্ধন ও নম্বরের সংযুক্তি উভয়ই যাচাই করুন

অনুরোধের পর পোর্টালে ক্যাম্পেইনের বর্তমান অবস্থা ও সংশ্লিষ্ট নম্বরগুলো পরীক্ষা করুন। ক্যাম্পেইন বন্ধ করার পরও API স্থানীয় মালিকানার মেটাডেটা রেখে দিতে পারে, যাতে নিজের মালিকানাধীন শনাক্তকারী এখনও পরীক্ষা করা যায়; একই আইডির জন্য স্থানীয়ভাবে সবসময় 404 ফিরবেই বলে ধরে নেবেন না। বন্ধ করা ক্যাম্পেইনের রেকর্ডের জন্য কোন স্ট্যাটাস ফিরবে বা রেকর্ডটি পাওয়া যাবে কি না, তা রেজিস্ট্রি নির্ধারণ করে।

কোনো নম্বর সংযুক্ত থেকে গেলে সেই বিদ্যমান সংযুক্তির তথ্য মিলিয়ে অসংগতি মেটান। শুধু নিষ্ক্রিয় করার চেষ্টা আবার করতে আরেকটি ক্যাম্পেইন তৈরি করবেন না বা HTTP 204 পাওয়াকে অপারেটরের দিকে সংযুক্তি পরিষ্কার হওয়ার প্রমাণ বলে ধরে নেবেন না। রেজিস্ট্রি অনুরোধ গ্রহণ করার পর স্থানীয় সমন্বয় ব্যর্থ হলে, বাহ্যিক ব্যবস্থায় ইতিমধ্যে নিষ্ক্রিয় করা হয়ে গেলেও API 500 ফেরত দিতে পারে।

নিষ্ক্রিয়করণের ফলাফল
ফলাফলপরবর্তী পদক্ষেপ
204কোনো প্রতিক্রিয়া বডি থাকার কথা নয়। ক্যাম্পেইনের অবস্থা এবং আলাদাভাবে পরিচালিত নম্বরের সংযুক্তিগুলো যাচাই করুন।
400প্রদত্ত যাচাইকরণ-সংক্রান্ত বা রেজিস্ট্রির অবস্থা-সংক্রান্ত ত্রুটিটি পড়ুন। সুনির্দিষ্ট ক্যাম্পেইন আইডি ও বিদ্যমান অবস্থা পরীক্ষা করুন।
401, 403, 404API পরিচয়প্রমাণের তথ্য, অনুমোদিত উৎস আইপি ও অ্যাকাউন্টের মালিকানা পরীক্ষা করুন। অন্য কোনো গ্রাহকের আইডি বিকল্প হিসেবে ব্যবহার করবেন না।
409, 429প্রক্রিয়াধীন বা পরস্পরবিরোধী আইডেমপোটেন্ট অনুরোধকে অনুরোধের হারসীমা প্রয়োগের ঘটনা থেকে আলাদা করে চিনুন; Retry-After দেওয়া থাকলে তা মেনে চলুন।
500, 502 অথবা সময়সীমা অতিক্রমঅনুরোধের বিবরণ সংরক্ষণ করুন, বিদ্যমান ক্যাম্পেইনের তথ্য পড়ুন এবং আবার অনুরোধ পাঠানোর আগে তথ্য মিলিয়ে অসংগতি মেটান।

ক্যাম্পেইন বন্ধ করা ও অ্যাকাউন্টের হিসাব নিষ্পত্তি আলাদা বিষয়

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

ক্যাম্পেইন ও নম্বরের সংযুক্তিগুলোর তথ্য মিলিয়ে নেওয়ার পর যদি ব্যবসার সম্পূর্ণ নিবন্ধন বন্ধ করা হয়, তবে পরবর্তী ধাপে ব্র্যান্ড বন্ধ করার প্রক্রিয়া অনুসরণ করুন।