WhatsApp வெப்ஹூக் ஸ்டேட்டஸ்கள்: அனுப்பப்பட்டது, டெலிவரி ஆனது, படிக்கப்பட்டது, தோல்வியடைந்தது
ஸ்டேட்டஸ் வெப்ஹூக்குகள் WhatsApp Cloud API மூலம் அனுப்பிய மெசேஜுக்கு என்ன நடந்தது என்பதைத் தெரிவிக்கின்றன. அவை messages புலத்தில் messages அணிக்குப் பதிலாக statuses அணியுடன் வருகின்றன: அனுப்பப்பட்டது (ஒரு டிக்), டெலிவரி செய்யப்பட்டது (இரண்டு டிக்), படிக்கப்பட்டது (இரண்டு நீல டிக்), குரல் மெசேஜ்களுக்கு இயக்கப்பட்டது, மற்றும் errors அணியுடன் தோல்வியடைந்தது. statuses[].id ஐ நீங்கள் அனுப்பிய கோரிக்கை திருப்பி அளித்த wamid உடன் பொருத்துங்கள்.
easyCoexistence உங்களிடம் ஏற்கனவே உள்ள WhatsApp Business ஆப் எண்ணை Coexistence வழியாக Meta-வின் Cloud API-உடன் இணைக்கிறது.
Meta அனுப்பும் ஸ்டேட்டஸ் மதிப்புகள்: sent, delivered, read, played (குரல் மெசேஜ்களின் முதல் இயக்கம்) மற்றும் failed.
ஒரு வெளிச்செல்லும் மெசேஜ் தனித்தனி ஸ்டேட்டஸ் வெப்ஹூக்குகளை உருவாக்கக்கூடியவை: sent, delivered மற்றும் read.
இந்த Graph API பதிப்பிலிருந்து, இலவச நுழைவுப் புள்ளி சாளரத்தில் உள்ள மெசேஜ்களைத் தவிர, conversation பொருள் விடுபடுகிறது.
கடந்தகால வெப்ஹூக் தரவைப் பெறுவதற்கு எந்த API-உம் இல்லை; பேலோட்களை வரும்போதே பிடித்துச் சேமிக்குமாறு Meta கேட்கிறது.
X-EC-Event தலைப்பு: முன்னனுப்பப்பட்ட ஸ்டேட்டஸ்கள் messages நிகழ்வுகளுக்குள் value.statuses கீழ் பயணிக்கின்றன.
WhatsApp ஸ்டேட்டஸ் வெப்ஹூக்குகள் எங்கே வருகின்றன?
வாடிக்கையாளர்கள் அனுப்புவதைச் சுமக்கும் அதே messages புலத்தில், அதே object, entry மற்றும் changes உறையில் வருகின்றன. வேறுபாடு value-க்குள் இருக்கிறது: உள்வரும் மெசேஜுக்கு messages அணி உண்டு, ஸ்டேட்டஸுக்கு statuses அணி உண்டு. value.messages மட்டும் படிக்கும் ஹேண்ட்லர் பிழை எதுவும் காட்டாமல் ஒவ்வொரு ஸ்டேட்டஸையும் விட்டுவிடும். metadata.phone_number_id எந்த எண்ணிலிருந்து மெசேஜ் அனுப்பப்பட்டது என்பதைச் சொல்கிறது; வாடிக்கையாளரின் சுயவிவரப் பெயர், wa_id மற்றும் BSUID கொண்ட contacts அணியும் வருகிறது, தோல்வியடைந்த ஸ்டேட்டஸ்களிலும், குழு மெசேஜ்களின் sent ஸ்டேட்டஸிலும் தவிர. Meta-வின் சர்வர்களை விட்டு வெளியேறிய ஒரு மார்க்கெட்டிங் டெம்ப்ளேட்டுக்கான Meta-வின் உதாரணம் இது:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"contacts": [
{
"profile": {
"name": "Pablo M."
},
"wa_id": "16505551234",
"user_id": "US.13491208655302741918"
}
],
"statuses": [
{
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=",
"status": "sent",
"timestamp": "1750030073",
"recipient_id": "16505551234",
"recipient_user_id": "US.13491208655302741918",
"conversation": {
"id": "72b14d6bd5407799e66f64d1b338e567",
"expiration_timestamp": "1750116480",
"origin": {
"type": "marketing"
}
},
"pricing": {
"billable": true,
"pricing_model": "PMP",
"type": "regular",
"category": "marketing"
}
}
]
},
"field": "messages"
}
]
}
]
}ஒவ்வொரு ஸ்டேட்டஸ் மதிப்புக்கும் என்ன பொருள்?
ஒவ்வொரு மதிப்பும் வாடிக்கையாளர் WhatsApp-இல் பார்க்கும் குறியுடன் பொருந்துகிறது. ஒரு ஸ்டேட்டஸ் டெலிவரி ஆன பிறகுதான் படிக்கப்பட்டதாகக் கணக்கிடப்படும்; சாட் ஏற்கனவே திறந்திருக்கும்போது வாடிக்கையாளர் மெசேஜைப் பெற்றால், Meta உள் உகப்பாக்கமாக, delivered வெப்ஹூக் இல்லாமலேயே read அனுப்புகிறது. எனவே ஒரு டிராக்கர் delivered வராவிட்டாலும் read-ஐ ஏற்க வேண்டும், மேலும் ஸ்டேட்டஸ்களை ஒரு நிலையான வரிசையில் எதிர்பார்க்காமல் தரவரிசைப்படுத்த வேண்டும்.
ஒரு ஸ்டேட்டஸ் பொருளில் என்ன புலங்கள் இருக்கின்றன?
மெசேஜை விடக் குறைவானவை, மேலும் சிலவை நிபந்தனைக்குட்பட்டவை. ஒவ்வொன்றும் எப்போது இருக்கும் என்பதை Meta-வின் குறிப்பு பட்டியலிடுகிறது:
- id: நீங்கள் அனுப்பிய மெசேஜின் wamid, பொருத்த வேண்டிய சாவி.
- status மற்றும் timestamp: மதிப்பு மற்றும் வெப்ஹூக் தூண்டப்பட்ட Unix நேரம், சரமாக.
recipient_id: தொலைபேசி எண் அல்லது குழு id; BSUID-க்கு அனுப்பி எண் கிடைக்காதபோது விடுபடும்.recipient_user_id: வாடிக்கையாளரின் BSUID; தொலைபேசி எண்ணுக்கு அனுப்பியபோது தோல்வியடைந்த ஸ்டேட்டஸில் விடுபடும்.recipient_typeமற்றும்recipient_participant_id: குழுவுக்கு அனுப்பிய மெசேஜ்களுக்கு மட்டும்.biz_opaque_callback_data: அனுப்பும் கோரிக்கையில் நீங்கள் அமைத்திருந்தால் மட்டும்.- pricing: sent-இலும் delivered அல்லது read-இல் ஒன்றிலும் மட்டும். errors: failed-இல் மட்டும்.
ஸ்டேட்டஸை நீங்கள் அனுப்பிய மெசேஜுடன் எப்படிப் பொருத்துவது?
wamid மூலம். அனுப்பும் கோரிக்கை messages[0].id-ஐத் திருப்பித் தரும், அந்த மெசேஜின் ஒவ்வொரு ஸ்டேட்டஸும் statuses[].id-இல் அதே மதிப்பைக் கொண்டிருக்கும். அனுப்பும்போதே அதை உங்கள் சொந்தப் பதிவுடன் சேமியுங்கள், ஸ்டேட்டஸ்கள் வரும்போது பதிவைப் புதுப்பியுங்கள்; அடைந்த உயர்ந்த ஸ்டேட்டஸை வைத்துக்கொள்ளுங்கள், அதனால் தாமதமான delivered, read-ஐ மேலெழுதாது. நீங்கள் அறியாத wamid கொண்ட ஸ்டேட்டஸ் எண்ணில் வேறொன்று, உதாரணமாக ஒரு ஆட்டோமேஷன், அனுப்பியது; அதைப் புறக்கணிக்கலாம் அல்லது பதிவு செய்யலாம்.
// statuses.mjs: apply Meta status webhooks to the messages your system sent
const RANK = { sent: 1, delivered: 2, read: 3, played: 4 };
// value: change.value of a "messages" webhook; sends: Map of wamid -> your record
export function applyStatuses(value, sends) {
for (const s of value.statuses ?? []) {
const rec = sends.get(s.id); // the wamid your send request returned
if (!rec) continue; // sent by something else, such as an automation
if (s.status === "failed") {
rec.status = "failed";
rec.error = s.errors?.[0]?.code; // for example 131049, 131050 or 131026
} else if ((RANK[s.status] ?? 0) > (RANK[rec.status] ?? 0)) {
rec.status = s.status; // read arriving before delivered is fine; never step back
}
rec.updatedAt = Math.max(rec.updatedAt ?? 0, Number(s.timestamp));
}
}Coexistence எண்ணில் என்ன மாறுகிறது?
ஸ்டேட்டஸ்கள் API வழியாக அனுப்பப்பட்டதை விவரிக்கின்றன: உங்கள் ஆட்டோமேஷன்களின் பதில்கள், MCP கனெக்டர் வழியாக உங்கள் AI அனுப்பிய மெசேஜ்கள், உங்கள் சொந்தக் குறியீடு அனுப்பியவை. WhatsApp Business ஆப்பில் உரிமையாளர் தட்டச்சு செய்வது மென்பொருளை வேறு விதமாக அடைகிறது, smb_message_echoes ஆக; இது ஆப்பிலிருந்து அனுப்பப்பட்ட மெசேஜ்களின் பிரதிபலிப்பு என Meta ஆவணப்படுத்துகிறது. ஒரு முறை வரலாற்று இறக்குமதியில் வந்த மெசேஜ்கள் தங்கள் சொந்த ஸ்டேட்டஸை வரலாற்று வெப்ஹூக்குக்குள் கொண்டுள்ளன; delivered, read, played, pending மற்றும் error போன்ற மதிப்புகளுடன்.
ஸ்டேட்டஸ்கள் எண்ணின் messages புலம் எங்கே போகிறதோ அங்கே செல்லும். நேரடி இலக்கில், messages என்பது Meta உங்கள் எண்ட்பாயிண்டுக்கு மேலெழுத அனுமதிக்கும் புலம் என்பதால், Meta அவற்றை நேரடியாக உங்கள் எண்ட்பாயிண்டுக்கு அனுப்புகிறது. ஆட்டோமேஷன்கள் இயக்கத்தில் இருந்து Forward URL அமைக்கப்பட்டிருந்தால், அவை அந்த URL-க்கு messages நிகழ்வுகளாகச் சேரும்.
உங்கள் AI அல்லது ஆட்டோமேஷன் மெசேஜ் டெலிவரி ஆனதா என்பதை எப்படி அறிகிறது?
அனுப்புதல் வழியாக அல்ல, உங்கள் இலக்கு வழியாக. ஒரு உதவியாளர் send_template அல்லது send_message அழைக்கும்போது, கருவியின் முடிவில் wamid இருக்கும், Meta மெசேஜை ஏற்றுக்கொண்டது என்றும் சொல்லும்; டெலிவரி பின்னர், வாடிக்கையாளரின் சாதனத்தில் உறுதிசெய்யப்பட்டு ஸ்டேட்டஸாக அறிவிக்கப்படும். easyCoexistence வினவுவதற்கு ஸ்டேட்டஸ் வரலாற்றை வைத்திருக்காது, எந்த MCP கருவியும் ஸ்டேட்டஸ்களைப் படிக்காது; எனவே டெலிவரி உறுதிப்படுத்தல் தேவைப்படும் ஏஜென்ட் உங்கள் அமைப்பு வழியாக அனுப்ப வேண்டும் அல்லது உங்கள் Forward URL பெறும் ஸ்டேட்டஸ்களைப் படிக்க வேண்டும்.
ஆட்டோமேஷன்களுக்கும் இதுவே பொருந்தும்: Runs தாவலில் உள்ள ஒரு ஓட்டம், Meta மெசேஜை ஏற்ற பிறகு பதில் படி முடிந்ததாகக் காட்டும்; அதன் பிறகு அறிவிக்கப்படும் தோல்வி உங்கள் இலக்கில் failed ஸ்டேட்டஸாக மட்டுமே தோன்றும்.
பொதுவான தவறுகள்
- ஒரு தனி statuses புலத்தைத் தேடுவது. ஸ்டேட்டஸ்கள் messages-இல் வருகின்றன, எனவே value.messages மட்டும் படிக்கும் ஹேண்ட்லர் பிழை இல்லாமலேயே அவற்றை இழக்கும்.
- read-க்கு முன் delivered-ஐக் கோருவது. மெசேஜ் வந்த உடனேயே படிக்கப்படும்போது Meta delivered வெப்ஹூக்கைத் தவிர்க்கிறது.
- அனுப்புதல் பதிலை டெலிவரியாகக் கருதுவது. wamid என்பது Meta கோரிக்கையை ஏற்றுக்கொண்டது என்று பொருள்; நிமிடங்கள் கழித்து failed ஸ்டேட்டஸாக தோல்வி வரலாம்.
- வாடிக்கையாளர்களை recipient_id மட்டும் கொண்டு அடையாளம் காண்பது. BSUID-க்கு அனுப்பி தொலைபேசி எண் கிடைக்காதபோது அது விடுபடும்; BSUID recipient_user_id-இல் இருக்கும்.
உங்கள் ஆட்டோமேஷன்கள், AI அல்லது குறியீடு அனுப்பியவற்றின் ஸ்டேட்டஸ்கள் உங்கள் சர்வருக்குச் செல்கின்றன: நேரடி முறையில் Meta-விடமிருந்து நேராக, அல்லது ஆட்டோமேஷன்கள் இயக்கத்தில் இருக்கும்போது உங்கள் Forward URL-க்கு அனுப்பப்பட்டு X-EC-Signature உடன் கையொப்பமிடப்படுகின்றன; இயல்பாக அவை சேமிக்கப்படுவதில்லை. ஒரு இணைக்கப்பட்ட எண்ணுக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, எண்கள் சேரச் சேரக் குறைகிறது, முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
ஸ்டேட்டஸ் வெப்ஹூக்குகளில் மெசேஜின் உரை இருக்குமா?
இல்லை. ஸ்டேட்டஸில் wamid, ஸ்டேட்டஸ், பெறுநர், நேரமுத்திரைகள் மற்றும் பொருந்தும் இடங்களில் pricing மற்றும் errors மட்டுமே இருக்கும். அதனுடன் அதன் ஸ்டேட்டஸைக் காட்ட வேண்டுமானால், நீங்கள் அனுப்பியதன் சொந்த நகலை wamid சாவியுடன் வைத்திருங்கள்.
கடந்தகால ஸ்டேட்டஸ்களை பின்னர் Meta-விடமிருந்து பெற முடியுமா?
முடியாது. கடந்தகால வெப்ஹூக் தரவைப் பெறுவதற்கு API எதுவும் இல்லை என்று Meta-வின் வெப்ஹூக் வழிகாட்டி சொல்கிறது; உங்கள் எண்ட்பாயிண்ட் பிடிக்காத ஸ்டேட்டஸ், Meta மறுமுயற்சி செய்வதை நிறுத்திய பிறகு இழக்கப்படும், அது 7 நாட்கள் வரை ஆகலாம்.
biz_opaque_callback_data எதற்காக?
அனுப்பும்போது நீங்கள் அமைக்கும் சரம், உதாரணமாக உங்கள் சொந்த ஆர்டர் அல்லது டிக்கெட் id. அந்த மெசேஜின் statuses-இல் Meta அதைத் திருப்பித் தரும், அதனால் முதலில் wamid-ஐத் தேடாமலேயே ஸ்டேட்டஸை உங்கள் பதிவுடன் பொருத்தலாம்.
ஸ்டேட்டஸ் வெப்ஹூக்குகளுக்கு 200 உடன் பதில் அளிக்க வேண்டுமா?
ஆம், எந்த வெப்ஹூக் POST-உம் போல. வேறு எந்த பதிலையும் Meta தோல்வியடைந்த டெலிவரியாகக் கருதி மறுமுயற்சி செய்யும்; ஒரே ஸ்டேட்டஸ் இரண்டு முறை வருவதற்கான வழிகளில் ஒன்று இதுதான்.
தொடர்ந்து படிக்கவும்
தொடங்கத் தயாரா?
மாதங்கள் ஆகாமல், சில நிமிடங்களில் WhatsApp Coexistence-ஐ அமைக்குங்கள். ஆப்ஸ் போனில் தொடர்ந்து இயங்கும்.
இலவச ட்ரையலைத் தொடங்குங்கள்இதில் சரிபார்க்கப்பட்டது: