লগ ইনফ্রি ট্রায়াল শুরু করুন
Meta Tech Provider

WhatsApp API মেসেজ পৌঁছায়নি: কারণগুলো, ক্রম অনুযায়ী

একটি গৃহীত WhatsApp API মেসেজ মানেই ডেলিভারি হওয়া মেসেজ নয়: Meta ফলাফল পরে স্ট্যাটাস ওয়েবহুকের মাধ্যমে জানায়, sent, delivered, read বা failed, সঙ্গে একটি ত্রুটির কোড। ক্রম অনুযায়ী দেখুন: failed স্ট্যাটাস ও তার কোড, 24 ঘণ্টার উইন্ডো (131047), পেমেন্ট পদ্ধতি (131042), টেমপ্লেট (132001, 132015), প্রাপক (131026, 131049, 131050), তারপর নম্বরের সীমা ও সংযোগ।

easyCoexistence প্রতিটি সংযুক্ত নম্বর সারাক্ষণ পর্যবেক্ষণ করে, Meta ডেলিভারি বন্ধ করলে, সংযোগ ছিঁড়লে বা কোয়ালিটি কমলে আপনাকে ইমেইল পাঠায়, এবং Meta-র স্ট্যাটাস ওয়েবহুক অপরিবর্তিতভাবে আপনার সিস্টেমে ফরওয়ার্ড করে।

4 statuses

স্ট্যাটাস ওয়েবহুকে যেভাবে জানানো হয়: sent (এক টিক), delivered (দুই টিক), read (দুই নীল টিক) এবং failed (লাল ত্রুটির ত্রিভুজ)।

131047

প্রাপক শেষবার উত্তর দেওয়ার পর 24 ঘণ্টার বেশি পার হয়ে গেছে; Meta বলে এর বদলে একটি টেমপ্লেট পাঠাতে।

131026

ডেলিভার করা যায়নি: নম্বরটি WhatsApp-এ নেই, প্রাপক নতুন শর্তাবলি গ্রহণ করেননি, বা পুরোনো WhatsApp সংস্করণ চালাচ্ছেন।

30 days

ইউটিলিটি বা মার্কেটিং টেমপ্লেট ডেলিভার না হলে বাতিল করার আগে WhatsApp-এর ডিফল্ট পুনরায় চেষ্টার সময়; অথেন্টিকেশন টেমপ্লেটের ডিফল্ট 10 মিনিট।

20 mps

WhatsApp Business অ্যাপ ও Cloud API দুটোতেই ব্যবহৃত একটি নম্বরের স্থির থ্রুপুট।

কেন গৃহীত মেসেজটিও পৌঁছায় না?

কারণ API-র উত্তর ও ডেলিভারি দুটি আলাদা ঘটনা। আপনি পাঠালে Meta অনুরোধ গ্রহণ করামাত্র একটি মেসেজ আইডি ফেরত দেয়; মেসেজটি গ্রাহকের ফোনে পৌঁছায় কি না, তা পরে messages ফিল্ডের স্ট্যাটাস ওয়েবহুকে জানানো হয়। sent মানে মেসেজটি Meta-র সার্ভার ছেড়ে গেছে (এক টিক), delivered মানে ডিভাইসে পৌঁছেছে (দুই টিক), read মানে খোলা হয়েছে (দুই নীল টিক), আর failed মানে পাঠানো বা ডেলিভার করা যায়নি, যা আপনাকে errors অ্যারেতে দেখানো হয়: code, title এবং error_data.details। তাই প্রথম কাজ কখনো অনুমান করা নয়: ওই মেসেজ আইডির failed স্ট্যাটাস খুঁজে তার কোডটি পড়ুন। আপনার কোনো ওয়েবহুক গন্তব্য না থাকলে কিছুই রেকর্ড হয় না।

কারণগুলো কী, পরীক্ষার ক্রমে?

নতুন সংযুক্ত নম্বরে সবচেয়ে সাধারণ কারণ থেকে সবচেয়ে বিরল কারণ পর্যন্ত। প্রতিটি লাইনে Meta-র কোড উল্লেখ আছে, তাই failed স্ট্যাটাস দেখে বোঝা যাবে আপনি কোনটিতে আছেন:

  • উইন্ডো বন্ধ: 131047, গ্রাহক শেষবার লেখার পর 24 ঘণ্টার বেশি। ফ্রি-ফর্ম মেসেজে উইন্ডো খোলা থাকতে হয়; একটি টেমপ্লেট পাঠান।
  • পেমেন্ট: 131042, অথবা টেমপ্লেট নীরবে বাতিল। 1 অক্টোবর 2026 থেকে পেমেন্ট পদ্ধতি ছাড়া মাসে 1,000টি ব্যবহারের পর সার্ভিস মেসেজও বন্ধ হয়।
  • টেমপ্লেট: 132001 অনুমোদিত নয় বা ভুল ভাষা, 132000 ভেরিয়েবলের সংখ্যা ভুল, 132012 ভুল ফরম্যাট, 132015 স্থগিত, 132016 নিষ্ক্রিয়।
  • প্রাপক: 131026 WhatsApp-এ নেই, পুরোনো সংস্করণ বা শর্তাবলি গ্রহণ করা হয়নি; 131050 মার্কেটিং মেসেজ বন্ধ করেছেন; 131049 সুস্থ এনগেজমেন্টের জন্য আটকে রাখা; US নম্বরে মার্কেটিং টেমপ্লেট ডেলিভার হয় না।
  • সীমা: 131048 স্প্যাম সংকেতের পর সীমাবদ্ধ, 131056 একজনের কাছে অনেক মেসেজ, 130429 থ্রুপুট, Coexistence নম্বরে সেকেন্ডে 20টি মেসেজ।
  • অ্যাকাউন্ট: 131031 বা 368, নীতিমালা লঙ্ঘনের কারণে WhatsApp Business Account সীমাবদ্ধ বা নিষ্ক্রিয়।
  • সংযোগ: নম্বরটি আর যুক্ত নেই, যেমন 14 দিন WhatsApp Business অ্যাপ না খোলার পর।

প্রাপকের দিকের কোডগুলো কীভাবে সামলাবেন?

আলাদাভাবে, কারণ কিছুতে পুনরায় চেষ্টা করা উচিত, আর কিছুতে কখনোই নয়। 131050 মানে ব্যক্তিটি আপনার মার্কেটিং মেসেজ বন্ধ করার সিদ্ধান্ত নিয়েছেন: Meta বলে আর চেষ্টা না করতে, আর user_preferences ওয়েবহুক জানায় কখন তারা বন্ধ বা চালু করেন। 131049 মানে Meta সুস্থ এনগেজমেন্ট রাখতে একটি মার্কেটিং মেসেজ আটকে রাখছে, প্রায়ই মার্কেটিং টেমপ্লেটে প্রতি-ব্যবহারকারী সীমার কারণে: Meta পুনরায় পাঠানোর আগে কমপক্ষে 24 ঘণ্টা অপেক্ষার পরামর্শ দেয়, কারণ আগে পাঠালে একই ত্রুটি ফিরে আসে। 131026 এমন নম্বরের জন্য, যেগুলো WhatsApp-এ নেই, যারা WhatsApp-এর বর্তমান শর্তাবলি গ্রহণ করেননি এবং অতি পুরোনো অ্যাপ সংস্করণের জন্য; আগে নম্বরের ফরম্যাট ও দেশের কোড যাচাই করুন, তারপর অন্য চ্যানেলে গ্রাহককে জিজ্ঞাসা করুন।

WhatsApp কতক্ষণ ডেলিভারির চেষ্টা চালায়?

মেসেজের টাইম টু লিভ (TTL) পর্যন্ত। ফোন বন্ধ বা নেটওয়ার্কের বাইরে থাকলে WhatsApp তাৎক্ষণিক ব্যর্থ না হয়ে আবার চেষ্টা করে: ডিফল্টভাবে ইউটিলিটি ও মার্কেটিং টেমপ্লেটের জন্য 30 দিন, আর অথেন্টিকেশন টেমপ্লেটের জন্য 10 মিনিট। প্রতি টেমপ্লেটে message_send_ttl_seconds দিয়ে এটি কমানো যায়: ইউটিলিটির জন্য 30 সেকেন্ড থেকে 12 ঘণ্টা, আর অথেন্টিকেশনের জন্য 30 সেকেন্ড থেকে 15 মিনিট। TTL-এর মধ্যে ডেলিভার না হওয়া মেসেজ বাতিল হয়ে যায়। তাই কয়েক ঘণ্টা পরও যদি sent স্ট্যাটাস থাকে কিন্তু delivered না থাকে, সাধারণত মেসেজটি গ্রাহকের ফোনে অপেক্ষা করছে, হারিয়ে যায়নি; কোড ও সময়-সংবেদনশীল সতর্কবার্তায় ছোট TTL সেট করুন, যাতে দেরিতে ডেলিভারি কাউকে বিভ্রান্ত না করে।

AI উত্তর ও অটোমেশনের জন্য এর মানে কী?

আগে রান, তারপর স্ট্যাটাস পড়ুন। Runs ট্যাবে একটি Skipped রান কিছুই পাঠায়নি এবং কারণ বলে: “More than 24 hours since the customer's last message”, “You answered this chat from your phone recently” বা “AI reply limit for this chat reached this hour”। একটি Done রান মানে Meta প্রতিটি উত্তর গ্রহণ করেছে, যা ডেলিভারির প্রমাণ নয়। easyCoexistence মেসেজের স্ট্যাটাস সংরক্ষণ করে না: অটোমেশন চালু থাকলে এবং আপনি একটি forward URL সেট করলে সেখানে যায়, আর ডাইরেক্ট মোডে সরাসরি আপনার নিজের এন্ডপয়েন্টে যায়। ChatGPT বা Claude থেকে আপনার AI-কে get_number_health চালাতে বলুন: এটি লাইভ স্ট্যাটাস, কোয়ালিটি রেটিং এবং শেষ 15টি মনিটরিং ইভেন্ট ফেরত দেয়, যার মধ্যে Meta-র কোডসহ একটি sending ব্লক থাকে।

কীভাবে সেট আপ করবেন

  1. Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.

সাধারণ ভুলগুলো

  • 131050-এ আবার চেষ্টা করা। ব্যক্তিটি আপনার কাছ থেকে মার্কেটিং মেসেজ বন্ধ করেছেন: আর চেষ্টা করলে আর ডেলিভার হবে না এবং শুধু নেতিবাচক সংকেত বাড়বে।
  • মেসেজ আইডিকে ডেলিভার হওয়া ধরে নেওয়া। Meta আগে গ্রহণ করে এবং ব্যর্থতা পরে জানায়, তাই যে অটোমেশন আইডিতে থেমে যায় সে প্রতিটি প্রত্যাখ্যাত মেসেজ মিস করে।
  • এক দিন পরে ফ্রি-ফর্ম উত্তর পাঠানো। গ্রাহকের মেসেজ ছাড়া 24 ঘণ্টা পার হলে শুধু টেমপ্লেট গ্রহণ করা হয়।
  • ওয়েবহুক গন্তব্য ছাড়া চালানো। ব্যর্থ স্ট্যাটাস শুধু ওয়েবহুকের মাধ্যমে আসে, তাই একটি ছাড়া মেসেজ কেন পৌঁছায়নি তার কারণ হারিয়ে যায়।
EasyCoexistence দিয়ে এটি করা

আপনার AI ChatGPT বা Claude থেকে get_number_health দিয়ে একটি নম্বর যাচাই করতে পারে। প্রতি নম্বর প্রতি মাসে US$ 9 থেকে US$ 0.75, নম্বর যোগ করলে কমে, প্রথম 3 দিন বিনামূল্যে।

প্রায়শই জিজ্ঞাসিত প্রশ্ন

কেন মেসেজ কয়েক ঘণ্টা এক টিক দেখাল?

এক টিক হলো sent স্ট্যাটাস: Meta পাঠিয়েছে, কিন্তু ফোন এখনো পায়নি, সাধারণত ফোন বন্ধ বা অফলাইন থাকার কারণে। টেমপ্লেটের টাইম টু লিভ শেষ না হওয়া পর্যন্ত WhatsApp চেষ্টা চালায়: ইউটিলিটি ও মার্কেটিংয়ে ডিফল্টভাবে 30 দিন।

উত্তর আসে কিন্তু টেমপ্লেট আসে না কেন?

সাধারণত WhatsApp Business Account-এর পেমেন্ট পদ্ধতির সমস্যা। পেমেন্ট পদ্ধতি ছাড়াও Meta নম্বরের মাসিক বিনামূল্যের সীমার মধ্যে সার্ভিস মেসেজ ডেলিভার করে, কিন্তু টেমপ্লেট ডেলিভার করে না। Billing & payments-এ একটি কার্ড যোগ করুন।

WhatsApp Business অ্যাপে কি ব্যর্থ মেসেজ দেখা যায়?

নির্ভরযোগ্যভাবে নয়। একটি Coexistence নম্বরে API-র মাধ্যমে পাঠানো মেসেজ অ্যাপের চ্যাট থ্রেডে দেখা যায়, কিন্তু মেসেজ কেন ব্যর্থ হলো তার কারণ শুধু স্ট্যাটাস ওয়েবহুকের ত্রুটির কোডে পাওয়া যায়।

ডেলিভার না হওয়া মেসেজের জন্য কি Meta চার্জ করে?

না। Meta শুধু ডেলিভার হওয়া মেসেজের জন্য চার্জ করে, আর পজ করা টেমপ্লেটের চেষ্টাও চার্জ হয় না।

আরও পড়ুন

কেন একটি WhatsApp মেসেজ ব্যর্থ হলো: ব্যর্থ স্ট্যাটাস ও তার ত্রুটি পড়াব্যর্থ স্ট্যাটাস মানে Meta আপনার WhatsApp মেসেজ পাঠাতে বা পৌঁছে দিতে পারেনি। errors array ও সাধারণ কোড কীভাবে পড়বেন, জানুন।WhatsApp ওয়েবহুক স্ট্যাটাস: sent, delivered, read এবং failedWhatsApp কীভাবে আপনার পাঠানো মেসেজের অবস্থা জানায়: statuses array, প্রতিটি স্ট্যাটাস মান, প্রতিটি ফিল্ড এবং wamid।আপনার WhatsApp Business Account-এ পেমেন্ট মেথড যোগ করুন, নইলে সার্ভিস মেসেজ বন্ধ হয়ে যাবেপেমেন্ট মেথড ছাড়া Meta টেমপ্লেট পাঠায় না, আর মাসের 1,000 ফ্রি সার্ভিস মেসেজ শেষ হলে সেগুলোও বন্ধ। কীভাবে যোগ ও যাচাই করবেন, জানুন।WhatsApp টেমপ্লেট স্থগিত বা নিষ্ক্রিয় হলে: কী করবেনকম কোয়ালিটির WhatsApp টেমপ্লেট 3 ঘণ্টা, তারপর 6 ঘণ্টা স্থগিত হয়, এরপর নিষ্ক্রিয়। কী করবেন, কীভাবে আবার চালু করবেন এবং পরের ধাপগুলো জানুন।WhatsApp Business নম্বর সীমিত বা ব্যান: কীভাবে রিভিউয়ের অনুরোধ করবেনMeta যেখানে WhatsApp সীমাবদ্ধতা বা ব্যান দেখায়, কীভাবে Request Review ক্লিক করবেন, আপিলের আগে কী ঠিক করবেন ও কত সময় লাগে।WhatsApp Cloud API ত্রুটির কোডএকটি টেবিলে সব WhatsApp Cloud API ত্রুটির কোড, অর্থ, পুনরায় পাঠালে লাভ হবে কি না এবং পূর্ণ ব্যাখ্যার পেজ।

শুরু করতে প্রস্তুত?

মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।

ফ্রি ট্রায়াল শুরু করুন

যাচাই করা হয়েছে