लग इननिःशुल्क ट्रायल सुरु गर्नुहोस्
easyCoexistence आधिकारिक एपीआई

API मार्फत WhatsApp Business एपको च्याट इतिहास र सम्पर्क आयात गर्ने तरिका

Coexistence मार्फत जडान गरिएको WhatsApp Business एप नम्बरले आफ्ना विद्यमान सम्पर्क र 180 दिनसम्मका एक-से-एक च्याट अनबोर्डिङपछि 24 घण्टाभित्र एक पटक API मा पठाउन सक्छ। सम्पर्क smb_app_state_sync वेबहुक मार्फत र च्याट history वेबहुक मार्फत आउँछन्, metadata.chunk_order अनुसार क्रमबद्ध खण्डमा; metadata.progress 100 हुँदा आयात पूरा हुन्छ। व्यवसायले एपमा च्याट साझा गर्ने कि नगर्ने छनौट गर्छ।

easyCoexistence ले Coexistence मार्फत तपाईंका ग्राहकका WhatsApp Business एप नम्बर जडान गर्छ, र तपाईंको वेबहुक तयार हुनासाथ तिनका सम्पर्क र च्याट इतिहास Meta बाट माग्छ।

180 days

व्यवसाय Cloud API मा अनबोर्ड भएको समयबाट गणना गर्दा history वेबहुक कतिसम्म पछाडि पुग्छ।

24 hours

अनबोर्डिङपछि व्यवसायका सम्पर्क र म्यासेज इतिहास सिङ्क्रोनाइज गर्नुपर्ने समयावधि।

2593109

WhatsApp Business एपमा व्यवसायले च्याट साझा गर्ने विकल्प बन्द गरेको अवस्थामा history वेबहुकमा देखिने त्रुटि कोड।

Once

प्रत्येक सिङ्क कति पटक चल्न सक्छ; दोहोर्याउन ग्राहकले अफबोर्ड गरी Embedded Signup फेरि पूरा गर्नुपर्छ।

100

history सिङ्क्रोनाइजेसन पूरा भएको जनाउने progress मान।

आयात कसरी सुरु हुन्छ?

नम्बरमा वेबहुक गन्तव्य हुँदा सुरु हुन्छ। connect session मा webhook_url पहिल्यै सेट भएर जडान हुँदा, वा जडान भएको 24 घण्टाभित्र PUT /connections/{id}/webhook मार्फत सेट गर्दा, easyCoexistence ले Meta लाई डेटा एक पटक माग्छ: सम्पर्कका लागि sync_type smb_app_state_sync, त्यसपछि च्याटका लागि history, Meta ले उल्लेख गरेको क्रममा। नम्बरको इभेन्ट लगमा सहयोगका लागि Meta का request_id मानसहित history_sync_requested, वा कारणसहित history_sync_failed देखिन्छ।

1Connect sessionwebhook_url and webhook_verify_token set before the link goes out
2Customer connectsScans the QR code and chooses whether to share chats
3Contactssmb_app_state_sync, a change per contact
4Chatshistory chunks, the newest phase first
5Completemetadata.progress reaches 100

सम्पर्क वेबहुकमा के हुन्छ?

फिल्ड smb_app_state_sync हो, value भित्र state_sync एरे हुन्छ। प्रत्येक वस्तुमा type contact, full_name, first_name र phone_number भएको contact वस्तु, add वा remove action, र metadata.timestamp हुन्छ। remove मा नाम छोडिन्छ। व्यवसायले WhatsApp Business एपमा सम्पर्क थप्दा, सम्पादन गर्दा वा हटाउँदा, आयातपछि पनि Meta ले यी वेबहुक पठाइरहन्छ, ताकि तपाईंको ठेगाना सूची फोनसँग मेल खाइरहोस्।

history वेबहुकमा के हुन्छ?

फिल्ड history हो, value भित्र history एरे हुन्छ। प्रत्येक वस्तुमा phase, chunk_order र progress भएको metadata हुन्छ, र प्रत्येक ग्राहकका लागि एउटा threads हुन्छ: thread id ग्राहकको नम्बर हो, र messages ले एक-से-एक कुराकानी देखाउँछ, आउने र जाने दुवै। from ले कुन पक्षले पठायो भन्ने जनाउँछ। प्रत्येक म्यासेजमा id, timestamp, type, type को नाममा सामग्री, र history_context.status (जस्तै READ वा DELIVERED) हुन्छ। समूह च्याट समावेश हुँदैनन्।

A history webhook, as Meta sends it
{
  "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 सहित छुट्टै history वेबहुक पठाउँछ, तर अनबोर्डिङको 14 दिनभित्र पठाइएका मिडियाका लागि मात्र; ती फाइल ग्राहकको टोकन प्रयोग गरेर Meta बाट ल्याउनुहोस्। त्यो भन्दा पुरानो मिडिया प्लेसहोल्डरमै रहन्छ, त्यसैले थ्रेडमा खाली ठाउँ नछोडी उपलब्ध नभएको संलग्नकका रूपमा देखाउनुहोस्।

खण्डहरू कुन क्रममा आउँछन्, र आयात कहिले पूरा हुन्छ?

सधैं क्रममा आउँदैनन्। Meta ले च्याटलाई नयाँदेखि पुरानोतिर तीन चरणमा बाँड्छ: phase 0 अनबोर्डिङ अघिल्लो दिन हो, phase 1 ले 90 दिनसम्म, phase 2 ले 180 दिनसम्म पुग्छ। खण्डहरू क्रम मिचेर आउन सक्छन्, त्यसैले metadata.chunk_order अनुसार क्रमबद्ध गर्नुहोस्। metadata.progress सम्पूर्ण सिङ्कको प्रतिशत हो, र 100 को अर्थ पूरा भयो; phase नम्बरले मात्र चरण सकियो भनेर बताउँदैन।

व्यवसायले च्याट साझा गर्न अस्वीकार गरे के हुन्छ?

जडानका क्रममा WhatsApp Business एपले व्यवसायलाई च्याट इतिहास साझा गर्ने कि नगर्ने सोध्छ। अस्वीकार गरेमा history वेबहुक म्यासेजविनाको आउँछ, र errors एरेमा code 2593109 हुन्छ, शीर्षक: History sync is turned off by the business from the WhatsApp Business App। सम्पर्क अझै आउँछन्, र नम्बर जडान भएको क्षणदेखि प्रत्यक्ष म्यासेजहरू सामान्य रूपमा आउँछन्।

आयात फेरि चल्न सक्छ?

एउटै जडानमा सक्दैन। Meta ले हरेक सिङ्कलाई अनबोर्डिङको 24 घण्टाभित्र एक पटक मात्र अनुमति दिन्छ, र यसलाई पुनः चलाउन मिल्दैन। फेरि चलाउन ग्राहकले नम्बर विच्छेद गरेर फेरि जडान गर्नुपर्छ, जुन नयाँ अनबोर्डिङ मानिन्छ: तपाईंको गन्तव्य अझै फाइलमा छ भने easyCoexistence ले फेरि आयात माग्छ, त्यसैले प्रत्येक म्यासेजको id अनुसार दोहोरो हटाउनुहोस्। यसमा 14 दिनको नियमपछि फर्किने नम्बर पनि पर्छ।

कनेक्ट लिङ्क पठाउनु अघि के तयार हुनुपर्छ?

तपाईंको एन्डपोइन्ट, चालु र जवाफ दिँदै। गन्तव्य लागू हुँदा Meta ले GET ह्यान्डसेकमार्फत यूआरएल जाँच गर्छ, र आयात त्यसको तुरुन्तै एक पटक अनुरोध गरिन्छ। ह्यान्डसेक असफल भए नम्बर जडान हुन्छ तर गन्तव्यविना, session को last_error ले कारण बताउँछ, र एन्डपोइन्ट सच्याएर 24 घण्टाभित्र PUT /connections/{id}/webhook मार्फत सेट नगरेसम्म केही आयात हुँदैन। webhook_url नभएको नम्बरको आयात हुँदैन, किनभने easyCoexistence लाई पठाइएको सामग्री हटाइन्छ।

यसलाई कसरी सेट अप गर्ने

  1. 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.
  2. Create the connect sessionPOST /connect-sessions with webhook_url and webhook_verify_token, then send the customer the url it returns.
  3. Store contacts and chatsUpsert contacts from smb_app_state_sync, and insert history messages keyed on their id, sorted by chunk_order.
  4. 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 घण्टाभित्र सेट नगरेसम्म नम्बरको इतिहास कहिल्यै आयात हुँदैन।
EasyCoexistence मार्फत यो काम

यसरी इतिहास बीचमा कहीं नराखी सिधै तपाईंको एन्डपोइन्टमा पुग्छ, र हरेक नम्बर 24/7 निगरानीमा रहन्छ। प्रति जडान प्रति महिना US$ 9 देखि US$ 0.75 सम्म, जडान थपिँदै जाँदा घट्दै, र पहिलो 3 दिन निःशुल्क।

बारम्बार सोधिने प्रश्नहरू

WhatsApp च्याट इतिहासको आयात कतिसम्म पछाडि पुग्छ?

नम्बर Cloud API मा अनबोर्ड हुनुअघिको 180 दिनसम्म, दुवै दिशाका एक-से-एक च्याट समेटेर।

के समूह च्याट आयात हुन्छन्?

हुँदैनन्। Meta ले समूह च्याटको भाग हुने म्यासेजहरू छोड्छ।

ग्राहकका पुराना WhatsApp च्याट तपाईंको वेबहुकसम्म पुग्छन्?

हो, व्यवसायले एपमा साझा गर्ने छनौट गरेमा, अनबोर्डिङको 24 घण्टाभित्र एक पटक पठाइने, 180 दिनसम्मका एक-से-एक च्याट।

के easyCoexistence ले आयात गरिएका च्याटको प्रतिलिपि राख्छ?

राख्दैन। Meta ले इतिहास सिधै तपाईंको webhook_url मा प्रत्यक्ष म्यासेजजस्तै पठाउँछ, र बीचमा केही भण्डारण हुँदैन।

पढ्दै जानुहोस्

वेबहुक मार्फत ग्राहकका WhatsApp म्यासेज र सामाजिक कमेन्ट कसरी प्राप्त गर्नेप्रत्येक कनेक्सनको आफ्नै वेबहुक: WhatsApp म्यासेज Meta बाट सिधै, URL मा रहेको सिक्रेटबाट प्रमाणित, र सामाजिक कमेन्ट तथा DM X-EC-Signature सहित।ग्राहकको WhatsApp वा सामाजिक कनेक्सन कहिले टुट्छ, कसरी थाहा पाउनेconnection.* र channel.* स्ट्याटस इभेन्टहरू: पेलोड, PRIMARY_INACTIVITY जस्ता कारण, X-EC-Signature, लगभग 33 घण्टामा पुनःप्रयास र id अनुसार दोहोरो हटाउने।ग्राहकको WhatsApp, Instagram र TikTok एपीआई टोकन कसरी प्राप्त गर्नेग्राहकको WhatsApp नम्बर र प्रत्येक सामाजिक खाताको credentials कलले फर्काउने विवरण, र टोकन रोटेसन तथा token_ready कसरी काम गर्छ।history वेबहुकCoexistence नम्बरको एकपटकको च्याट इतिहास स्थानान्तरण यही फील्डमा आउँछ। यो कहिले र किन एकपटक मात्र आउँछ।smb_app_state_sync वेबहुकWhatsApp Business एपबाट सम्पर्क सिङ्क्रोनाइजेसन यही फील्डमा आउँछ। यसले के बोक्छ र म्यासेज इतिहासभन्दा किन अलग छ।च्याट नगुमाई WhatsApp लाई API मा कसरी जडान गर्नेम्यासेज हराए बिना WhatsApp Business नम्बरलाई Cloud API मा जडान गर्ने तरिका। च्याट फोनमै किन रहन्छ र वास्तवमा के सिङ्क हुन्छ।

दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।

प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।

  • 3 दिन निःशुल्क
  • जुनसुकै बेला रद्द गर्नुहोस्
  • आधिकारिक एपीआई मात्र
  • 24/7 निगरानी

प्रमाणीकरण गरिएको