নাম পরিবর্তন

POST https://api.pushwoosh.com/messaging/v2/rename

message_code দ্বারা চিহ্নিত, পূর্বে তৈরি করা একটি মেসেজের ক্যাম্পেইন নাম সেট বা মুছে দেয়। মেসেজের আর কিছুই পরিবর্তন হয় না। কনটেন্ট, অডিয়েন্স এবং শিডিউল ঠিক আগের মতোই থাকে।

নাম পরিবর্তন শুধুমাত্র তখনই সম্ভব যখন মেসেজটি এখনও পেন্ডিং থাকে — তৈরি করা হয়েছে কিন্তু এখনও পাঠানোর জন্য গ্রহণ করা হয়নি। যে মেসেজ waiting, processing, বা পরবর্তী কোনো অবস্থায় চলে গেছে, তার নাম আর পরিবর্তন করা যায় না। Control Panel-এ এই অবস্থা স্ট্যাটাস কলামে আক্ষরিক অর্থে “Pending” এর বদলে নির্ধারিত হিসেবে দেখানো হয়। দেখুন মেসেজ স্ট্যাটাস।

নামের শুরু ও শেষের স্পেস বাদ দেওয়া হয় এবং ২৫৫ অক্ষরে কেটে ফেলা হয়। একটি খালি (বা শুধু স্পেসযুক্ত) নাম ক্যাম্পেইন নাম সম্পূর্ণরূপে মুছে দেয়, এবং মেসেজটি Message History-এ তার ডিফল্ট শিরোনামে ফিরে যায়।
এই কলটি ইডেমপোটেন্ট: একই নাম আবার পাঠালে একই মান আবার প্রয়োগ হয়। তবুও, এটি প্রতিটি কলে মেসেজের সর্বশেষ পরিবর্তনের সময় স্পর্শ করে, নাম আসলে পরিবর্তিত হোক বা না হোক, তাই একটি পুনরাবৃত্ত কল মেসেজটিকে Message History-এর ডিফল্ট সর্বশেষ পরিবর্তিত সাজানোর শীর্ষে নিয়ে যেতে পারে।

কোনো মেসেজ এখনও নাম পরিবর্তনযোগ্য অবস্থায় আছে কিনা তা যাচাই করতে দেখুন মেসেজের স্ট্যাটাস পরীক্ষা করা।

অনুরোধ

আপনার সার্ভার API টোকেন দিয়ে Authorization: Token <API_TOKEN> হেডারে প্রমাণীকরণ করুন।

ক্ষেত্র	টাইপ	প্রয়োজনীয়	বিবরণ
`message_code`	string	হ্যাঁ	নাম পরিবর্তন করার জন্য মেসেজের মেসেজ কোড, যা `Notify` দ্বারা `result.message_code`-এ রিটার্ন করা হয়েছিল।
`campaign_name`	string	হ্যাঁ	নতুন ক্যাম্পেইন নাম। ট্রিম করা এবং ২৫৫ অক্ষরে কাটা। একটি খালি স্ট্রিং নাম মুছে দেয়।

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

curl -X POST https://api.pushwoosh.com/messaging/v2/rename \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message_code": "XXXX-XXXXXXXX-XXXXXXXX",
    "campaign_name": "Flash_Sale_Push"
  }'

প্রতিক্রিয়া

সফল হলে, একটি খালি JSON বডি সহ HTTP 200 রিটার্ন করে।

{}

ত্রুটি

ত্রুটিগুলি স্ট্যান্ডার্ড gRPC-Gateway এরর এনভেলপ ব্যবহার করে: { "code": ..., "message": ..., "details": [...] }।

HTTP স্ট্যাটাস	শর্ত
`400`	`message_code` অনুপস্থিত।
`400`	মেসেজটি নাম পরিবর্তনযোগ্য অবস্থায় নেই (এটি আর `pending` নয়)।
`403`	মেসেজটি অন্য অ্যাকাউন্টের।
`404`	প্রদত্ত `message_code`-এর জন্য কোনো মেসেজ বিদ্যমান নেই।
`500`	মেসেজ লোড করার সময় বা নতুন নাম প্রয়োগ করার সময় একটি অভ্যন্তরীণ ত্রুটি ঘটেছে। অনুরোধটি পুনরায় চেষ্টা করুন।

উদাহরণ

যে মেসেজের পাঠানো ইতিমধ্যে শুরু হয়ে গেছে তার নাম পরিবর্তন করলে HTTP 400 রিটার্ন করে:

{
  "code": 9,
  "message": "message status \"waiting\" is not renamable",
  "details": []
}

মেসেজের স্ট্যাটাস পরীক্ষা করা

নাম পরিবর্তনের আগে, আপনি যাচাই করতে পারেন যে একটি মেসেজ এখনও নাম পরিবর্তনযোগ্য অবস্থায় আছে কিনা। কন্ট্রোল প্যানেলের মেসেজ টেবিলে (Campaigns → One-time messages) স্ট্যাটাস কলামটি পড়া ছাড়াও, যেখানে নাম পরিবর্তনযোগ্য মেসেজ আক্ষরিক অর্থে “Pending” এর বদলে নির্ধারিত হিসেবে দেখানো হয়, আপনি messages:list ব্যবহার করে প্রোগ্রাম্যাটিকভাবে স্ট্যাটাস জিজ্ঞাসা করতে পারেন:

filters.messages_codes অ্যারেতে message_code পাস করুন (প্রয়োজনীয় filters.application-এর পাশাপাশি)।
items[]-এর মধ্যে ম্যাচিং এন্ট্রির status ফিল্ডটি পড়ুন।