WhatsApp వెబ్హుక్ స్టేటస్లు: sent, delivered, read మరియు failed
స్టేటస్ వెబ్హుక్లు WhatsApp Cloud API ద్వారా వ్యాపారం పంపిన మెసేజ్కు ఏమి జరిగిందో తెలియజేస్తాయి. అవి messages ఫీల్డ్లోనే వస్తాయి, కానీ messages అర్రేకు బదులు statuses అర్రేతో: sent (ఒక టిక్), delivered (రెండు టిక్లు), read (రెండు నీలి టిక్లు), వాయిస్ మెసేజ్ల కోసం played, మరియు errors అర్రేతో failed. 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 అర్రే కూడా వస్తుంది, failed స్టేటస్లు మరియు గ్రూప్ మెసేజ్ల 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 లో కస్టమర్ చూసే గుర్తుతో సరిపోతుంది. స్టేటస్ read గా లెక్కించబడాలంటే అది ముందుగా delivered అయి ఉండాలి; అయితే చాట్ ఇప్పటికే తెరిచి ఉన్నప్పుడు కస్టమర్ మెసేజ్ అందుకుంటే, అంతర్గత ఆప్టిమైజేషన్గా Meta ముందు delivered వెబ్హుక్ పంపకుండానే read పంపుతుంది. కాబట్టి ట్రాకర్ delivered రాకపోయినా read ను అంగీకరించాలి, మరియు స్టేటస్లను ర్యాంక్ చేయాలి, ఒక్కొక్కటిగా స్థిర వరుసలో ఆశించకూడదు.
స్టేటస్ ఆబ్జెక్ట్లో ఏ ఫీల్డ్లు ఉంటాయి?
మెసేజ్ కంటే తక్కువ, మరియు కొన్ని షరతులతో కూడినవి. ప్రతి ఫీల్డ్ ఎప్పుడు ఉంటుందో Meta రిఫరెన్స్ చెబుతుంది:
- id: మీరు పంపిన మెసేజ్ యొక్క wamid, సరిపోల్చాల్సిన కీ.
- status మరియు timestamp: విలువ, మరియు వెబ్హుక్ ట్రిగ్గర్ అయిన Unix సమయం, స్ట్రింగ్గా.
recipient_id: ఫోన్ నంబర్ లేదా గ్రూప్ id; మీరు BSUID కు పంపి, నంబర్ అందుబాటులో లేనప్పుడు ఇది ఉండదు.recipient_user_id: కస్టమర్ BSUID; ఫోన్ నంబర్కు పంపినప్పుడు failed స్టేటస్లో ఇది ఉండదు.recipient_typeమరియుrecipient_participant_id: గ్రూప్కు పంపిన మెసేజ్లకు మాత్రమే.biz_opaque_callback_data: send అభ్యర్థనలో మీరు సెట్ చేసినప్పుడు మాత్రమే.- pricing: sent పై మాత్రమే, మరియు delivered లేదా read లో ఒకదానిపై మాత్రమే. errors: failed పై మాత్రమే.
స్టేటస్ను మీరు పంపిన మెసేజ్తో ఎలా సరిపోల్చాలి?
wamid ద్వారా. send అభ్యర్థన 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 ఫీల్డ్ ఎక్కడికి వెళ్తుందో అక్కడికే వెళ్తాయి. డైరెక్ట్ డెస్టినేషన్తో, Meta వాటిని నేరుగా మీ ఎండ్పాయింట్కు పంపుతుంది, ఎందుకంటే messages అనేది 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 వెబ్హుక్ను దాటేస్తుంది.
- send ప్రతిస్పందనను డెలివరీగా భావించడం. 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 నుంచి గత స్టేటస్లు తిరిగి పొందగలనా?
లేదు. Meta వెబ్హుక్ గైడ్ చెబుతున్నట్లు గత వెబ్హుక్ డేటాను తిరిగి పొందే APIలు లేవు, కాబట్టి మీ ఎండ్పాయింట్ క్యాప్చర్ చేయని స్టేటస్ Meta గరిష్టంగా 7 రోజుల వరకు మళ్లీ ప్రయత్నించడం ఆపిన తర్వాత పోతుంది.
biz_opaque_callback_data దేనికి?
ఇది మీరు పంపేటప్పుడు సెట్ చేసే స్ట్రింగ్, ఉదాహరణకు మీ స్వంత ఆర్డర్ లేదా టికెట్ id. Meta దాన్ని ఆ మెసేజ్ యొక్క statuses లో తిరిగి ఇస్తుంది, కాబట్టి మీరు ముందుగా wamid చూడకుండానే స్టేటస్ను మీ రికార్డ్తో సరిపోల్చవచ్చు.
స్టేటస్ వెబ్హుక్లకు 200 తోనే జవాబివ్వాలా?
అవును, ఏ వెబ్హుక్ POST లాగానే. Meta ఇతర ప్రతిస్పందనను విఫలమైన డెలివరీగా పరిగణించి మళ్లీ ప్రయత్నిస్తుంది, అదే స్టేటస్ మీకు రెండుసార్లు చేరే మార్గాల్లో ఇది ఒకటి.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండిధృవీకరించిన తేదీ