WhatsApp ওয়েবহুক: মেসেজ সরাসরি আপনার সার্ভারে পাঠান

Meta আসলে ওয়েবহুকে কী পাঠায়?

ইভেন্টগুলো বিভিন্ন বিভাগে ভাগ করা থাকে, আর এই পার্থক্যই আপনার আর্কিটেকচার ঠিক করে।

মেসেজ পাথে গ্রাহকের পাঠানো মেসেজ এবং Coexistence নম্বরে WhatsApp Business অ্যাপ থেকে আপনার টিম পাঠানো মেসেজের প্রতিধ্বনি আসে। এগুলো messages এবং smb_message_echoes ফিল্ড, আর কথোপকথনের কনটেন্ট থাকে এগুলোতেই।

অপারেশনাল পাথে বাকি সবকিছু আসে: সংযোগের স্ট্যাটাস বদলালে account_update, কুয়ালিটি বা থ্রুপুট বদলালে phone_number_quality_update, এবং account_alerts, account_review_update, business_capability_update ও phone_number_name_update। এগুলোতে কথোপকথনের কনটেন্ট থাকে না, আর মনিটরিং এগুলো থেকেই তৈরি হয়।

যে প্রোভাইডার মেসেজ পাথে নিজেকে রাখে, সে প্রথম দলটি পায়। যে রাখে না, সে পায় না।

Meta কীভাবে একটি এন্ডপয়েন্ট যাচাই করে?

কিছু ডেলিভার করার আগে একটি GET রিকোয়েস্ট দিয়ে, আর এই যাচাই ব্যর্থ হওয়াই সেটআপ সম্পূর্ণ মনে হলেও মেসেজ না পাওয়ার সবচেয়ে সাধারণ কারণ।

Meta আপনার URL-এ hub.mode-এর মান subscribe, আপনার hub.verify_token এবং একটি hub.challenge মান দিয়ে কল করে। আপনার এন্ডপয়েন্টকে সেই challenge কাঁচা রেসপন্স বডি হিসেবে ফেরত দিতে হবে, JSON-এ মোড়ানো যাবে না এবং এর সঙ্গে কিছু যোগ করা যাবে না। তা না হলে Meta কখনো ডেলিভারি শুরু করে না, আর কোনো ড্যাশবোর্ডেও এর ইঙ্গিত পাওয়া যায় না।

এন্ডপয়েন্টটি HTTPS-ও হতে হবে। যে এন্ডপয়েন্ট নীরবে 404 ফেরত দেয়, অথবা এমন কোনো অথেন্টিকেশন স্তরের পেছনে থাকে যা Meta-কে প্রত্যাখ্যান করে, প্রথম মেসেজ না আসা পর্যন্ত সেটি কাজ করা সেটআপের মতোই দেখায়।

গন্তব্য কি আপনার নিজের সার্ভারে দেওয়া যায়?

হ্যাঁ, আর প্রোভাইডারভেদে পার্থক্যটি এখানেই।

Meta একটি নির্দিষ্ট WhatsApp Business Account-এর ওয়েবহুক কোথায় ডেলিভার হবে, তা একটি অ্যাপ দিয়ে ওভাররাইড করতে দেয়। আমরা সেই ওভাররাইড আপনার URL-এ সেট করি, ফলে মেসেজ পাথের ইভেন্ট আমাদের কলব্যাক থেকে আপনার কাছে চলে যায়। অপারেশনাল ইভেন্টগুলো আমরা রাখি, কারণ ড্যাশবোর্ড ও সতর্কবার্তা এগুলো দিয়েই তৈরি।

এর ফলাফল নীতিগত নয়, আর্কিটেকচারগত। কথোপকথনের কনটেন্ট আমাদের পাশে সংরক্ষণের কোনো সুযোগ নেই, কারণ তা আমাদের কাছে ডেলিভারই হয় না। কোনো অ্যাকাউন্টে ওভাররাইড সেট না থাকলে সেটি আমাদের ডিফল্ট কলব্যাকে ফিরে যায়, যেখানে হ্যান্ডলার ওই ইভেন্টগুলো সংরক্ষণ না করে বাদ দেয়।

একটি নম্বর আবার সংযুক্ত হলে গন্তব্যের কী হয়?

এটি সরিয়ে দেওয়া হয়, অথচ প্রায় কেউই এই ব্যর্থতার জন্য প্রস্তুত থাকে না।

গন্তব্যটি ফোন নম্বরের বৈশিষ্ট্য নয়। এটি WhatsApp Business Account-এ আমাদের অ্যাপের সাবস্ক্রিপশনের ওপর থাকা একটি ওভাররাইড। Meta-র 14 দিনের নিষ্ক্রিয়তার নিয়মে বা অন্য কোনো কারণে সংযোগ সরিয়ে দিলে, সেই অ্যাকাউন্ট থেকে অ্যাপ আনইনস্টল হয় এবং ওভাররাইডও সঙ্গে চলে যায়।

আবার সংযুক্ত করলে পাঠানো এবং মনিটরিং ফিরে আসে। কিন্তু আপনার সার্ভারে ডেলিভারি ফিরে আসে না, আর কোনো ত্রুটিও জানানো হয় না। তাই প্রথম লক্ষণ হতে পারে কোনো গ্রাহকের বলা যে কেউ উত্তর দেয়নি। প্রতিবার আবার সংযুক্ত হলে আমরা ওভাররাইড প্রয়োগ করি, কারণ একটি বাস্তব নম্বর পরিষ্কারভাবে আবার সংযুক্ত হওয়ার পরও এমন নীরব হয়ে গিয়েছিল।

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

• যাচাইকরণ GET থেকে JSON ফেরত দেওয়া। Meta শুধু কাঁচা hub.challenge মান চায়, আর কিছু নয়।
• সাময়িক বা টেস্ট URL ব্যবহার করা। যে টুল এটি তৈরি করেছে, সেটি শোনা বন্ধ করার পরও Meta সেখানে ডেলিভারি চালিয়ে যায়।
• আবার সংযোগের পর গন্তব্য থেকে যাবে ধরে নেওয়া। এটি একটি অ্যাপ সাবস্ক্রিপশনে থাকে এবং সেটির সঙ্গে আনইনস্টল হয়।
• Meta-র রিকোয়েস্ট প্রত্যাখ্যান করে এমন অথেন্টিকেশনের পেছনে এন্ডপয়েন্ট রাখা।

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

আরও পড়ুন