WhatsApp వెబ్హుక్లు: మెసేజ్లను నేరుగా మీ సర్వర్కు పంపడం
WhatsApp వెబ్హుక్ అంటే మీరు ఎంచుకునే HTTPS ఎండ్పాయింట్. Meta దానికి ఈవెంట్లను పోస్ట్ చేస్తుంది: వచ్చే మెసేజ్లు, డెలివరీ స్టేటస్లు, క్వాలిటీ మార్పులు, ఖాతా అప్డేట్లు. Coexistence నంబర్లో గమ్యాన్ని మీ సర్వర్గా సెట్ చేయవచ్చు, కాబట్టి సంభాషణలు ఏ ప్రొవైడర్గుండా వెళ్లవు.
- Meta ఈవెంట్లను నేరుగా మీ URLకు పోస్ట్ చేస్తుంది
- ప్రొవైడర్ ప్లాట్ఫామ్కి బదులుగా మీ ఎండ్పాయింట్
- ప్రతి WhatsApp Business ఖాతాకు ఒక override
7 రోజులు ఎలాంటి ఛార్జీ లేదు. ఎప్పుడైనా రద్దు చేయండి.
మొత్తం ఇంటిగ్రేషన్ ఏమిటంటే: ప్రతి ఖాతాకు ఒక HTTPS గమ్యం.
messages మరియు smb_message_echoes, మీకు పంపే మెసేజ్ మార్గ ఈవెంట్లు.
మీ ఎండ్పాయింట్ తిరిగి పంపాల్సిన GET హ్యాండ్షేక్లో Meta పంపే విలువ.
Meta నిజంగా వెబ్హుక్కు ఏమి పంపుతుంది?
ఈవెంట్లు వివిధ వర్గాల్లో వస్తాయి. వాటి మధ్య తేడానే మీ ఆర్కిటెక్చర్ను నిర్ణయిస్తుంది.
మెసేజ్ మార్గంలో కస్టమర్లు పంపినవి ఉంటాయి. Coexistence నంబర్లో WhatsApp Business యాప్ నుంచి మీ బృందం పంపిన మెసేజ్ల ప్రతిధ్వనులు కూడా ఉంటాయి. ఇవి messages మరియు smb_message_echoes ఫీల్డ్లు. సంభాషణ కంటెంట్ ఉన్నవి ఇవే.
ఆపరేషనల్ మార్గంలో మిగతావన్నీ ఉంటాయి: కనెక్షన్ స్టేటస్ మారితే account_update, క్వాలిటీ లేదా త్రూపుట్ మారితే phone_number_quality_update, account_alerts, account_review_update, business_capability_update మరియు phone_number_name_update. వీటిలో సంభాషణ కంటెంట్ ఉండదు. మానిటరింగ్ వీటిపైనే నిర్మించబడుతుంది.
మెసేజ్ మార్గంలో తనను ఉంచుకునే ప్రొవైడర్కు మొదటి వర్గం అందుతుంది. అలా చేయనిదానికి అందదు.
Meta ఎండ్పాయింట్ను ఎలా ధృవీకరిస్తుంది?
ఏదైనా పంపించే ముందు GET అభ్యర్థనతో ధృవీకరిస్తుంది. సెటప్ పూర్తయినట్టే కనిపించినా మెసేజ్ రాకపోవడానికి ఇదే సాధారణ కారణం.
Meta మీ URLను hub.modeను subscribeగా, మీ hub.verify_tokenను, hub.challenge విలువతో పిలుస్తుంది. మీ ఎండ్పాయింట్ ఆ challengeను raw response bodyగా తిరిగి ఇవ్వాలి. దాన్ని JSONలో చుట్టకూడదు, ఏదీ జోడించకూడదు. అలా చేయకపోతే Meta పంపడం ప్రారంభించదు, ఏ డాష్బోర్డ్లోనూ కారణం కనిపించదు.
ఎండ్పాయింట్ HTTPS కావాలి. నిశ్శబ్దంగా 404 ఇచ్చేది లేదా Metaను తిరస్కరించే authentication పొర వెనుక ఉన్నది, మొదటి మెసేజ్ రాకపోయే వరకు పనిచేసే సెటప్లానే కనిపిస్తుంది.
గమ్యాన్ని మీ సొంత సర్వర్కు పెట్టవచ్చా?
అవును. ప్రొవైడర్ల మధ్య తేడా కనిపించే భాగం ఇదే.
ఒక WhatsApp Business ఖాతా వెబ్హుక్లను ఎక్కడ స్వీకరించాలో యాప్ ద్వారా మార్చడానికి Meta అనుమతిస్తుంది. మేము ఆ overrideను మీ URLగా సెట్ చేస్తాం. దీంతో మెసేజ్ మార్గ ఈవెంట్లు మా callback నుంచి మీదానికి మారతాయి. ఆపరేషనల్ ఈవెంట్లను మేము ఉంచుతాం, ఎందుకంటే డాష్బోర్డ్ మరియు అలర్టింగ్ వాటిపైనే ఆధారపడతాయి.
దీని ప్రభావం మేము ప్రచురించే విధానం కాదు, ఆర్కిటెక్చర్కు సంబంధించినది. సంభాషణ కంటెంట్ మాకు డెలివర్ కాకపోవడంతో మా వైపు నిల్వ చేయడానికి ఎక్కడా ఉండదు. override సెట్ చేయని ఖాతా మా డిఫాల్ట్ callbackకు తిరిగి వెళ్తుంది. అక్కడ హ్యాండ్లర్ ఆ ఈవెంట్లను నిల్వ చేయకుండా వదిలేస్తుంది.
నంబర్ మళ్లీ కనెక్ట్ అయినప్పుడు గమ్యానికి ఏమవుతుంది?
అది తొలగిపోతుంది. ఈ వైఫల్యాన్ని దాదాపు ఎవరూ ముందుగా పరిగణించరు.
గమ్యం ఫోన్ నంబర్కు చెందిన లక్షణం కాదు. అది WhatsApp Business ఖాతాకు మా యాప్ చేసిన సబ్స్క్రిప్షన్పై ఉన్న override. 14 రోజుల inactivity నియమం వల్ల అయినా, మరే కారణంతో అయినా కనెక్షన్ తొలగితే, ఆ ఖాతా నుంచి యాప్ అన్ఇన్స్టాల్ అవుతుంది, override కూడా దానితో పోతుంది.
మళ్లీ కనెక్ట్ చేస్తే పంపడం మరియు మానిటరింగ్ పునరుద్ధరించబడతాయి. కానీ మీ సర్వర్కు డెలివరీ పునరుద్ధరించబడదు. ఎలాంటి లోపం కూడా కనిపించదు. కాబట్టి ఎవరూ స్పందించలేదని కస్టమర్ చెప్పడమే మొదటి సంకేతం కావచ్చు. ప్రతి రీకనెక్షన్లో overrideను మళ్లీ అమలు చేస్తాం, ఎందుకంటే నిజమైన ఒక నంబర్ సరిగ్గా రీకనెక్ట్ అయినా నిశ్శబ్దంగా మారింది.
సాధారణ పొరపాట్లు
- ధృవీకరణ GET నుంచి JSON పంపడం. Metaకు raw hub.challenge విలువ మాత్రమే కావాలి.
- తాత్కాలిక లేదా టెస్ట్ URL వాడటం. దాన్ని సృష్టించిన టూల్ వినడం ఆపిన తర్వాత కూడా Meta దానికి పంపుతూనే ఉంటుంది.
- రీకనెక్షన్ తర్వాత గమ్యం అలాగే ఉంటుందని అనుకోవడం. అది యాప్ సబ్స్క్రిప్షన్పై ఉంటుంది, దానితోనే అన్ఇన్స్టాల్ అవుతుంది.
- Meta అభ్యర్థనను తిరస్కరించే authentication వెనుక ఎండ్పాయింట్ను ఉంచడం.
EasyCoexistence మీ ఎండ్పాయింట్కు webhook overrideను సెట్ చేసి, కాల్కు ముందు దాన్ని ధృవీకరిస్తుంది. ప్రతి రీకనెక్షన్ తర్వాత ఆటోమేటిక్గా మళ్లీ అమలు చేస్తుంది. నెలకు ప్రతి నంబర్కు US$ 9 నుంచి, పెద్ద వాల్యూమ్లో US$ 2 వరకు తగ్గుతుంది. మొదటి 7 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
నా మెసేజ్లు EasyCoexistence గుండా వెళ్తాయా?
లేదు. override మెసేజ్ మార్గ ఈవెంట్లను Meta నుంచి నేరుగా మీ ఎండ్పాయింట్కు పంపుతుంది. override లేని ఖాతా ఈవెంట్లు మా callbackకు తిరిగి వెళ్లి, నిల్వ చేయకుండా వదిలేయబడతాయి.
తర్వాత గమ్యాన్ని మార్చవచ్చా?
అవును, ఎప్పుడైనా డాష్బోర్డ్ నుంచి లేదా MCP కనెక్టర్ ద్వారా మార్చవచ్చు. null పంపితే అది మా డిఫాల్ట్కు రీసెట్ అవుతుంది.
Meta పంపేటప్పుడు నా సర్వర్ డౌన్ అయితే?
Meta కొంతకాలం రీట్రై చేసి, తర్వాత ఆపుతుంది. ఫోన్లోని WhatsApp Business యాప్కు మెసేజ్లు వస్తూనే ఉంటాయి. ఇంటిగ్రేషన్ విఫలమైనా వ్యాపారానికి ఏదీ పోదు.
అనేక నంబర్లకు ఒక వెబ్హుక్ సరిపోతుందా?
అవును. ప్రతి నంబర్ను ఒకే ఎండ్పాయింట్కు పంపి, పేలోడ్లో స్వీకరించే phone number id ఆధారంగా విభజించండి.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండి7 రోజులు ఎలాంటి ఛార్జీ లేదు. ఎప్పుడైనా రద్దు చేయండి.ధృవీకరించిన తేదీ