உள்நுழைஇலவசமாகத் தொடங்குங்கள்
Meta Tech Provider

WhatsApp பயனர் பெயர்களும் BSUID-களும்: Cloud API வெப்ஹூக்குகளில் என்ன மாறுகிறது

WhatsApp பயனர் பெயர்கள், பயனர்கள் தங்கள் தொலைபேசி எண்ணுக்குப் பதிலாக ஒரு பெயரைக் காட்ட அனுமதிக்கின்றன. அதனால் 2026 ஏப்ரல் தொடக்கத்திலிருந்து Cloud API மெசேஜ் வெப்ஹூக்குகள், user_id மற்றும் from_user_id-இல், எடுத்துக்காட்டாக US.13491208655302741918 போன்ற வணிகத்துக்குள் மட்டும் பொருந்தும் பயனர் அடையாளத்தையும் (BSUID) கொண்டு செல்கின்றன. பயனர் பெயர் வைத்திருக்கும், கடந்த 30 நாட்களில் அந்த எண்ணுடன் எந்த மெசேஜும் அழைப்பும் இல்லாத, தொடர்புப் புத்தகத்திலும் இல்லாத பயனருக்கு wa_id மற்றும் from விடுபடும்.

easyCoexistence, Coexistence வழியாக ஒரு WhatsApp Business app எண்ணை Cloud API-உடன் இணைத்து, அதன் messages மற்றும் smb_message_echoes வெப்ஹூக்குகளை Meta அனுப்பியபடியே உங்கள் எண்ட்பாயிண்டிற்கு அனுப்புகிறது, BSUID புலங்களும் உட்பட.

April 2026

BSUID-கள் Cloud API வெப்ஹூக்குகளில் தோன்றத் தொடங்கிய நாள், பயனர் பெயர்கள் WhatsApp பயனர்களைச் சென்றடைவதற்கு முன்பே.

July 2026

API-கள் BSUID-க்கு அனுப்பப்பட்ட மெசேஜ்களை ஏற்கத் தொடங்கிய நாள்; அப்போது to-க்குப் பதிலாக recipient-இல் அமைக்கப்படும்.

30 days

ஒவ்வொரு வணிகத் தொலைபேசி எண்ணுக்கும் தனியாகக் கணக்கிடப்படும் பின்னோக்கிப் பார்க்கும் காலம்; இதற்குள் பயனருடனான எந்த மெசேஜ் அல்லது அழைப்பும் வெப்ஹூக்குகளில் அவரது எண்ணை வைத்திருக்கும்.

128

BSUID-இன் இரண்டு எழுத்து நாட்டுக் குறியீடு மற்றும் புள்ளிக்குப் பின் வரும் பெரும்பாலான எழுத்து-எண் எழுத்துகள்.

131062

Messages API பிழை: "Business-scoped User ID (BSUID) recipients are not supported for this message."

user_changed_user_id

தொலைபேசி எண் இல்லாமல் வரும் BSUID மாற்றத்துக்கான system மெசேஜ் வகை; பழைய BSUID previous_user_id-இல் இருக்கும்.

WhatsApp பயனர் பெயர்கள் மற்றும் BSUID-கள் என்றால் என்ன?

பயனர் பெயர் என்பது WhatsApp பயனர் அமைத்துக்கொள்ளக்கூடிய விருப்பத் தேர்வான, தனித்துவமான பெயர்; ஆப்பில் தொலைபேசி எண்ணுக்குப் பதிலாக அது காட்டப்படும். 2026-இல் Meta இதை படிப்படியாக அறிமுகப்படுத்துகிறது. BSUID என்பது வணிகங்கள் பயனர்களை வேறுபடுத்திக் காண Meta சேர்த்த பின்தள அடையாளங்காட்டி: இது தானாக உருவாக்கப்படும், ஒவ்வொரு Business Portfolio மற்றும் பயனர் இணைப்புக்கும் தனித்துவமானது, மேலும் பயனரின் ISO 3166 இரண்டு எழுத்து நாட்டுக் குறியீடு, ஒரு புள்ளி, அதிகபட்சம் 128 எழுத்து-எண் எழுத்துகள் என எழுதப்படும். எந்த வணிகமும் பயனர்கள் பயனர் பெயரை ஏற்பார்களா என்று கட்டுப்படுத்த முடியாததால், பார்ட்னர்கள் மற்றும் நேரடியாக ஒருங்கிணைக்கப்பட்ட வணிகங்கள் இதை ஆதரிக்க வேண்டும் என Meta கோருகிறது.

புதிய அடையாளங்காட்டிகளை எந்தப் புலங்கள் கொண்டு செல்கின்றன?

தொலைபேசி எண்ணைக் கொண்டிருந்த புலங்களுக்கு அருகில் புதிய பண்புகள் சேர்க்கப்பட்டுள்ளன; இவை messages, status, system மற்றும் user_preferences வெப்ஹூக்குகள் முழுவதிலும் பொருந்தும். பெற்றோர் புலங்கள், Meta பெற்றோர் BSUID-களில் சேர்த்த Business Portfolio-களுக்கு மட்டுமே தோன்றும்; இவை சேர்க்கப்பட்ட portfolio-களுக்கு இடையே வேலை செய்யும்:

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 நாட்களில் வணிகத் தொலைபேசி எண் அந்தப் பயனரின் எண்ணுக்கு மெசேஜ் அனுப்பினாலோ அழைத்தாலோ, அந்த நேரத்தில் அதிலிருந்து மெசேஜோ அழைப்போ பெற்றாலோ, அல்லது பயனர் portfolio-வின் தொடர்புப் புத்தகத்தில் இருந்தாலோ எண் வெப்ஹூக்குகளில் தொடரும். 30 நாள் பின்னோக்கிய காலம் ஒவ்வொரு வணிகத் தொலைபேசி எண்ணுக்கும் தனியாகக் கணக்கிடப்படுவதால், அதே portfolio-வில் உள்ள இரண்டாவது எண் அதே பயனருக்கு 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?" }
        }]
      }
    }]
  }]
}

ஸ்டேட்டஸ் வெப்ஹூக்குகள் எவ்வாறு மாறுகின்றன?

அனுப்பப்பட்ட, டெலிவரி ஆன, படிக்கப்பட்ட ஸ்டேட்டஸ்களில் பயனரின் பெயர், user_id, எண்ணைப் பகிர முடிந்தால் wa_id, மற்றும் delivered, read நிலைகளில் username ஆகியவற்றுடன் contacts அணி சேர்கிறது. statuses-இல் recipient_user_id BSUID-ஐக் கொண்டிருக்கும்; BSUID-க்கு அனுப்பியிருந்து எண்ணைப் பகிர முடியாதபோது recipient_id விடுபடும். தோல்வியடைந்த ஸ்டேட்டஸில் contacts அணி இருக்காது; மெசேஜ் தொலைபேசி எண்ணுக்குப் போயிருந்தால் recipient_user_id விடுபடும், எனவே தோல்விகளை மெசேஜ் id உடன் இணையுங்கள்.

பயனர்களை எப்படிச் சேமித்துப் பொருத்த வேண்டும்?

முதலில் BSUID-ஆல், எண் வரும்போதெல்லாம் அதை இரண்டாவது விசையாக வைத்து. முழு BSUID-ஐயும் சரமாக (string) சேமியுங்கள், நாட்டுக் குறியீடும் புள்ளியும் உட்பட; அதில் எந்தப் பகுதியை மாற்றினாலும் Meta கோரிக்கையை நிராகரிக்கும். உங்கள் portfolio-கள் சேர்க்கப்பட்டிருந்தால் பெற்றோர் BSUID-ஐயும் சேமியுங்கள். எண் இன்னும் வரும்போது ஏற்கனவே உள்ள பதிவுகளை wa_id-இல் இணையுங்கள், BSUID-ஐ அவற்றுடன் வைத்திருங்கள்; ஏனெனில் பின்னர் பயனர் பெயரை ஏற்கும் பயனர் எண் இல்லாமல் திரும்பி வரலாம். CRM-களிலும் அவற்றுக்குத் தரவு அளிக்கும் கருவிகளிலும் அதே இணைப்புகளை Meta-வின் FAQ கேட்கிறது.

பயனர் தன் தொலைபேசி எண்ணை மாற்றினால் என்ன நடக்கும்?

அவரது BSUID மீண்டும் உருவாக்கப்படும், மாற்றம் messages புலத்தில் system மெசேஜாக வரும்; Meta-வில் சந்தா செய்யக்கூடிய user_id_update புலம் இல்லை. புதிய எண்ணை உங்களுடன் பகிர முடிந்தபோது system.type user_changed_number ஆகவும், BSUID மாற்றம் மட்டும் தெரிவிக்கக்கூடியபோது user_changed_user_id ஆகவும் இருக்கும்; system.user_id புதிய BSUID-ஐயும், system.previous_user_id பழையதையும் கொண்டிருக்கும்; இதன் மூலமே பதிவு இடம்பெயரும். இரண்டு வகைகளையும் கையாளுங்கள்.

BSUID மட்டும் அறியப்பட்ட பயனருக்கு எப்படிப் பதிலளிப்பது?

/<BUSINESS_PHONE_NUMBER_ID>/messages-க்கு, recipient-ஐ BSUID-ஆகவும் to-ஐ விடுபட்டதாகவும் அமைத்து அனுப்புங்கள்; இரண்டும் இருந்தால் to வெல்லும், பதில் தொலைபேசி எண்ணுக்குப் போகும். பதிலின் contacts உள்ளீடு wa_id-க்குப் பதிலாக input மற்றும் user_id-ஐக் கொண்டிருக்கும். one-tap, zero-tap மற்றும் copy code authentication டெம்ப்ளேட்கள் தவிர எந்த மெசேஜ் வகையும் வேலை செய்யும்; அவற்றுக்குத் தொலைபேசி எண் தேவை. ஒரே Business Portfolio-வில் உள்ள எண்கள் மட்டுமே BSUID-ஐ அடைய முடியும். பிழை 131062 என்றால் அந்த மெசேஜ் வகை BSUID recipient-ஐ ஏற்காது என்று பொருள்.

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 பொத்தானால், utility அல்லது marketing டெம்ப்ளேட்டில் சேர்த்து, அல்லது request_contact_info வகை interactive மெசேஜாக அனுப்பலாம். அதைத் தட்டும் பயனர் உரையாடலில் தன் எண்ணைப் பகிர்வார்; origin contact_request ஆகவும் எண் phones[].wa_id-இலும் இருக்கும் contacts வெப்ஹூக் வரும். கைமுறையாகப் பகிரப்பட்ட தொடர்பு origin other மற்றும் vCard உடன் வரும். இந்தப் பொத்தான் 2026 ஜூலை தொடக்கத்தில் கிடைத்தது; அதன் லேபிளை மாற்ற முடியாது.

கான்டாக்ட் புக் என்றால் என்ன?

ஒவ்வொரு Business Portfolio-க்கும் Meta நடத்தும் ஒரு சேமிப்பு; ஒருங்கிணைப்புப் பணி எதுவும் தேவையில்லை. வணிகத் தொலைபேசி எண் ஒரு பயனரின் தொலைபேசி எண்ணுக்கு மெசேஜ் அனுப்பினால், அழைத்தால், அல்லது அதிலிருந்து கேட்டால், அந்த எண்ணும் BSUID-உம் பதிவாகி, பின்னர் வரும் வெப்ஹூக்குகளை தொலைபேசி எண்ணுடன் நிரப்பப் பயன்படும்; பயனர் பெயர் இருந்தாலும் சரி. அதன் தொடக்கத்திற்குப் பின் நடக்கும் தொடர்புகள் மட்டுமே கணக்கில் வரும். Meta Business Suite, Business settings, Business info-வில் அதை அணைக்கலாம்; இது சேமித்தவற்றை நீக்கும். bsuid உடன் GET அல்லது DELETE /<BUSINESS_PHONE_NUMBER_ID>/contact_book ஒரு உள்ளீட்டைச் சரிபார்க்கவோ நீக்கவோ செய்யும்.

Coexistence ஒருங்கிணைப்பு என்ன மாற்ற வேண்டும்?

மூன்று வெப்ஹூக்குகளையும் கையாளும் விதம் மாற வேண்டும்; இவற்றை Coexistence எண் மட்டுமே பெறுகிறது. history-இல் ஒவ்வொரு த்ரெடும் wa_id, user_id மற்றும் username கொண்ட context பொருளைப் பெறும், அதன் மெசேஜ்கள் from_user_id-ஐப் பெறும். smb_message_echoes-இல் contacts அணி சேரும்; message_echoes[].to விடுபடலாம், அதற்குப் பதிலாக to_user_id BSUID-ஐக் கொண்டிருக்கும். WhatsApp Business app-இல் செய்யப்படும் திருத்தங்களும் நீக்கங்களும் இதே வழியில் வரும். smb_app_state_sync-இல் ஒரு தொடர்பின் phone_number விடுபடலாம், அதன் அருகில் user_id மற்றும் username இருக்கும். echoes மற்றும் இறக்குமதி செய்த உரையாடல்களை எண்ணுடன் user_id-ஐயும் சேர்த்துப் பொருத்துங்கள்.

பயனர்கள் பயனர் பெயர்களை ஏற்கும் முன் எப்படிச் சோதிக்கலாம்?

App Dashboard-இல் Meta-வின் சோதனைக் கருவியுடன்: Use cases, Connect with customers through WhatsApp, Customize, Configuration வழியாகச் செல்லுங்கள். messages வெப்ஹூக்குக்கு அருகிலுள்ள Test இணைப்பு உங்கள் எண்ட்பாயிண்டிற்கு மாதிரியை அனுப்பும். உள்வரும் மெசேஜ்களும் ஸ்டேட்டஸ்களும் நான்கு சூழ்நிலைகளில் இவற்றை உள்ளடக்கும்:

  • பயனர் பெயர் இல்லாத பயனர்: BSUID மற்றும் தொலைபேசி எண் புலங்கள், பயனர் பெயர் இல்லை.
  • எண் கிடைக்காத பயனர் பெயர் கொண்ட பயனர்: பயனர் பெயர் மற்றும் BSUID; தொலைபேசி எண் புலங்கள் இல்லை.
  • எண் கிடைக்கும் பயனர் பெயர் கொண்ட பயனர்: பயனர் பெயர், BSUID மற்றும் தொலைபேசி எண்.
  • பெற்றோர் BSUID-களில் சேர்க்கப்பட்ட portfolio: portfolio-வின் சொந்த BSUID-க்கு அருகில் ஒரு பெற்றோர் BSUID.

easyCoexistence BSUID-களை எவ்வாறு கையாளுகிறது?

Meta அனுப்புவதை அப்படியே கடத்துகிறது. set_webhook_destination மூலம் உங்கள் எண்ட்பாயிண்டிற்கு வழிநடத்தப்பட்ட எண், messages மற்றும் smb_message_echoes வெப்ஹூக்குகளை நேரடியாக Meta-விடமிருந்து பெறுகிறது; user_id, from_user_id, to_user_id மற்றும் username உட்பட. ஆட்டோமேஷன்கள் அல்லது முன்னனுப்புதல் இயக்கத்தில் இருந்தால், 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 வகை system மெசேஜ்களாக வரும்.
  • Coexistence echoes-ஐ to-வில் மட்டும் பொருத்துவது. smb_message_echoes-இல் to புலம் விடுபடலாம்; எனவே to_user_id-ஐயும் பொருத்தாவிட்டால் ஆப்பில் தட்டச்சு செய்த பதில் கண்ணில் படாது.
EasyCoexistence மூலம் இதைச் செய்வது

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 app அல்லது Username API வழியாக ஒன்றை ஏற்கலாம் அல்லது மாற்றலாம்; இது வணிக எண்ணை மறைக்காது, மேலும் business_username_updates ஒவ்வொரு ஸ்டேட்டஸ் மாற்றத்தையும் தெரிவிக்கும்.

BSUID பல Business Portfolio-க்களுக்கு இடையே வேலை செய்யுமா?

இல்லை. BSUID ஒரு portfolio மற்றும் பயனருக்குச் சொந்தமானது; வேறொரு portfolio-வில் உள்ள எண் அதற்கு மெசேஜ் அனுப்ப முடியாது. Meta சேர்க்கும் நிர்வகிக்கப்படும் வணிகங்கள் பெற்றோர் BSUID-களைப் பெறும், நாட்டுக் குறியீட்டுக்குப் பின் ENT இருக்கும்; இவை சேர்க்கப்பட்ட portfolio-களுக்கிடையே வேலை செய்யும்.

WhatsApp எண்ணுக்கு easyCoexistence-இன் விலை எவ்வளவு?

ஒரு இணைப்புக்கு, மாதத்துக்கு US$ 9 முதல் US$ 0.75 வரை, உங்களுக்கு எத்தனை இணைப்புகள் உள்ளன என்பதைப் பொறுத்து; முதல் 3 நாட்கள் இலவசம். Meta-வின் சொந்த மெசேஜ் கட்டணங்கள் உங்கள் WhatsApp Business Account-இன் கட்டண முறையிலேயே இருக்கும்.

தொடர்ந்து படிக்கவும்

மெசேஜ் வெப்ஹூக்வாடிக்கையாளர் அனுப்புவது அனைத்தும் இந்தப் புலத்தில் வரும். பேலோட், உறுதிப்படுத்தல், வழிமாற்றப்பட்ட எண்ணில் அது ஏன் ப்ரொவைடரை அடையாது என்பதை அறியுங்கள்.smb_message_echoes வெப்ஹூக்WhatsApp Business ஆப்ஸிலிருந்து மனிதர் அனுப்பியதை மென்பொருள் எப்படிப் பார்க்கிறது. இது Coexistence எண்களில் மட்டுமே உள்ளது; புறக்கணித்தால் இரட்டை பதில்கள் வரும்.WhatsApp வெப்ஹூக் புலங்கள், எது எங்கே செல்கிறதுCoexistence இணைப்பு பயன்படுத்தும் 8 வெப்ஹூக் புலங்கள் எதை எடுத்துச் செல்கின்றன, எவை எண்ட்பாயிண்ட்டுக்கும் எவை கண்காணிப்புக்கும் செல்கின்றன.Coexistence குறிப்புCoexistence என்ன, மெசேஜ்கள் எவ்வாறு செல்கின்றன, கட்டணம், வரம்புகள், தகுதி மற்றும் இணைப்பை மீட்பது பற்றிய சுருக்கக் குறிப்பு.WhatsApp வெப்ஹூக்குகள்: மெசேஜ்களை நேராக உங்கள் சர்வருக்கு அனுப்புதல்WhatsApp வெப்ஹூக்குகள், Meta அனுப்பும் தரவு, புரொவைடர் தளமின்றி மெசேஜ்களை உங்கள் எண்ட்பாயிண்ட்டுக்கு அனுப்புவது பற்றி அறியுங்கள்.

தொடங்கத் தயாரா?

மாதங்கள் ஆகாமல், சில நிமிடங்களில் WhatsApp Coexistence-ஐ அமைக்குங்கள். ஆப்ஸ் போனில் தொடர்ந்து இயங்கும்.

இலவச ட்ரையலைத் தொடங்குங்கள்

இதில் சரிபார்க்கப்பட்டது: