messages ওয়েবহুক
messages হলো সেই ফিল্ড, যা আপনার নম্বরে গ্রাহকের পাঠানো টেক্সট, মিডিয়া, উত্তর, প্রতিক্রিয়া ও ইন্টার্যাকটিভ প্রতিক্রিয়া বহন করে। রাউট করা Coexistence নম্বরে এটি Meta থেকে সরাসরি আপনার এন্ডপয়েন্টে যায়, কোনো প্রোভাইডারের মধ্য দিয়ে নয়।
গ্রাহকের পাঠানো মেসেজ বহনকারী ওয়েবহুক ফিল্ড।
রিট্রাই শনাক্ত করতে ব্যবহৃত মেসেজ আইডির প্রিফিক্স।
কোনো প্রসেসিংয়ের আগে Meta দ্রুত যে স্ট্যাটাস আশা করে।
পেলোডে কী থাকে
একটি ডেলিভারিতে এক বা একাধিক মেসেজ থাকতে পারে। প্রতিটিতে প্রেরক, একটি আইডি এবং একটি টাইপ থাকে। টাইপ অনুযায়ী অন্য কোন কী থাকবে তা নির্ধারিত হয়।
- প্রেরকের ফোন নম্বর এবং যে নম্বরে তারা লিখেছেন সেই নম্বরের phone_number_id।
- wamid মেসেজ আইডি, যার ভিত্তিতেই ডুপ্লিকেট শনাক্ত করা হয়।
- একটি unix টাইমস্ট্যাম্প।
- একটি টাইপ: text, image, audio, video, document, sticker, location, contacts, reaction, button অথবা interactive।
- মিডিয়া টাইপের ক্ষেত্রে আসল বাইট নয়, ডাউনলোডের জন্য একটি মিডিয়া আইডি থাকে।
রাউট করা নম্বরে এটি কখনো আমাদের কাছে পৌঁছায় না কেন
কারণ override এই ফিল্ডটিকে smb_message_echoes-এর সঙ্গে আপনার নির্ধারিত গন্তব্যে পাঠায়।
Meta কোনো WhatsApp Business Account-এর ওয়েবহুক কোথায় ডেলিভার হবে, তা অ্যাপকে বদলানোর সুযোগ দেয়। আমরা সেই override আপনার URL-এ সেট করি, ফলে মেসেজের পথ পুরোপুরি আমাদের অবকাঠামোর বাইরে চলে যায়। আমাদের পাশে কোনো কপি, কিউ বা সংরক্ষণ থাকে না, কারণ ডেলিভারি সেখানে পৌঁছায়ই না।
কোনো গন্তব্য সেট না থাকলে ইভেন্টগুলো আমাদের ডিফল্ট কলব্যাকে ফলব্যাক করে, যেখানে হ্যান্ডলার সেগুলো সংরক্ষণ না করে বাদ দেয়। স্টোরেজ নিয়ে দাবি আর বাস্তব কোডপাথের মধ্যে এটাই পার্থক্য: কথোপকথনের কনটেন্ট যাওয়ার কোনো পথ নেই।
সঠিকভাবে স্বীকৃতি দেওয়া
কাজ শুরু করার আগে 200 ফেরত দিন, পরে নয়।
Meta ধীর প্রতিক্রিয়াকে ত্রুটি হিসেবে ধরে এবং রিট্রাই করে। ফলে ইনলাইন প্রসেস করা হ্যান্ডলার একই মেসেজ একাধিকবার পেতে পারে। সঙ্গে সঙ্গে প্রতিক্রিয়া দিন, পেলোডটি কোনো কিউ বা ব্যাকগ্রাউন্ড টাস্কে পাঠান, এবং রিকোয়েস্টের বাইরে কাজটি হতে দিন।
সার্ভারলেস ব্যবস্থায় এটি ঐচ্ছিক নয়। কোনো ফাংশন প্রতিক্রিয়া দেওয়ার পরও কাজ চালিয়ে গেলে সেটি সেই মুহূর্তে ফ্রিজ হতে পারে। তাই স্বীকৃতি ও প্রসেসিং সত্যিই আলাদা হতে হবে।
ডুপ্লিকেট বাদ দেওয়া
সবসময় wamid ব্যবহার করুন, কারণ রিট্রাই অস্বাভাবিক নয়, স্বাভাবিক ঘটনা।
আপনার দিকের কোনো বাগ ছাড়াও একই মেসেজ দুবার আসতে পারে: ধীর প্রতিক্রিয়া, নেটওয়ার্ক টাইমআউট বা ডেলিভারির মাঝখানে ডিপ্লয়। দেখা আইডি সংরক্ষণ করে পুনরাবৃত্তি বাদ দেওয়া কয়েক লাইনের কাজ। এতে গ্রাহককে একবার উত্তর দেওয়া হবে, দুবার নয়।
Coexistence নম্বরে এটি আরও গুরুত্বপূর্ণ, কারণ smb_message_echoes একই পথে আসে। প্রতিটি ইভেন্টকে নতুন ধরে নেওয়া হ্যান্ডলার এমন একজন মানুষের উত্তরের ওপর আবার উত্তর পাঠাতে পারে, যিনি ইতিমধ্যে উত্তর দিয়েছেন।
সাধারণ ভুলগুলো
- 200 ফেরত দেওয়ার আগে প্রসেস করা। Meta ধীর প্রতিক্রিয়ায় রিট্রাই করে, ফলে মেসেজটি দুবার হ্যান্ডেল হয়।
- ডুপ্লিকেট শনাক্তকরণ বাদ দেওয়া। রিট্রাই নকশার অংশ, বিরল ব্যতিক্রম নয়।
- পেলোডে মিডিয়ার বাইট আশা করা। এতে ডাউনলোডের জন্য মিডিয়া আইডি থাকে।
EasyCoexistence এই ফিল্ডটি Meta থেকে সরাসরি আপনার এন্ডপয়েন্টে রাউট করে এবং মনিটরিংয়ের জন্য প্রয়োজনীয় অপারেশনাল ইভেন্টগুলোই রাখে। তাই কথোপকথনের কনটেন্ট আমাদের স্টোরেজে যাওয়ার কোনো পথ পায় না।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
EasyCoexistence কি আমার গ্রাহকদের মেসেজ দেখতে পায়?
না। override এই ফিল্ডটি আপনার এন্ডপয়েন্টে পাঠায়। আমাদের ফলব্যাক কলব্যাকে পৌঁছানো যেকোনো কিছু সংরক্ষণ না করে বাদ দেওয়া হয়।
একটি রিকোয়েস্টে কি একাধিক মেসেজ আসতে পারে?
হ্যাঁ। একটি ডেলিভারিতে একাধিক মেসেজ থাকতে পারে। তাই হ্যান্ডলারকে প্রথমটি পড়ে থামার বদলে সবগুলোতে ইটারেট করা উচিত।
মিডিয়া কীভাবে পাব?
পেলোডে একটি মিডিয়া আইডি থাকে। নম্বরের অ্যাক্সেস টোকেন ব্যবহার করে সেটি দিয়ে URL আনুন, তারপর ডাউনলোড করুন।
smb_message_echoes কী?
এটি সহায়ক ফিল্ড, যা আপনার টিম WhatsApp Business অ্যাপ থেকে পাঠানো কনটেন্ট বহন করে। এটি শুধু Coexistence নম্বরে থাকে।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে