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

WhatsApp ইউজারনেম ও ব্যবসা-নির্দিষ্ট ইউজার আইডি (BSUID): Cloud API ওয়েবহুকে কী বদলাচ্ছে

WhatsApp ইউজারনেম ইউজারদের ফোন নম্বরের বদলে একটি নাম দেখাতে দেয়। তাই 2026 সালের এপ্রিলের প্রথম দিক থেকে Cloud API মেসেজ ওয়েবহুকে user_id ও from_user_id-তে একটি ব্যবসা-নির্দিষ্ট ইউজার আইডিও (BSUID) আসে, যেমন US.13491208655302741918। যে ইউজারের ইউজারনেম আছে এবং যিনি গত 30 দিনে এই নম্বরের সঙ্গে কোনো মেসেজ বা কল করেননি এবং কন্টাক্ট বুকেও নেই, তার ক্ষেত্রে wa_id ও from বাদ থাকে।

easyCoexistence Coexistence-এর মাধ্যমে একটি WhatsApp Business অ্যাপ নম্বরকে Cloud API-এর সঙ্গে যুক্ত করে।

April 2026

কখন থেকে BSUID Cloud API ওয়েবহুকে আসতে শুরু করে, সেটি WhatsApp ইউজারদের কাছে ইউজারনেম পৌঁছানোর আগে।

July 2026

কখন API BSUID-এ পাঠানো মেসেজ গ্রহণ শুরু করে, যা to-এর বদলে recipient-এ সেট হয়।

30 days

প্রতিটি ব্যবসায়িক নম্বরের লুকব্যাক সময়কাল, যার মধ্যে ইউজারের সঙ্গে যেকোনো মেসেজ বা কল তার নম্বর ওয়েবহুকে ধরে রাখে।

128

BSUID-এর দুই অক্ষরের দেশ কোড ও পিরিয়ডের পরে সর্বাধিক অক্ষর-সংখ্যা।

131062

Messages API ত্রুটি: এই মেসেজে ব্যবসা-নির্দিষ্ট ইউজার আইডি (BSUID) রিসিপিয়েন্ট সমর্থিত নয়।

user_changed_user_id

ফোন নম্বর ছাড়া জানানো BSUID পরিবর্তনের সিস্টেম মেসেজের ধরন, পুরোনো BSUID থাকে previous_user_id-এ।

WhatsApp ইউজারনেম ও BSUID কী?

ইউজারনেম একটি ঐচ্ছিক, অনন্য নাম, যা একজন WhatsApp ইউজার সেট করতে পারেন এবং অ্যাপে ফোন নম্বরের বদলে দেখানো হয়। Meta 2026 সালে ধাপে ধাপে ইউজারনেম চালু করছে। BSUID হলো Meta-র যোগ করা ব্যাকএন্ড আইডি, যাতে ব্যবসা এখনও ইউজারদের আলাদা করে চিনতে পারে: এটি স্বয়ংক্রিয়ভাবে তৈরি হয়, প্রতিটি Business Portfolio ও ইউজার জোড়ার জন্য অনন্য, এবং ISO 3166 দুই অক্ষরের দেশ কোড, একটি পিরিয়ড ও সর্বোচ্চ 128টি অক্ষর-সংখ্যা দিয়ে লেখা হয়। Meta অংশীদার ও সরাসরি ইন্টিগ্রেট করা ব্যবসাকে এটি সমর্থন করতে বাধ্য করে, কারণ কোনো ব্যবসাই নিয়ন্ত্রণ করতে পারে না তার ইউজাররা ইউজারনেম নেবে কি না।

কোন ফিল্ডে নতুন আইডেন্টিফায়ার থাকে?

যে প্রপার্টিতে আগে ফোন নম্বর থাকত, তার পাশে নতুন প্রপার্টি যোগ হয়, messages, status, system ও user_preferences ওয়েবহুক জুড়ে। প্যারেন্ট ফিল্ডগুলো শুধু সেই Business Portfolio-র জন্য আসে, যেগুলো Meta প্যারেন্ট BSUID-এর জন্য নথিভুক্ত করেছে। এগুলো নথিভুক্ত পোর্টফোলিওগুলোর মধ্যে কাজ করে:

contacts[].user_idThe user's BSUID, in incoming messages and in sent, delivered and read statuses
messages[].from_user_idThe sender's BSUID, beside from
contacts[].profile.usernameThe username, when the user has one; never on sent statuses
statuses[].recipient_user_idThe recipient's BSUID, unless a send to a phone number failed
parent_user_idA parent BSUID shared by enrolled portfolios, such as US.ENT.11815799212886844830
wa_id, from, recipient_idNow left out when the phone number cannot be shared

কখন ফোন নম্বর বাদ যায়?

যখন ইউজারের ইউজারনেম থাকে এবং Meta-র তিনটি শর্তের কোনোটিই পূরণ না হয়। নম্বর ওয়েবহুকে থেকে যায় যদি ব্যবসায়িক ফোন নম্বর গত 30 দিনে ওই ইউজারের নম্বরে মেসেজ পাঠিয়ে থাকে বা কল করে থাকে, ওই সময়ে ওই নম্বর থেকে মেসেজ বা কল পেয়ে থাকে, অথবা ইউজার পোর্টফোলিওর কন্টাক্ট বুকে থাকে। 30 দিনের লুকব্যাক প্রতিটি ব্যবসায়িক ফোন নম্বরের হিসাবে গণা হয়, তাই একই পোর্টফোলিওর দ্বিতীয় নম্বর একই ইউজারের জন্য শুধু BSUID পেতে পারে। ইউজারনেম না থাকা ইউজাররা এখনও ফোন নম্বর ও BSUID দুটোই নিয়ে আসে।

এখন ইনকামিং মেসেজ কেমন দেখায়?

আগের মতোই, তবে BSUID ফোন নম্বরের পাশে বা তার বদলে থাকে। Meta-র উদাহরণে এমন একজন ইউজার, যার ইউজারনেম আছে এবং যার নম্বর শেয়ার করা যায় না, তার ক্ষেত্রে contacts-এ profile.name, profile.username ও user_id থাকে, আর মেসেজে from যেখানে আগে ছিল, সেখানে from_user_id থাকে:

messages webhook: a text from a user known only by BSUID
{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "102290129340398",
    "changes": [{
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" },
        "contacts": [{
          "profile": { "name": "Sheena Nelson", "username": "realsheenanelson" },
          "user_id": "US.13491208655302741918"
        }],
        "messages": [{
          "from_user_id": "US.13491208655302741918",
          "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQTRBNjU5OUFFRTAzODEwMTQ0RgA=",
          "timestamp": "1749416383",
          "type": "text",
          "text": { "body": "Does it come in another color?" }
        }]
      }
    }]
  }]
}

স্ট্যাটাস ওয়েবহুক কীভাবে বদলায়?

পাঠানো, ডেলিভার ও পড়া স্ট্যাটাসে এখন একটি contacts অ্যারে যোগ হয়, যাতে থাকে ইউজারের নাম, user_id, নম্বর শেয়ার করা গেলে wa_id, এবং delivered ও read-এ username। statuses-এ recipient_user_id BSUID বহন করে, এবং যখন আপনি BSUID-এ পাঠান আর নম্বর শেয়ার করা যায় না, তখন recipient_id বাদ থাকে। ব্যর্থ স্ট্যাটাসে contacts অ্যারে থাকে না, আর মেসেজ ফোন নম্বরে গেলে recipient_user_id বাদ থাকে। তাই ব্যর্থতা মেসেজ আইডি দিয়ে মেলান।

ইউজারদের কীভাবে সংরক্ষণ ও মেলাবেন?

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

ইউজার ফোন নম্বর বদলালে কী হয়?

তাদের BSUID নতুন করে তৈরি হয়, এবং পরিবর্তনটি messages ফিল্ডে একটি সিস্টেম মেসেজ হিসেবে আসে, কারণ Meta-র কোনো user_id_update ফিল্ড নেই যা সাবস্ক্রাইব করা যায়। system.type হয় user_changed_number, যখন নতুন নম্বর আপনার সঙ্গে শেয়ার করা যায়, অথবা user_changed_user_id, যখন শুধু BSUID বদলের খবর দেওয়া যায়। system.user_id নতুন BSUID ধরে রাখে এবং system.previous_user_id পুরোনোটি, যার মাধ্যমে রেকর্ড স্থানান্তরিত হয়। দুটি ধরনই হ্যান্ডল করুন।

যে ইউজারকে শুধু BSUID দিয়ে চেনা যায়, তাকে কীভাবে উত্তর দেবেন?

/<BUSINESS_PHONE_NUMBER_ID>/messages-এ পাঠান, recipient-এ BSUID সেট করে এবং to বাদ রেখে। দুটোই থাকলে to জেতে এবং উত্তর ফোন নম্বরে যায়। রেসপন্সের প্রতিক্রিয়ার contacts এন্ট্রিতে তখন wa_id-এর বদলে input ও user_id থাকে। ওয়ান-ট্যাপ, জিরো-ট্যাপ ও কপি কোড অথেন্টিকেশন টেমপ্লেট ছাড়া যেকোনো মেসেজ টাইপ চলে, কারণ এগুলোর জন্য ফোন নম্বর লাগে। শুধু একই Business Portfolio-র নম্বরগুলো BSUID-এ পৌঁছাতে পারে। ত্রুটি 131062 মানে মেসেজ টাইপটি BSUID রিসিপিয়েন্ট গ্রহণ করে না।

POST /<BUSINESS_PHONE_NUMBER_ID>/messages, sent to a BSUID
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "recipient": "US.13491208655302741918",
  "type": "text",
  "text": { "body": "Yes, it also comes in blue." }
}

ইউজারের কাছে কীভাবে ফোন নম্বর চাইবেন?

REQUEST_CONTACT_INFO বাটন দিয়ে, যা একটি ইউটিলিটি বা মার্কেটিং টেমপ্লেটে যোগ করা হয়, অথবা request_contact_info ধরনের একটি ইন্টারঅ্যাকটিভ মেসেজ হিসেবে পাঠানো হয়। যে ইউজার এতে ট্যাপ করেন, তিনি থ্রেডে নিজের নম্বর শেয়ার করেন, এবং একটি contacts ওয়েবহুক আসে যার origin হলো contact_request, আর নম্বর থাকে phones[].wa_id-তে। হাতে শেয়ার করা কন্টাক্ট আসে origin other ও একটি vCard সহ। Meta বাটনটি 2026 সালের জুলাইয়ের শুরুতে উপলব্ধ করেছে, এবং এর লেবেল কাস্টমাইজ করা যায় না।

কন্টাক্ট বুক কী?

প্রতিটি Business Portfolio-র জন্য Meta-র হোস্ট করা একটি স্টোর, কোনো ইন্টিগ্রেশন কাজ ছাড়াই। একবার কোনো ব্যবসায়িক ফোন নম্বর ইউজারের ফোন নম্বরে মেসেজ পাঠায়, কল করে, অথবা তার থেকে মেসেজ বা কল পায়, তখন ওই নম্বর ও BSUID রেকর্ড হয় এবং পরবর্তী ওয়েবহুক ফোন নম্বর দিয়ে পূরণ করতে ব্যবহৃত হয়, ইউজারনেম থাকুক বা না থাকুক। শুধু চালু হওয়ার পরের মিথস্ক্রিয়া গণ্য হয়। এটি Meta Business Suite-এ ব্যবসা সেটিংস, ব্যবসার তথ্য থেকে বন্ধ করা যায়, যা এর রাখা সব মুছে দেয়। GET বা DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book, যার সঙ্গে bsuid থাকে, একটি এন্ট্রি যাচাই বা মুছে দেয়।

Coexistence ইন্টিগ্রেশনের কী বদলানো উচিত?

শুধু Coexistence নম্বর পাওয়া তিনটি ওয়েবহুকের হ্যান্ডলিং, যেগুলোও বদলায়। history-তে প্রতিটি থ্রেড একটি context অবজেক্ট পায় যাতে wa_id, user_id ও username থাকে, এবং তার মেসেজে from_user_id যোগ হয়। smb_message_echoes-এ একটি contacts অ্যারে যোগ হয়, এবং message_echoes[].to বাদ থাকতে পারে, আর to_user_id BSUID বহন করে। WhatsApp Business অ্যাপে করা এডিট ও রিভোক একইভাবে আসে। smb_app_state_sync-এ একটি কন্টাক্টের phone_number বাদ থাকতে পারে, তার পাশে user_id ও username থাকে। ইকো ও আমদানি করা চ্যাট user_id দিয়েও মেলান, শুধু নম্বর দিয়ে নয়।

ইউজাররা ইউজারনেম নেওয়ার আগে কীভাবে পরীক্ষা করবেন?

App ড্যাশবোর্ডে Meta-র টেস্ট টুল দিয়ে: Use cases-এর অধীনে Connect with customers through WhatsApp, Customize, Configuration, তারপর messages ওয়েবহুকের পাশের Test লিংক একটি নমুনা আপনার এন্ডপয়েন্টে পাঠায়। এটি চারটি পরিস্থিতিতে ইনকামিং মেসেজ ও স্ট্যাটাস কভার করে:

  • একজন ইউজার যার ইউজারনেম নেই: BSUID ও ফোন নম্বরের ফিল্ড, কোনো username নেই।
  • একজন ইউজার যার ইউজারনেম আছে কিন্তু নম্বর অনুপলব্ধ: username ও BSUID, কোনো ফোন নম্বরের ফিল্ড নেই।
  • একজন ইউজার যার ইউজারনেম আছে এবং নম্বর উপলব্ধ: username, BSUID ও ফোন নম্বর।
  • একটি পোর্টফোলিও যা প্যারেন্ট BSUID-এ নথিভুক্ত: পোর্টফোলিওর নিজের BSUID-এর পাশে একটি প্যারেন্ট BSUID।

easyCoexistence BSUID কীভাবে হ্যান্ডল করে?

Meta যেভাবে পাঠায়, ঠিক সেভাবেই এগুলো পাস করে। set_webhook_destination দিয়ে আপনার এন্ডপয়েন্টে রাউট করা একটি নম্বর তার messages ও smb_message_echoes ওয়েবহুক সরাসরি Meta থেকে পায়, user_id, from_user_id, to_user_id ও username সহ। automations বা ফরওয়ার্ডিং চালু থাকলে easyCoexistence Meta-র পাঠানো মানটি অপরিবর্তিত ফরওয়ার্ড করে। BSUID-এ উত্তর দিতে আপনার কোড get_api_credentials ব্যবহার করে, যা নম্বরের phone number ID, তার সেন্ড এন্ডপয়েন্ট এবং উপলব্ধ থাকলে আপনার নিজের টোকেন ফেরত দেয়। send_message ও send_template টুল আন্তর্জাতিক ডিজিটে ফোন নম্বর নেয।

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

  • শুধু wa_id দিয়ে কন্টাক্ট চিহ্নিত করা। যে ইউজারের ইউজারনেম আছে এবং গত 30 দিনে এই নম্বরের সঙ্গে কোনো যোগাযোগ হয়নি, তার মেসেজে শুধু user_id ও from_user_id আসে, এবং যে হ্যান্ডলার wa_id দাবি করে, সে মেসেজটি মিস করে।
  • BSUID-এর দেশের উপসর্গ ছেঁটে ফেলা। Meta পুরো মান চায়, দেশ কোড ও পিরিয়ডসহ, এবং যেকোনো অংশ বদলালে রিকোয়েস্ট ব্যর্থ হয়।
  • user_id_update ফিল্ডের জন্য অপেক্ষা করা। Meta-র কোনো ফিল্ড নেই: BSUID পরিবর্তন messages-এ user_changed_number বা user_changed_user_id ধরনের সিস্টেম মেসেজ হিসেবে আসে।
  • শুধু to দিয়ে Coexistence ইকো মেলানো। smb_message_echoes-এ to ফিল্ড বাদ থাকতে পারে, তাই অ্যাপে টাইপ করা উত্তর নজরে না এলে to_user_id-ও মেলান।
EasyCoexistence দিয়ে এটি করা

এটি তার messages ও smb_message_echoes ওয়েবহুক Meta যেভাবে পাঠায়, সেভাবে আপনার এন্ডপয়েন্টে রাউট করে, BSUID ফিল্ডসহ। get_api_credentials আপনার কোডকে recipient দিয়ে উত্তর দেওয়ার জন্য যা লাগে তা দেয়। প্রতিটি সংযোগ 24/7 পর্যবেক্ষণ করা হয়। প্রতি সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ালে কমে, প্রথম 3 দিন ফ্রি।

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

ইউজারনেম ছাড়া ইউজারও কি BSUID পায়?

হ্যাঁ। ইউজারের ইউজারনেম থাকুক বা না থাকুক, Meta messages ওয়েবহুকে user_id সেট করে। তাই বেশিরভাগ ইউজার ফোন নম্বর ও BSUID দুটোই নিয়ে আসে।

একটি Coexistence নম্বরের কি ব্যবসায়িক ইউজারনেম থাকতে পারে?

হ্যাঁ। 2026 সালের 29 জুন থেকে একটি ব্যবসা Meta Business Suite, WhatsApp Manager, WhatsApp Business অ্যাপ বা Username API-তে এটি গ্রহণ বা বদলাতে পারে। এতে ব্যবসায়িক নম্বর লুকায় না, এবং business_username_updates প্রতিটি স্ট্যাটাস বদল জানায়।

একটি BSUID কি একাধিক Business Portfolio জুড়ে কাজ করে?

না। একটি BSUID একটি পোর্টফোলিও ও ইউজারের সঙ্গে বাঁধা, এবং অন্য পোর্টফোলিওর নম্বর তাকে মেসেজ পাঠাতে পারে না। Meta যেসব ম্যানেজড ব্যবসাকে নথিভুক্ত করে, তারা ENT সহ প্যারেন্ট BSUID পায়। এটি দেশ কোডের পরে থাকে এবং নথিভুক্ত পোর্টফোলিওগুলো জুড়ে কাজ করে।

একটি WhatsApp নম্বরের জন্য easyCoexistence-এর খরচ কত?

প্রতি সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, আপনার কতগুলো সংযোগ আছে তার ওপর নির্ভর করে, এবং প্রথম 3 দিন ফ্রি। Meta-র নিজস্ব মেসেজ চার্জ আপনার WhatsApp Business Account-এর পেমেন্ট পদ্ধতিতেই থাকে।

আরও পড়ুন

messages ওয়েবহুকগ্রাহকের পাঠানো সবকিছু এই ফিল্ডে আসে। পেলোড, স্বীকৃতি এবং রাউট করা নম্বরে প্রোভাইডারে না পৌঁছানোর কারণ জানুন।smb_message_echoes ওয়েবহুকWhatsApp Business অ্যাপ থেকে মানুষ কী পাঠিয়েছে, সফটওয়্যার তা দেখে। এটি শুধু Coexistence নম্বরে থাকে, উপেক্ষা করলে দুবার উত্তর যায়।WhatsApp ওয়েবহুক ফিল্ড, কোনটি কোথায় যায়Coexistence সংযোগে ব্যবহৃত 8টি ওয়েবহুক ফিল্ড কী বহন করে এবং কোনগুলো আপনার এন্ডপয়েন্টে যায়, তা জানুন।Coexistence রেফারেন্সCoexistence কী, মেসেজ কীভাবে যায়, মূল্য, সীমাবদ্ধতা, যোগ্যতা এবং কীভাবে এটি বন্ধ করবেন, তার সংক্ষিপ্ত রেফারেন্স।WhatsApp ওয়েবহুক: মেসেজ সরাসরি আপনার সার্ভারে পাঠানWhatsApp-এর ওয়েবহুক কীভাবে কাজ করে, Meta কী পাঠায় এবং প্রোভাইডারের প্ল্যাটফর্ম এড়িয়ে মেসেজ আপনার এন্ডপয়েন্টে কীভাবে পাঠাবেন।

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

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

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

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