WhatsApp user_preferences ওয়েবহুক: গ্রাহক কখন মার্কেটিং মেসেজ বন্ধ বা আবার চালু করেন
user_preferences ওয়েবহুক জানায় যে একজন WhatsApp ব্যবহারকারী Offers and announcements সেটিংসের মাধ্যমে মার্কেটিং মেসেজ বন্ধ বা আবার চালু করেছেন। প্রতিটি ইভেন্টে থাকে category marketing_messages, মান stop বা resume, একটি বিবরণ বাক্য, ব্যবহারকারীর wa_id ও BSUID, এবং একটি Unix টাইমস্ট্যাম্প। একই সেটিংসে Interested ও Not interested মতামত এই ওয়েবহুক চালু করে না।
easyCoexistence আপনার WhatsApp Business অ্যাপের নম্বরটিকে Coexistence-এর মাধ্যমে Meta-র Cloud API-এর সঙ্গে যুক্ত করে, তাই আপনার AI ও অটোমেশন অ্যাপে রাখা নম্বরেই কাজ করে।
একটি পছন্দের মান হতে পারে: stop ও resume, দুটোই marketing_messages ক্যাটাগরিতে।
একজন ব্যবহারকারীর কাছে মার্কেটিং টেমপ্লেট পাঠানো হলে, যিনি আপনার মার্কেটিং মেসেজ বন্ধ করেছেন, সেই ব্যর্থ স্ট্যাটাসের কোড।
Meta কোথায় user_preferences পাঠায়: এটি এমন ফিল্ড, যা কোনো WhatsApp Business Account বা নম্বর ওভাররাইড করতে পারে না।
messages ও calls ছাড়া অন্য ওয়েবহুকের জন্য অ্যাপের যে অনুমতি লাগে, user_preferences সহ।
user_preferences ওয়েবহুক কী কারণে চালু হয়?
একজন গ্রাহক WhatsApp-এ Offers and announcements খুলে আপনার ব্যবসার মার্কেটিং মেসেজ বন্ধ করেন, বা পরে আবার চালু করেন। এই দুটি কাজই একমাত্র ট্রিগার। একই সেটিংসে গ্রাহক Interested বা Not interested চিহ্নিত করতে পারেন, এবং সেই মতামত কোনো ওয়েবহুক পাঠায় না। যদিও Not interested সেই গ্রাহকের সঙ্গে আপনার প্রতি-ব্যবহারকারী মার্কেটিং সীমা কমাতে পারে, এবং একটি দ্বিতীয় স্ক্রিন খোলে, যেখানে সব মার্কেটিং মেসেজ বন্ধের প্রস্তাব থাকে। শুধু তখনই user_preferences চালু হয়, যদি তারা এরপর বন্ধ করতে ট্যাপ করেন।
পেলোডে কী থাকে?
user_preferences ফিল্ড নামের অধীনে, contacts অ্যারের পাশে একটি user_preferences অ্যারে থাকে। এখানে timestamp একটি পূর্ণসংখ্যা, অথচ স্ট্যাটাস ওয়েবহুক সেটি স্ট্রিং হিসেবে পাঠায়। গ্রাহক username ব্যবহার করলে এবং ফোন নম্বর শেয়ার করা না গেলে wa_id বাদ পড়ে; ব্যবসা-স্কোপড ইউজার আইডি চালু না থাকলে user_id বাদ পড়ে; প্যারেন্ট BSUID চালু না থাকলে parent_user_id বাদ পড়ে। Meta-র একটি resume-এর উদাহরণ:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"contacts": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824"
}
],
"user_preferences": [
{
"wa_id": "16505551234",
"user_id": "US.13491208655302741918",
"parent_user_id": "US.ENT.506847293015824",
"detail": "User requested to resume marketing messages",
"category": "marketing_messages",
"value": "resume",
"timestamp": 1731705721
}
]
},
"field": "user_preferences"
}
]
}
]
}একটি stop এলে আপনার সিস্টেম কী করবে?
গ্রাহকের বিপরীতে তা রেখে দিন, এবং resume না আসা পর্যন্ত প্রতিটি মার্কেটিং পাঠানো থেকে তাকে বাদ দিন। detail ফিল্ড হয় "User requested to stop marketing messages" বা "User requested to resume marketing messages" লেখা থাকে, তবে কোডের পড়া উচিত value।
- BSUID ও ফোন নম্বর, দুটো দিয়েই পছন্দটি সংরক্ষণ করুন, কারণ কোনো ইভেন্টে যেকোনো একটি না থাকতে পারে।
- মার্কেটিং টেমপ্লেট পাঠানো থেকে গ্রাহককে বাদ দিন; এমনিতেও Meta 131050 দিয়ে সেগুলো প্রত্যাখ্যান করবে।
- প্রতিটি গ্রাহকের জন্য আলাদাভাবে প্রয়োগ করুন: Meta কখনো প্যারেন্ট BSUID স্তরে পছন্দ প্রয়োগ করে না।
- resume এলে বাদ দেওয়াটি তুলে নিন, এবং Meta-র opt-in নীতি যেমন চায়, আপনার নিজস্ব opt-in রেকর্ডটি রাখুন।
user_preferences যদি কখনো আপনার সার্ভারে না পৌঁছায়?
Meta তবুও stop কার্যকর করে, তাই ওয়েবহুক হারালে আপনার একটি ব্যর্থ পাঠানো হয়, নীতি লঙ্ঘন হয় না। যখন বন্ধ করা কাউকে মার্কেটিং টেমপ্লেট পাঠান, API রিকোয়েস্টটি গ্রহণ করে, মেসেজটি পাঠায় না, এবং একটি status ওয়েবহুক পাঠায়, যেখানে status হলো failed, code 131050, এবং শিরোনাম "Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business"। এই ব্যর্থতাকে ঠিক একটি stop ইভেন্টের মতো ধরুন: রেকর্ড করুন এবং ওই গ্রাহকের কাছে আর মার্কেটিং পাঠানো বন্ধ রাখুন।
easyCoexistence-এর মাধ্যমে সংযুক্ত নম্বরে এটি কীভাবে কাজ করে?
user_preferences সেই ফিল্ডগুলোর একটি নয়, যেগুলোর জন্য Meta গন্তব্য ওভাররাইডের অনুমতি দেয়। তাই Meta এটি শুধু সেই অ্যাপের ডিফল্ট কলব্যাকে পাঠায়, যে অ্যাপ অ্যাকাউন্টে সাবস্ক্রাইব করেছে। easyCoexistence-এর মাধ্যমে সংযুক্ত নম্বরের ক্ষেত্রে, সেই অ্যাপ easyCoexistence-এর, এবং এটি আজ পর্যন্ত user_preferences-এ সাবস্ক্রাইব করে না। তাই ইভেন্টটি সরাসরি গন্তব্যে বা Forward URL-এ পৌঁছায় না। 131050 ব্যর্থ স্ট্যাটাস পৌঁছায়, কারণ সেটি messages ফিল্ডে আসে।
আপনার AI যদি send_template দিয়ে মার্কেটিং টেমপ্লেট পাঠায়, তাহলে বন্ধ গ্রাহকদের তালিকা আপনার নিজের সিস্টেমে রাখুন এবং আগে সেটি যাচাই করুন: easyCoexistence একটি তালিকা রাখে না।
সাধারণ ভুলগুলো
- Not interested-কে stop ধরা। এতে কোনো ওয়েবহুক যায় না এবং ডেলিভারি বন্ধ হয় না, যদিও সেই গ্রাহকের প্রতি-ব্যবহারকারী মার্কেটিং সীমা কমাতে পারে।
- শুধু wa_id দিয়ে পছন্দ সংরক্ষণ করা। যে গ্রাহকের username আছে এবং নম্বর শেয়ার করা যায় না, তার ক্ষেত্রে এটি বাদ থাকে; BSUID-ও সংরক্ষণ করুন।
- প্যারেন্ট BSUID-এর অধীনে সবার উপর stop প্রয়োগ করা। Meta পছন্দ প্রতি ব্যবহারকারীর জন্য প্রয়োগ করে, কখনো প্যারেন্ট স্তরে নয়।
- 131050-এর পর আবার চেষ্টা করা, stop হিসেবে রেকর্ড না করে। প্রতিটি পুনঃচেষ্টা একই ভাবে ব্যর্থ হয়।
এর মাধ্যমে পাঠানো মার্কেটিং টেমপ্লেট আপনার নিজের WhatsApp Business Account থেকে যায়, এবং গ্রাহক বন্ধ করেছেন জানায় যে ব্যর্থ স্ট্যাটাসগুলো সরাসরি আপনার সার্ভারে বা স্বাক্ষরিত forward হিসেবে পৌঁছায়। প্রতি সংযুক্ত নম্বরে প্রতি মাসে US$ 9 থেকে শুরু করে, নম্বর যোগ করার সঙ্গে সঙ্গে US$ 0.75 পর্যন্ত কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
স্টপ কি গ্রাহকের নিজের মেসেজের উত্তরও আটকায়?
Meta-র ডকুমেন্টেশন stop-কে মার্কেটিং মেসেজের উপর প্রযোজ্য বলে বর্ণনা করে, এবং তার ফেরত দেওয়া ত্রুটিতেও marketing messages লেখা থাকে। আপনাকে যে গ্রাহক লিখেছেন, তাঁকে উত্তর দেওয়া হলো সার্ভিস মেসেজ, যা আলাদা ক্যাটাগরি।
ব্যবসাকে ব্লক করলে কি user_preferences চালু হয়?
না। ওয়েবহুক শুধু Offers and announcements সেটিংসে stop ও resume হলে চালু হয়। ব্লক করা আলাদা একটি কাজ, এবং এই ফিল্ডে সেটি জানানো হয় না।
resume কি opt-in গণ্য হয়?
এর মানে গ্রাহক আবার আপনার মার্কেটিং মেসেজ পেতে বেছে নিয়েছেন। Meta-র নীতির অধীনে আপনার নিজের opt-in দায়িত্ব এখনও প্রযোজ্য, তাই কীভাবে ও কখন ওই গ্রাহক আপনার কাছ থেকে শুনতে রাজি হয়েছিলেন, সেই রেকর্ড রাখুন।
কোন ওয়েবহুক ফিল্ডে সাবস্ক্রাইব করব?
user_preferences, অ্যাপ ড্যাশবোর্ডে WhatsApp > Configuration-এ, যে অ্যাপ WhatsApp Business Account-এ সাবস্ক্রাইব করা আছে তাতে। এটি messages থেকে আলাদা একটি ফিল্ড এবং এর জন্য whatsapp_business_management লাগে।
আরও পড়ুন
শুরু করতে প্রস্তুত?
মাস নয়, কয়েক মিনিটেই WhatsApp Coexistence সেট আপ করুন। ফোনে অ্যাপটি কাজ করতে থাকে।
ফ্রি ট্রায়াল শুরু করুনযাচাই করা হয়েছে