কেন একটি WhatsApp মেসেজ ব্যর্থ হলো: ব্যর্থ স্ট্যাটাস ও তার ত্রুটি পড়া
ব্যর্থ স্ট্যাটাস ওয়েবহুক মানে হলো, ব্যবসা API-এর মাধ্যমে যে মেসেজ পাঠিয়েছে Meta তা পাঠাতে বা পৌঁছে দিতে পারেনি। এটি messages ফিল্ডে আসে, যেখানে স্ট্যাটাস থাকে failed এবং একটি errors array, যাতে code, title, message, error_data.details ও href থাকে। code কারণটি জানায়: 131047 উইন্ডো বন্ধ, 131026 পৌঁছানো যায় না, 131049 মার্কেটিং সীমা, 131050 মার্কেটিং বন্ধ, 131042 পেমেন্ট সমস্যা।
easyCoexistence আপনার WhatsApp Business অ্যাপের নম্বর Coexistence-এর মাধ্যমে Meta-র Cloud API-র সঙ্গে যুক্ত করে এবং ব্যর্থ স্ট্যাটাস আপনার সার্ভারে পাঠায়, সরাসরি অথবা স্বয়ংক্রিয়তা চালু থাকলে স্বাক্ষরিত forward হিসেবে।
প্রাপক শেষবার উত্তর দেওয়ার পর 24 ঘণ্টার বেশি সময় পেরিয়ে গেছে; Meta-র সমাধান হলো বদলে একটি টেমপ্লেট পাঠানো।
ইকোসিস্টেমের এনগেজমেন্ট সুস্থ রাখতে পৌঁছানো হয়নি; মার্কেটিং টেমপ্লেট আবার পাঠানোর আগে অন্তত 24 ঘণ্টা অপেক্ষা করুন।
প্রাপক ব্যবসা থেকে মার্কেটিং মেসেজ বন্ধ করার সিদ্ধান্ত নিয়েছেন; Meta বলছে আবার চেষ্টা করবেন না।
ব্যর্থ স্ট্যাটাসে contacts array থাকে না, তাই statuses.id দিয়ে ব্যর্থতাটি মেলান।
Meta কিসের জন্য চার্জ করে: মেসেজ পৌঁছালে বিল হয়, পাঠানো হলে নয়।
ব্যর্থ স্ট্যাটাস দেখতে কেমন?
অন্য যেকোনো স্ট্যাটাসের মতোই, শুধু সঙ্গে errors থাকে। contacts array থাকে না, মেসেজটি ফোন নম্বরে পাঠানো হলে recipient_user_id বাদ যায়, এবং কোনো pricing অবজেক্ট থাকে না। title ও message একই লেখা বহন করে, error_data.details একটি বাক্যে ব্যাখ্যা করে, আর href Meta-র ত্রুটি কোডের তালিকার দিকে নির্দেশ করে। এটি Meta-র নিজের উদাহরণ, যেখানে একটি মার্কেটিং টেমপ্লেট প্রতি-ব্যবহারকারী সীমায় থেমে গেছে:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"statuses": [
{
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0QUQ2MjA4NEYyRkExNjMyREUA",
"status": "failed",
"timestamp": "1751142888",
"recipient_id": "16505551234",
"errors": [
{
"code": 131049,
"title": "This message was not delivered to maintain healthy ecosystem engagement.",
"message": "This message was not delivered to maintain healthy ecosystem engagement.",
"error_data": {
"details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
},
"href": "/documentation/business-messaging/whatsapp/support/error-codes"
}
]
}
]
},
"field": "messages"
}
]
}
]
}কোন ত্রুটি কোডগুলো সবচেয়ে বেশি আসে, আর তাদের অর্থ কী?
Meta ত্রুটি পাঠায় send response-এ, ব্যর্থ স্ট্যাটাসে, অথবা দুই জায়গাতেই, তাই একই কোড যেকোনো উপায়ে আসতে পারে, এবং আপনার হ্যান্ডলারকে দুই জায়গাই পড়তে হবে। যে কোডগুলো বেশিরভাগ মেসেজ পৌঁছাতে ব্যর্থ হওয়ার কারণ ব্যাখ্যা করে, সেগুলো এখানে Meta-র নিজের কারণ ও প্রথমে কী চেষ্টা করবেন সহ দেওয়া হলো; সম্পূর্ণ তালিকা আছে Meta-র ত্রুটি কোড রেফারেন্সে:
প্রতিটি ধরনের ব্যর্থতায় হ্যান্ডলার কীভাবে প্রতিক্রিয়া দেখাবে?
যেকোনো পুনরায় চেষ্টার আগে কোডটিকে পরের ধাপ অনুযায়ী ভাগ করুন। সব ক্ষেত্রে এক রকম পুনরায় চেষ্টা করলে মার্কেটিং অপ্ট-আউট বারবার ব্যর্থতায় পরিণত হয় এবং ব্লক বাড়াতে পারে, অন্যদিকে সাময়িক ত্রুটি বাদ দিলে এমন একটি মেসেজ হারিয়ে যায় যা এক মিনিট পরেই পৌঁছে যেত।
- ব্যাকঅফ সহ পুনরায় চেষ্টা: 131000 অজানা, 131016 সার্ভিস অনুপলব্ধ, 130429 থ্রুপুট সীমা পৌঁছেছে।
- আগে অপেক্ষা করুন: 131049, অন্তত 24 ঘণ্টা, কারণ আগাম পুনরায় চেষ্টা ওই ব্যবহারকারীকে আরও 24 ঘণ্টা পর্যন্ত ব্লক করতে পারে।
- মেসেজ বদলান: 131047-এর জন্য একটি অনুমোদিত টেমপ্লেট লাগে, কারণ 24 ঘণ্টার উইন্ডো বন্ধ।
- এই গ্রাহকের জন্য থামুন: 131050, যতক্ষণ না
user_preferencesresume ইভেন্ট আসে। - অ্যাকাউন্ট বা কনটেন্ট ঠিক করুন: 131042 পেমেন্ট, 131031 অ্যাকাউন্ট সীমাবদ্ধ, 131053 মিডিয়া।
কোন ব্যর্থতা শুধু ব্যর্থ স্ট্যাটাস হিসেবে দেখা যায়?
যেগুলো Meta অনুরোধ গ্রহণের পরে সিদ্ধান্ত নেয়। send অনুরোধে একটি wamid ফেরত আসে, আর প্রত্যাখ্যান আসে পরে এই ওয়েবহুকে। Meta মার্কেটিং টেমপ্লেট যুক্তরাষ্ট্রের ফোন নম্বরের (মার্কিন এলাকা কোডসহ +1) WhatsApp ব্যবহারকারীদের কাছে পৌঁছায় না; যে গ্রাহক মার্কেটিং মেসেজ বন্ধ করেছে তাকে পাঠানো মার্কেটিং টেমপ্লেট প্রক্রিয়া হয়ে 131050 সহ ব্যর্থ বলে জানানো হয়, এবং প্রতি-ব্যবহারকারী মার্কেটিং সীমাও একইভাবে 131049 জানায়।
যদি নম্বরটির কোনো ওয়েবহুক গন্তব্য না থাকে, এই ব্যর্থতাগুলো এমন কোথাও যায় যা আপনি দেখতে পান না, এবং মেসেজটি শুধু পাঠানো হয়েছে বলে মনে হয়। গ্রাহক কিছু না পেলে পূর্ণ যাচাই-ক্রম জানতে দেখুন WhatsApp API messages not delivered পাতাটি।
Coexistence নম্বরে কী বদলায়?
দুটি বিষয় গুরুত্বপূর্ণ। প্রথমত, 24 ঘণ্টার উইন্ডো শুধু API-র ওপর প্রযোজ্য। Meta-র Coexistence গাইড বলে, WhatsApp Business অ্যাপ থেকে পাঠানো মেসেজ গ্রাহক সেবা উইন্ডোর আওতায় পড়ে না, তাই 131047-এর পরেও মালিক ফোন থেকে ওই গ্রাহকের উত্তর দিতে পারেন, আর আপনার সিস্টেম একটি অনুমোদিত টেমপ্লেট পাঠায়।
দ্বিতীয়ত, থ্রুপুট নির্দিষ্ট। একই সময়ে অ্যাপ ও API-তে ব্যবহৃত একটি নম্বর সর্বোচ্চ প্রতি সেকেন্ডে 20টি মেসেজ পাঠায়, এর বেশি গেলে 130429 ফেরত আসে। বাকি সবকিছু যেকোনো Cloud API নম্বরের মতোই: একই ফিল্ড, একই errors array, একই কোড।
স্বয়ংক্রিয়তা এবং আপনার AI একটি ব্যর্থতা কীভাবে দেখে?
এটি নির্ভর করে Meta কখন না বলে তার ওপর। পাঠানোর সময়ে প্রত্যাখ্যান, যেমন 131047, স্বয়ংক্রিয়তার ধাপটিকে ব্যর্থ করে: রানটি Runs ট্যাবে Meta-র বার্তাসহ Failed দেখায়, এবং মালিক একটি ইমেইল পান যাতে তিনি নিজে ওই গ্রাহকের উত্তর দিতে পারেন। স্বয়ংক্রিয়তা ফ্রি টেক্সট উত্তর পাঠানোর আগে উইন্ডো পরীক্ষা করে এবং চেষ্টা না করে window_closed সহ এড়িয়ে যায়।
পরে Meta যে ব্যর্থতা জানায়, তা আপনার Forward URL বা সরাসরি গন্তব্যে একটি ব্যর্থ স্ট্যাটাস হিসেবে আসে, এবং রানটি যেমন ছিল তেমনই থাকে। MCP কানেক্টরের মাধ্যমে টেমপ্লেট পাঠানো একটি AI wamid এবং "sent: true" দেখে; ওই wamid-এর স্ট্যাটাস জানতে আপনার সিস্টেমকে জিজ্ঞাসা করুন, অথবা একসঙ্গে অনেক মেসেজ ব্যর্থ হলে সহকারীকে get_number_health চালাতে বলুন।
সাধারণ ভুলগুলো
- 131050 বারবার পুনরায় চেষ্টা করা। গ্রাহক মার্কেটিং মেসেজ বন্ধ করেছেন, তাই তিনি আবার চালু না করা পর্যন্ত প্রতিটি চেষ্টা একইভাবে ব্যর্থ হবে।
- কয়েক ঘণ্টার মধ্যে 131049 মার্কেটিং টেমপ্লেট আবার পাঠানো। Meta অন্তত 24 ঘণ্টা অপেক্ষা চায়, আর আগাম পুনরায় চেষ্টা ওই ব্যবহারকারীকে আরও 24 ঘণ্টা পর্যন্ত ব্লক করতে পারে।
- শুধু title লগ করা। error_data.details নির্দিষ্ট কারণ বহন করে, তাই code ও details একসঙ্গে wamid-এর সঙ্গে সংরক্ষণ করুন।
- ওয়েবহুক গন্তব্য ছাড়া চালানো এবং send response থেকে ডেলিভারি বিচার করা, যেখানে শুধু বলা হয় Meta মেসেজটি গ্রহণ করেছে।
কোনো স্বয়ংক্রিয়তার উত্তর পাঠানোর সময় প্রত্যাখ্যাত হলে রানটি Meta-র ত্রুটি দেখায় এবং আপনি ইমেইল পান, আর প্রতিটি নম্বর 24/7 সংযোগ বিচ্ছিন্নতা ও মানের পতনের জন্য পর্যবেক্ষণ করা হয়। প্রতি নম্বর প্রতি মাসে US$ 9 থেকে US$ 0.75, নম্বর যোগ করলে কমে যায়, প্রথম 3 দিনের ফ্রি ট্রায়াল সহ।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
Meta কি একটি ব্যর্থ মেসেজের জন্য চার্জ নেয়?
Meta-র প্রাইসিং পাতা বলে, চার্জ নেওয়া হয় পৌঁছানো মেসেজের জন্য, শুধু পাঠানো মেসেজের জন্য নয়। একটি ব্যর্থ স্ট্যাটাসে কোনো pricing অবজেক্ট থাকে না। চার্জ ব্যবসার নিজস্ব WhatsApp Business Account-এ যায়; easyCoexistence কখনো এর ওপর মার্কআপ যোগ করে না।
131026 কি মানে গ্রাহক ব্যবসাকে ব্লক করেছেন?
Meta-র 131026 তালিকা অন্য কারণগুলো উল্লেখ করে: নম্বরটি WhatsApp-এ নেই, প্রাপক সর্বশেষ শর্তাবলী গ্রহণ করেননি, অথবা তার WhatsApp সংস্করণ খুব পুরোনো। Meta পরামর্শ দেয় অন্য মাধ্যমে গ্রাহককে এগুলো যাচাই করতে বলুন।
কিছু ব্যর্থতায় recipient_user_id কেন আসে, কিছুতে আসে না?
ফোন নম্বরে মেসেজ পাঠানো হলে Meta ব্যর্থ স্ট্যাটাসে এটি বাদ দেয়। গ্রাহকের BSUID-তে পাঠালে ব্যর্থতায় এটি থাকে, আর তখন recipient_id বাদ যেতে পারে।
মেসেজ পৌঁছানোর পরেও কি ব্যর্থ হতে পারে?
Meta-র রেফারেন্স failed-কে পাঠাতে বা পৌঁছে দিতে ব্যর্থতা হিসেবে বর্ণনা করে। মেসেজ ডিভাইসে পৌঁছে গেলে পরবর্তী যে স্ট্যাটাস আশা করতে পারেন তা হলো read, অথবা ভয়েস মেসেজের ক্ষেত্রে played।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে