WhatsApp ওয়েবহুক ফিল্ড, কোনটি কোথায় যায়
WhatsApp Business Account নামযুক্ত ফিল্ড হিসেবে ইভেন্ট পাঠায়। দুটি ফিল্ডে কথোপকথনের বিষয়বস্তু থাকে এবং সেগুলো আপনার এন্ডপয়েন্টে যায়। ছয়টি ফিল্ডে অপারেশনাল স্ট্যাটাস থাকে, যেগুলো দিয়ে মনিটরিং তৈরি হয়। কোনটি কী, তা জানা থাকলেই আর্কিটেকচার ঠিক করা যায়।
- দুটি মেসেজ ফিল্ড, ছয়টি অপারেশনাল ফিল্ড
- রাউটিং অ্যাকাউন্টভিত্তিক সেট করা হয়
- সাধারণ পেলোড নয়, নামযুক্ত ফিল্ড
7 দিন কোনও চার্জ নেই। যেকোনও সময় বাতিল করুন।
মেসেজ পথের ফিল্ড: messages এবং smb_message_echoes।
মনিটরিংয়ের জন্য অপারেশনাল ফিল্ডগুলো রাখা হয়।
WhatsApp Business Account অনুযায়ী ওভাররাইড করা যায়, যা দুটির বিভাজন নির্ধারণ করে।
প্রতিটি ফিল্ড কী বহন করে?
messages নম্বরে গ্রাহক যা পাঠান, তার সবকিছু বহন করে: টেক্সট, মিডিয়ার রেফারেন্স, রিপ্লাই এবং রিঅ্যাকশন। smb_message_echoes WhatsApp Business অ্যাপ থেকে আপনার টিম যা পাঠায়, তা বহন করে। এটি শুধু Coexistence নম্বরে থাকে এবং সফটওয়্যারকে মানুষের রিপ্লাই দেখতে দেয়।
account_update সংযোগের স্ট্যাটাস বহন করে: অ্যাকাউন্ট থেকে অ্যাপ আনইনস্টল হলে PARTNER_REMOVED, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED, এবং রেস্ট্রিকশন বা ভায়োলেশনের ইভেন্ট। phone_number_quality_update কোয়ালিটি রেটিং ও থ্রুপুটের পরিবর্তন বহন করে। account_alerts অ্যাকাউন্টের বিরুদ্ধে Meta যে সতর্কবার্তা দেয়, তা বহন করে, আর account_review_update রিভিউয়ের ফল বহন করে।
business_capability_update মেসেজিং সীমা ও সক্ষমতার পরিবর্তন বহন করে, আর phone_number_name_update ডিসপ্লে নামের অনুমোদন ও প্রত্যাখ্যান বহন করে।
আর্কিটেকচারে এই বিভাজন গুরুত্বপূর্ণ কেন?
কারণ এর ওপর নির্ভর করে কথোপকথনের বিষয়বস্তু কখনো কোনো প্রোভাইডারের কাছে পৌঁছাবে কি না।
ওভাররাইড দুটি মেসেজ ফিল্ড Meta থেকে সরাসরি আপনার এন্ডপয়েন্টে পাঠায়। ছয়টি অপারেশনাল ফিল্ড প্রোভাইডারের কাছে যেতে থাকে, যার ফলে কেউ মেসেজ ধরে না রেখেও ড্যাশবোর্ড ও সতর্কবার্তা ব্যবস্থা চালানো যায়।
এই কারণেই মেসেজ সংরক্ষণ না করার দাবি শুধু নীতির বিষয় নয়, কাঠামোগতও হতে পারে। মেসেজ ফিল্ড অন্যত্র পাঠানো হলে সেগুলো সংরক্ষণ করার কোনো কোড পথ থাকে না। আমাদের ক্ষেত্রে, ওভাররাইড না থাকা অ্যাকাউন্ট ডিফল্ট কলব্যাকে ফলব্যাক করে, যেখানে হ্যান্ডলার ওই ইভেন্টগুলো পারসিস্ট না করেই বাদ দেয়।
আপনার হ্যান্ডলার কোন ফিল্ড প্রত্যাশা করবে?
ওভাররাইড সেট করা থাকলে শুধু দুটি মেসেজ ফিল্ড প্রত্যাশা করুন। অন্য কিছু এলে ব্যর্থ হওয়ার বদলে তা উপেক্ষা করার জন্য হ্যান্ডলার লেখা ভালো।
Meta সময়ের সঙ্গে নতুন ফিল্ড যোগ করে, তাই পেলোডের গঠনে কোনো নোটিশ ছাড়াই নতুন কী যোগ হতে পারে। যে হ্যান্ডলার ফিল্ডের নাম দেখে কাজ বেছে নেয় এবং অপরিচিত ফিল্ড উপেক্ষা করে, সেটি কাজ চালিয়ে যায়। আর যে নির্দিষ্ট গঠন ধরে নেয়, সেটি প্রথম অপরিচিত ইভেন্টেই ত্রুটি দেয়।
smb_message_echoes-কে স্পষ্টভাবে পরিচালনা করাও ভালো, একে আওয়াজ ভেবে উপেক্ষা না করে। এটি না থাকলে কোনো মানুষ আগেই উত্তর দিয়েছেন কি না, সফটওয়্যার বুঝতে পারে না। ফলে একই প্রশ্নের জন্য গ্রাহক দুটি রিপ্লাই পেতে পারেন।
সাধারণ ভুলগুলো
- সাধারণ পেলোড ধরে নেওয়া। প্রতিটি ইভেন্টে তার ফিল্ডের নাম থাকে, তাই হ্যান্ডলারের সেটি দেখে কাজ বেছে নেওয়া উচিত।
- smb_message_echoes উপেক্ষা করা। এটি না থাকলে মানুষ আগে উত্তর দেওয়ার পরও সফটওয়্যার তার ওপর নতুন রিপ্লাই পাঠায়।
- অপরিচিত ফিল্ড বাদ না দিয়ে ত্রুটি দেওয়া। Meta কোনো অনুমতি না নিয়েই নতুন ফিল্ড যোগ করে।
EasyCoexistence মনিটরিংয়ের জন্য অপারেশনাল ফিল্ডগুলোতে সাবস্ক্রাইব করে এবং দুটি মেসেজ ফিল্ড আপনার এন্ডপয়েন্টে পাঠায়। সেটি না থাকলে পারসিস্ট না করেই বাদ দেয়।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
আমি কি শুধু কিছু ফিল্ড পেতে পারি?
ওভাররাইড মেসেজের পথটি আপনার কাছে সরিয়ে দেয়। অপারেশনাল বিভাজন নির্দিষ্ট, কারণ মনিটরিং এটি দিয়েই তৈরি হয়।
smb_message_echoes কি সাধারণ Cloud API নম্বরে থাকে?
না। Coexistence নম্বর থেকে মানুষ অ্যাপে এবং সফটওয়্যার API থেকে মেসেজ পাঠাতে পারে বলেই এটি থাকে।
কোনো গন্তব্য সেট না করলে মেসেজ ইভেন্টের কী হয়?
সেগুলো আমাদের ডিফল্ট কলব্যাকে আসে এবং পারসিস্ট না করেই বাদ পড়ে।
ফিল্ডের নামগুলো কি Meta-র, নাকি আপনাদের?
Meta-র। এখানে আমাদের বানানো কোনো নাম নেই, তাই একবার শিখে নেওয়া মূল্যবান।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুন7 দিন কোনও চার্জ নেই। যেকোনও সময় বাতিল করুন।যাচাই করা হয়েছে