# নাম পরিবর্তন

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

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

নাম পরিবর্তন শুধুমাত্র তখনই সম্ভব যখন মেসেজটি এখনও **পেন্ডিং** থাকে — তৈরি করা হয়েছে কিন্তু এখনও পাঠানোর জন্য গ্রহণ করা হয়নি। যে মেসেজ `waiting`, `processing`, বা পরবর্তী কোনো অবস্থায় চলে গেছে, তার নাম আর পরিবর্তন করা যায় না। Control Panel-এ এই অবস্থা স্ট্যাটাস কলামে আক্ষরিক অর্থে "Pending" এর বদলে **নির্ধারিত** হিসেবে দেখানো হয়। দেখুন [মেসেজ স্ট্যাটাস](/bn/product/statistics-and-analytics/message-history/#message-statuses)।

<Aside type="caution" title="গুরুত্বপূর্ণ">

- নামের শুরু ও শেষের স্পেস বাদ দেওয়া হয় এবং ২৫৫ অক্ষরে কেটে ফেলা হয়। একটি খালি (বা শুধু স্পেসযুক্ত) নাম ক্যাম্পেইন নাম সম্পূর্ণরূপে মুছে দেয়, এবং মেসেজটি [Message History](/bn/product/statistics-and-analytics/message-history/)-এ তার ডিফল্ট শিরোনামে ফিরে যায়।

- এই কলটি ইডেমপোটেন্ট: একই নাম আবার পাঠালে একই মান আবার প্রয়োগ হয়। তবুও, এটি প্রতিটি কলে মেসেজের সর্বশেষ পরিবর্তনের সময় স্পর্শ করে, নাম আসলে পরিবর্তিত হোক বা না হোক, তাই একটি পুনরাবৃত্ত কল মেসেজটিকে Message History-এর ডিফল্ট **সর্বশেষ পরিবর্তিত** সাজানোর শীর্ষে নিয়ে যেতে পারে।
</Aside>

কোনো মেসেজ এখনও নাম পরিবর্তনযোগ্য অবস্থায় আছে কিনা তা যাচাই করতে দেখুন [মেসেজের স্ট্যাটাস পরীক্ষা করা](#checking-message-status)।

## অনুরোধ

আপনার [সার্ভার API টোকেন](/bn/developer/api-reference/api-access-token/#server-api-token) দিয়ে `Authorization: Token <API_TOKEN>` হেডারে প্রমাণীকরণ করুন।

| ক্ষেত্র | টাইপ | প্রয়োজনীয় | বিবরণ |
|---|---|---|---|
| `message_code` | string | হ্যাঁ | নাম পরিবর্তন করার জন্য মেসেজের [মেসেজ কোড](/bn/developer/api-reference/api-identifiers/#message-code), যা [`Notify`](/bn/developer/api-reference/messaging-api-v2/notify/) দ্বারা `result.message_code`-এ রিটার্ন করা হয়েছিল। |
| `campaign_name` | string | হ্যাঁ | নতুন ক্যাম্পেইন নাম। ট্রিম করা এবং ২৫৫ অক্ষরে কাটা। একটি খালি স্ট্রিং নাম মুছে দেয়। |

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

```bash
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 রিটার্ন করে।

```json
{}
```

## ত্রুটি

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

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


**উদাহরণ**

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

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

<span id="checking-message-status" />

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

নাম পরিবর্তনের আগে, আপনি যাচাই করতে পারেন যে একটি মেসেজ এখনও নাম পরিবর্তনযোগ্য অবস্থায় আছে কিনা। কন্ট্রোল প্যানেলের মেসেজ টেবিলে ([**Campaigns → One-time messages**](/bn/product/statistics-and-analytics/message-history/)) **স্ট্যাটাস** কলামটি পড়া ছাড়াও, যেখানে নাম পরিবর্তনযোগ্য মেসেজ আক্ষরিক অর্থে "Pending" এর বদলে **নির্ধারিত** হিসেবে দেখানো হয়, আপনি [`messages:list`](/bn/developer/api-reference/statistics-api/message-statistics-api/#messageslist) ব্যবহার করে প্রোগ্রাম্যাটিকভাবে স্ট্যাটাস জিজ্ঞাসা করতে পারেন:

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

<Aside type="note">
`messages:list` স্ট্যাটিস্টিকস API-এর একটি অংশ এবং এই এন্ডপয়েন্টের চেয়ে ভিন্ন একটি অথ হেডার ব্যবহার করে: `Authorization: Api <Server Key>`।
</Aside>

## সম্পর্কিত

<CardGrid>
  <LinkCard title="নোটিফাই" href="/developer/api-reference/messaging-api-v2/notify/" />
  <LinkCard title="আপডেট" href="/developer/api-reference/messaging-api-v2/update/" />
  <LinkCard title="বাতিল" href="/developer/api-reference/messaging-api-v2/cancel/" />
  <LinkCard title="মেসেজ পরিসংখ্যান" href="/developer/api-reference/statistics-api/message-statistics-api/#messageslist" />
  <LinkCard title="মেসেজিং API v2 ওভারভিউ" href="/developer/api-reference/messaging-api-v2/" />
  <LinkCard title="v1 থেকে মাইগ্রেশন" href="/developer/api-reference/messaging-api-v2/migration-from-v1/" />
</CardGrid>