एपीआई के ज़रिए WhatsApp Business ऐप की चैट हिस्ट्री और कॉन्टैक्ट कैसे इंपोर्ट करें
Coexistence के ज़रिए कनेक्ट किया गया WhatsApp Business ऐप नंबर अपने मौजूदा कॉन्टैक्ट और एक-से-एक चैट के 180 दिन तक के मैसेज, ऑनबोर्डिंग के 24 घंटे के भीतर, एपीआई को एक बार भेज सकता है। कॉन्टैक्ट smb_app_state_sync वेबहुक के रूप में आते हैं और चैट हिस्ट्री वेबहुक के रूप में, metadata.chunk_order के क्रम में हिस्सों में; metadata.progress 100 होने पर इंपोर्ट पूरा माना जाता है। ऐप में चैट साझा करनी है या नहीं, यह कारोबार तय करता है।
easyCoexistence आपके ग्राहकों के WhatsApp Business ऐप नंबर को Coexistence के ज़रिए कनेक्ट करता है और आपका वेबहुक तैयार होते ही Meta से उनके कॉन्टैक्ट और चैट हिस्ट्री माँगता है, ताकि हिस्ट्री सीधे आपके एंडपॉइंट पर पहुँचे और बीच में कुछ भी स्टोर न हो।
हिस्ट्री वेबहुक कितने पीछे तक जाते हैं, यह उस तारीख से गिना जाता है जब कारोबार को Cloud API पर ऑनबोर्ड किया गया था।
ऑनबोर्डिंग के बाद वह समय-सीमा जिसके भीतर किसी कारोबार के कॉन्टैक्ट और मैसेज की हिस्ट्री का सिंक होना ज़रूरी है।
हिस्ट्री वेबहुक पर वह गड़बड़ी कोड जो तब आता है जब कारोबार ने WhatsApp Business ऐप में हिस्ट्री साझा करना बंद कर रखा हो।
हर सिंक कितनी बार चल सकता है; इसे दोहराने के लिए ग्राहक को ऑफ़बोर्ड करके Embedded Signup फिर से पूरा करना होगा।
वह प्रोग्रेस मान जो हिस्ट्री सिंक्रोनाइज़ेशन के पूरा होने का संकेत देता है।
इंपोर्ट कैसे शुरू होता है?
नंबर पर एक वेबहुक डेस्टिनेशन होने से। जब नंबर कनेक्ट सेशन पर पहले से सेट webhook_url के साथ जुड़ता है, या कनेक्ट होने के 24 घंटे के भीतर आप PUT /connections/{id}/webhook से उसे सेट करते हैं, तब easyCoexistence Meta से डेटा एक बार माँगता है: पहले कॉन्टैक्ट के लिए sync_type smb_app_state_sync के साथ POST /{phone_number_id}/smb_app_data, फिर चैट के लिए history, वही क्रम जो Meta दस्तावेज़ में बताता है। नंबर के इवेंट लॉग में history_sync_requested दर्ज होता है, जिसमें सपोर्ट के लिए Meta के request_id मान होते हैं, या history_sync_failed कारण के साथ।
कॉन्टैक्ट वेबहुक में क्या होता है?
फ़ील्ड smb_app_state_sync, जिसकी value में state_sync ऐरे होता है। हर आइटम का type contact होता है; उसमें full_name, first_name और phone_number वाला एक contact ऑब्जेक्ट होता है; action add या remove होता है; और metadata.timestamp होता है। remove पर नाम नहीं भेजे जाते। इंपोर्ट के बाद भी जब भी कारोबार WhatsApp Business ऐप में कोई कॉन्टैक्ट जोड़ता, बदलता या हटाता है, Meta ये वेबहुक भेजता रहता है, ताकि आपकी एड्रेस बुक फ़ोन से मेल खाती रहे।
हिस्ट्री वेबहुक में क्या होता है?
फ़ील्ड history, जिसकी value में history ऐरे होता है। हर आइटम में metadata होता है, जिसमें phase, chunk_order और progress होते हैं, और threads, जो हर ग्राहक के लिए एक होता है: thread id ग्राहक का नंबर है, और messages उस एक-से-एक बातचीत की सूची देता है, आने वाले और जाने वाले दोनों, जिसमें from बताता है कि किस तरफ़ से भेजा गया। हर मैसेज में id, timestamp, type, उसका कंटेंट type के नाम वाले फ़ील्ड में, और history_context.status होता है, जैसे READ या DELIVERED। ग्रुप चैट शामिल नहीं होतीं।
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "<WABA_ID>",
"changes": [
{
"field": "history",
"value": {
"messaging_product": "whatsapp",
"metadata": { "display_phone_number": "<BUSINESS_NUMBER>", "phone_number_id": "<PHONE_NUMBER_ID>" },
"history": [
{
"metadata": { "phase": 1, "chunk_order": 3, "progress": 42 },
"threads": [
{
"id": "<CUSTOMER_NUMBER>",
"messages": [
{
"from": "<CUSTOMER_NUMBER>",
"id": "wamid.<ID>",
"timestamp": "1790726400",
"type": "text",
"text": { "body": "<MESSAGE_TEXT>" },
"history_context": { "status": "READ" }
}
]
}
]
}
]
}
}
]
}
]
}मीडिया मैसेज कैसे इंपोर्ट होते हैं?
पहले प्लेसहोल्डर के रूप में। मीडिया मैसेज type media_placeholder के साथ आता है, जिसमें कोई कंटेंट और कोई मीडिया ID नहीं होता। फिर Meta अलग हिस्ट्री वेबहुक भेजता है जिनमें मीडिया ID होते हैं, लेकिन केवल उन मीडिया के लिए जो ऑनबोर्डिंग के 14 दिन के भीतर भेजे गए थे; वे फ़ाइलें ग्राहक के टोकन से Meta से लाएँ। उससे पुराने मीडिया प्लेसहोल्डर ही रहते हैं, इसलिए उन्हें उपलब्ध न होने वाला अटैचमेंट दिखाएँ, ताकि थ्रेड में खाली जगह न रह जाए।
हिस्से किस क्रम में आते हैं, और इंपोर्ट कब पूरा होता है?
ज़रूरी नहीं कि क्रम से आएँ। Meta चैट को तीन फ़ेज़ में बाँटता है, सबसे नई से शुरू करके: फ़ेज़ 0 ऑनबोर्डिंग से एक दिन पहले तक, फ़ेज़ 1 दिन 90 तक और फ़ेज़ 2 दिन 180 तक। हिस्से क्रम से बाहर आ सकते हैं, इसलिए उन्हें metadata.chunk_order से छाँटें। metadata.progress पूरे सिंक का प्रतिशत है, और 100 का मतलब है कि वह पूरा हो गया; अकेला फ़ेज़ नंबर यह नहीं बताता कि कोई फ़ेज़ खत्म हो गया।
अगर कारोबार चैट साझा करने से मना कर दे तो?
कनेक्शन के दौरान WhatsApp Business ऐप कारोबार से पूछता है कि वह अपनी चैट हिस्ट्री साझा करे या नहीं। मना करने पर एक हिस्ट्री वेबहुक आता है, जिसमें कोई messages नहीं होते और एक errors ऐरे होता है जिसका कोड 2593109 है, शीर्षक है History sync is turned off by the business from the WhatsApp Business App। कॉन्टैक्ट फिर भी आते हैं, और नंबर कनेक्ट होने के क्षण से लाइव मैसेज सामान्य रूप से आते रहते हैं।
क्या इंपोर्ट फिर से चल सकता है?
उसी कनेक्शन पर नहीं। Meta हर सिंक को ऑनबोर्डिंग के 24 घंटे के भीतर एक बार ही अनुमति देता है, और उसे दोबारा नहीं चलाया जा सकता। फिर से चलाने के लिए ग्राहक को नंबर डिस्कनेक्ट करके फिर से कनेक्ट करना होगा, जो एक नई ऑनबोर्डिंग मानी जाती है: आपका डेस्टिनेशन सेव होने पर easyCoexistence फिर से इंपोर्ट माँगता है, इसलिए हर मैसेज के id पर डुप्लिकेट हटाएँ। इसमें वह नंबर भी शामिल है जो 14 दिन के नियम के बाद वापस आता है।
कनेक्ट लिंक भेजने से पहले क्या तैयार होना चाहिए?
आपका एंडपॉइंट, जो चालू हो और जवाब दे रहा हो। डेस्टिनेशन लागू होते समय Meta यूआरएल की GET हैंडशेक से जाँच करता है, और इंपोर्ट उसके तुरंत बाद एक बार माँगा जाता है। अगर हैंडशेक विफल हो जाए, तो नंबर फिर भी कनेक्ट होता है, पर बिना डेस्टिनेशन के; सेशन का last_error बताता है कि ऐसा क्यों हुआ, और जब तक आप एंडपॉइंट ठीक करके 24 घंटों के भीतर PUT /connections/{id}/webhook से उसे सेट नहीं करते, कुछ भी इंपोर्ट नहीं होता। बिना webhook_url वाले नंबर का कोई इंपोर्ट नहीं होता, क्योंकि easyCoexistence को भेजा गया कंटेंट छोड़ दिया जाता है।
कैसे कॉन्फ़िगर करें
- Prepare the endpointDeploy an HTTPS URL with a random secret in its path that answers Meta's GET handshake and accepts bodies up to 3 MB.
- Create the connect sessionPOST /connect-sessions with webhook_url and webhook_verify_token, then send the customer the url it returns.
- Store contacts and chatsUpsert contacts from smb_app_state_sync, and insert history messages keyed on their id, sorted by chunk_order.
- Wait for progress 100Treat the import as finished when metadata.progress reaches 100, or as declined when a history webhook carries error 2593109.
आम गड़बड़ियाँ
- बड़े हिस्सों को अस्वीकार करना। Meta के पेलोड 3 MB तक हो सकते हैं, जबकि Express डिफ़ॉल्ट रूप से JSON केवल 100 KB तक पार्स करता है, इसलिए सीमा बढ़ाएँ, नहीं तो हिस्से विफल होते हैं और Meta उन्हें बार-बार दोहराता रहता है।
- हिस्से आने के क्रम में प्रोसेस करना। वे क्रम से बाहर आ सकते हैं, इसलिए metadata.chunk_order से छाँटें और इंपोर्ट को पूरा कहने से पहले progress 100 होने का इंतज़ार करें।
- हिस्ट्री डालना बिना डुप्लिकेट हटाए। लाइव मैसेज इंपोर्ट से ओवरलैप हो सकते हैं और दोबारा कनेक्ट होने पर इंपोर्ट फिर चलता है, इसलिए हर मैसेज को उसके id से पहचानें।
- एंडपॉइंट Meta के हैंडशेक का जवाब देने से पहले कनेक्ट लिंक भेजना। तब डेस्टिनेशन लागू नहीं होता, और 24 घंटों के भीतर सेट न किया जाए तो नंबर की हिस्ट्री कभी इंपोर्ट नहीं होती।
हर नंबर 24/7 मॉनिटर होता है। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ने के साथ कीमत घटती है, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
WhatsApp चैट हिस्ट्री इंपोर्ट कितने पीछे तक जाता है?
उस तारीख से 180 दिन पहले तक, जब नंबर Cloud API पर ऑनबोर्ड हुआ था, और इसमें दोनों दिशाओं की एक-से-एक चैट शामिल हैं।
क्या ग्रुप चैट इंपोर्ट होती हैं?
नहीं। Meta ग्रुप चैट के हिस्सा रहे मैसेज छोड़ देता है।
क्या ग्राहक की पुरानी WhatsApp चैट मेरे वेबहुक तक पहुँचेंगी?
हाँ, एक-से-एक चैट के 180 दिन तक, ऑनबोर्डिंग के 24 घंटे के भीतर एक बार भेजी जाती हैं, अगर कारोबार ऐप में उन्हें साझा करने का विकल्प चुनता है।
क्या easyCoexistence इंपोर्ट की गई चैट की कोई कॉपी रखता है?
नहीं। Meta हिस्ट्री सीधे आपके webhook_url पर भेजता है, लाइव मैसेज की तरह, और बीच में कुछ स्टोर नहीं होता।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित