WhatsApp Cloud API ত্রুটির কোড
এখানে নথিবদ্ধ সব WhatsApp Cloud API ত্রুটির কোড একটি টেবিলে দেওয়া আছে, প্রতিটির অর্থ এবং পুনরায় পাঠালে লাভ হবে কি না-সহ। বেশিরভাগ ক্ষেত্রে হবে না: এগুলো নির্ধারিত ত্রুটি, তাই একই রিকোয়েস্ট একইভাবে ব্যর্থ হয় এবং বারবার পাঠালে ভুল রিকোয়েস্ট রেট লিমিট তৈরি করে।
Request
| Code | What it means | Retry |
|---|---|---|
| 100 | A parameter is unsupported, misspelled or malformed. | No |
| 131008 | A required parameter was not included at all. | No |
| 131009 | A parameter is present with a value the endpoint rejects. | No |
| 131021 | Sender and recipient are the same number. | No |
| 131051 | The message type is not supported, often a Coexistence limit. | No |
| 131052 | Meta could not download media a customer sent. | No |
| 131053 | Meta could not upload media you sent. Size, format or reach. | No |
Template
| Code | What it means | Retry |
|---|---|---|
| 132000 | The number of parameters does not match the template. | No |
| 132001 | No template exists with that name and language pair. | No |
| 132007 | The template breaks messaging policy. Rewrite and resubmit. | No |
| 132012 | Parameter format does not match what the template defines. | No |
| 132015 | The template is paused after a quality decline. Temporary. | Wait |
| 132016 | The template is permanently disabled. It will not come back. | No |
Window and recipient
Registration and PIN
| Code | What it means | Retry |
|---|---|---|
| 131045 | The number was never registered for Cloud API messaging. | No |
| 133010 | The number is not registered. Registration must be completed. | No |
| 133006 | The number must be verified before it can be registered. | No |
| 133005 | The two-step verification PIN was wrong. Stop guessing. | No |
| 133008 | Too many PIN attempts. Registration is locked for a period. | Wait |
Access and account
| Code | What it means | Retry |
|---|---|---|
| 190 | The access token expired or was invalidated. | No |
| 368 | The account is restricted after a policy violation. | No |
| 131031 | The account is restricted, or its data does not match Meta's. | No |
| 131042 | A payment problem on the business account blocks sending. | No |
| 131049 | Meta blocked the message to protect ecosystem health. | No |
Rate limits
Transient
Coexistence sync
পুনরায় পাঠানোর কলাম কীভাবে পড়বেন
এখানে তিনটি মান আছে, এবং ভুলটি বেছে নেওয়াই এই পুরো রেফারেন্সে সবচেয়ে ব্যয়বহুল ভুল।
না মানে ব্যর্থতাটি নির্ধারিত। রিকোয়েস্ট, টেমপ্লেট অথবা প্রাপকের স্ট্যাটাসে সমস্যা হয়েছে, তাই একই রিকোয়েস্ট আবার পাঠালে একই ত্রুটি আসে এবং পরে প্রয়োজন হবে এমন থ্রুপুট কমে যায়। হ্যাঁ মানে সমস্যা Meta-র দিকে ছিল এবং ব্যাকঅফ করলে সত্যিই সমাধান হয়। অপেক্ষা করুন মানে শর্তটি বাস্তব, কিন্তু সাময়িক: এমন সীমা বা লক, যা নিজে থেকেই উঠে যায়। ওঠার আগে পুনরায় পাঠালে কোনো লাভ হয় না, বরং সময় আরও বাড়তে পারে।
কেন এগুলোর বেশিরভাগে পুনরায় পাঠানো উচিত নয়
কারণ প্ল্যাটফর্ম সাধারণ ত্রুটির বদলে নির্দিষ্ট কোড দেয়। ভুল প্যারামিটার, অস্তিত্বহীন টেমপ্লেট, বন্ধ মেসেজিং উইন্ডো এবং অপ্ট-আউট করা প্রাপক, এগুলো প্রতিক্রিয়ার সময়ই শনাক্ত করা যায়। তাই Meta অস্পষ্টভাবে ব্যর্থ না হয়ে কারণটি জানায়।
- দ্বিতীয়বার চেষ্টা করলে রিকোয়েস্টের সমস্যা ঠিক হয়ে যায় না।
- টেমপ্লেটের সমস্যাটি টেমপ্লেটেই থাকে, রিকোয়েস্ট তা বদলাতে পারে না।
- উইন্ডো বা অপ্ট-আউটের সমস্যা আপনার নয়, প্রাপকের স্ট্যাটাসের।
- অ্যাকাউন্টের সীমাবদ্ধতা একটি সিদ্ধান্ত, পুনরায় পাঠানো কোনো আপিল নয়।
এগুলোর কোনোটি এলে কী লগ করবেন
আবার তৈরি না করেই ত্রুটি শনাক্ত করার মতো তথ্য রাখুন। পাঁচ মিনিটের সমাধান আর এক দিন অনুমান করার মধ্যে পার্থক্য এখানেই।
- ট্রেস আইডিসহ সম্পূর্ণ ত্রুটির প্রতিক্রিয়া রাখুন, কারণ Meta-র সহায়তা এটি চাইবে।
- যেভাবে পাঠানো হয়েছে সেই রিকোয়েস্ট বডি রাখুন, যেভাবে পাঠানোর কথা ছিল তা নয়। এই দুইয়ের ব্যবধানই সাধারণত বাগ।
- ফোন নম্বরের আইডি রাখুন, যাতে একটি নম্বরের সমস্যা আর পুরো অ্যাকাউন্টের সমস্যা আলাদা বোঝা যায়।
- টাইমস্ট্যাম্প রাখুন, যাতে ওই মুহূর্তে সংযোগের স্ট্যাটাসের সঙ্গে ব্যর্থতাটি মিলিয়ে দেখা যায়।
শুধু Coexistence-এ থাকা কোডগুলো
এমন কোড দুটি, এবং এগুলো মানুষকে বিভ্রান্ত করে, কারণ দেখতে সাধারণ পাঠানোর ত্রুটির মতো। 2593107 এবং 2593108 দুটিই চ্যাট হিস্ট্রি সিঙ্ক্রোনাইজেশন নিয়ে, অর্থাৎ কোনো নম্বর প্রথমবার সংযুক্ত হলে WhatsApp Business অ্যাপ থেকে সাম্প্রতিক কথোপকথন কপি করার ধাপ।
এগুলো মেসেজিংয়ের ত্রুটি নয় এবং সংযোগ ব্যর্থ হয়েছে এমনও নয়। সিঙ্ক্রোনাইজেশন সীমা ছাড়িয়ে গেলে বা নির্ধারিত সময়ের বাইরে চললে নম্বরটি সংযুক্ত ও স্বাভাবিকভাবে মেসেজ পাঠাতে থাকে, শুধু প্রত্যাশার চেয়ে কম হিস্ট্রি কপি হয়। এগুলোকে সংযোগ নষ্ট হওয়া হিসেবে পড়ে অনেকে সংযোগ বিচ্ছিন্ন করে আবার শুরু করেন, ফলে হিস্ট্রি ফিরে পাওয়ার বদলে আরও বেশি হিস্ট্রি হারায়।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
কোন ত্রুটিগুলোতে পুনরায় পাঠানো উচিত?
131016 এবং 131000, এক্সপোনেনশিয়াল ব্যাকঅফসহ। 130429, 132015 এবং 133008 অপেক্ষা করলে নিজে থেকেই ঠিক হয়। বাকি সব নির্ধারিত ত্রুটি।
ত্রুটির কোড মানেই কি আমার নম্বর সংযোগ বিচ্ছিন্ন?
সাধারণত নয়। বেশিরভাগ কোড রিকোয়েস্ট, টেমপ্লেট অথবা প্রাপক নিয়ে। সংযোগের সমস্যা পাঠানোর ত্রুটি হিসেবে নয়, অ্যাকাউন্ট ও কোয়ালিটির ওয়েবহুক হিসেবে দেখা যায়।
ট্রেস আইডি কী?
ত্রুটির প্রতিক্রিয়ায় থাকা একটি শনাক্তকারী, যা Meta-র সহায়তাকে নির্দিষ্ট রিকোয়েস্ট খুঁজে পেতে দেয়। প্রতিটি ব্যর্থতায় এটি লগ করুন, না হলে টিকিটে ব্যবস্থা নেওয়া যায় না।
সব প্রোভাইডারে কি এই কোড একই?
হ্যাঁ। এগুলো Meta-র Cloud API থেকে আসে, তাই যে প্রোভাইডারই নম্বর সংযুক্ত করুক, কোড একই থাকে। প্রোভাইডার শুধু কতটা পরিষ্কারভাবে এগুলো আপনার কাছে পৌঁছায় তা বদলাতে পারে।
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুন7 দিন কোনও চার্জ নেই। যেকোনও সময় বাতিল করুন।