लॉग इनमोफत ट्रायल सुरू करा
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 कडून त्यांचे संपर्क आणि चॅट इतिहास मागते, त्यामुळे इतिहास थेट तुमच्या एंडपॉइंटकडे जातो, वाटेत काहीही साठवले न जाता, आणि प्रत्येक नंबरवर 24/7 देखरेख असते.

180 days

Cloud API वर व्यवसायाचा ऑनबोर्डिंग झाल्याच्या क्षणापासून मोजून, history वेबहुक किती मागील काळापर्यंत पोहोचतात.

24 hours

ऑनबोर्डिंगनंतरचा कालावधी, ज्यामध्ये व्यवसायाचे संपर्क आणि मेसेज इतिहास समक्रमित करणे आवश्यक असते.

2593109

व्यवसायाने WhatsApp Business ॲपमध्ये history सामायिकरण बंद केले असता history वेबहुकवरील त्रुटी कोड.

Once

प्रत्येक सिंक किती वेळा चालू शकतो; तो पुन्हा करण्यासाठी ग्राहकाला ऑफबोर्ड करून Embedded Signup पुन्हा पूर्ण करावे लागते.

100

history समक्रमण पूर्ण झाल्याचे दर्शवणारे progress मूल्य.

आयात कशी सुरू होते?

नंबरवर वेबहुक गंतव्यस्थानासह. जेव्हा ते connect session वर webhook_url आधीच सेट करून जोडले जाते, किंवा कनेक्ट झाल्यानंतर 24 तासांच्या आत PUT /connections/{id}/webhook वापरून सेट केले जाते, तेव्हा easyCoexistence Meta कडे डेटा एकदाच मागते: संपर्कांसाठी sync_type smb_app_state_sync सह POST /{phone_number_id}/smb_app_data, त्यानंतर चॅटसाठी 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 असलेला संपर्क ऑब्जेक्ट; क्रिया add किंवा remove; आणि metadata.timestamp. काढताना नावे वगळली जातात. व्यवसाय WhatsApp Business ॲपमध्ये संपर्क जोडतो, संपादित करतो किंवा काढतो तेव्हा Meta आयात झाल्यानंतरही हे वेबहुक पाठवत राहते, त्यामुळे तुमची ॲड्रेस बुक फोनशी जुळलेली राहते.

history वेबहुकमध्ये काय असते?

फील्ड history, value मध्ये history ॲरे. प्रत्येक आयटममध्ये metadata असतो, ज्यात phase, chunk_order आणि progress असतात, आणि threads, प्रत्येक ग्राहकासाठी एक: थ्रेड आयडी हा ग्राहकाचा नंबर असतो, आणि messages त्या एकास-एक संभाषणाची यादी देतात, येणारे आणि जाणारे, ज्यात from सांगते कोणी पाठवले. मेसेजमध्ये id, timestamp, type, त्या type च्या नावाखालील content, आणि 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 सह येतो, कोणताही content आणि media ID नसतो. त्यानंतर Meta स्वतंत्र history वेबहुक पाठवते ज्यात media IDs असतात, पण फक्त ऑनबोर्डिंगच्या 14 दिवसांच्या आत पाठवलेल्या मीडियासाठी; त्या फाइल्स ग्राहकाच्या टोकनसह Meta कडून मिळवा. त्याहून जुना मीडिया प्लेसहोल्डरच राहतो, म्हणून तो उपलब्ध नसलेला ॲटॅचमेंट म्हणून दाखवा, थ्रेडमध्ये रिकामी जागा सोडू नका.

कोणत्या क्रमाने चंक येतात आणि आयात कधी पूर्ण होते?

नेहमी क्रमाने नाही. Meta चॅट तीन फेजमध्ये विभागते, सर्वात नवीन आधी: फेज 0 म्हणजे ऑनबोर्डिंगच्या आधीचा दिवस, फेज 1 दिवस 90 पर्यंत मागे जातो आणि फेज 2 दिवस 180 पर्यंत. चंक क्रमाबाहेर येऊ शकतात, म्हणून त्यांना metadata.chunk_order नुसार लावा. metadata.progress हे संपूर्ण सिंकची टक्केवारी असते, आणि 100 म्हणजे ते पूर्ण झाले; फक्त फेज क्रमांकावरून एखादा टप्पा संपला हे समजत नाही.

व्यवसायाने चॅट शेअर करण्यास नकार दिला तर?

कनेक्शनदरम्यान WhatsApp Business ॲप व्यवसायाला विचारते की चॅट इतिहास शेअर करायचा का. नकार history वेबहुक म्हणून येतो, मेसेजेसशिवाय, आणि errors ॲरे असतो ज्याचा code 2593109 असतो, शीर्षक: व्यवसायाने WhatsApp Business ॲपमधून history सिंक बंद केले आहे. संपर्क तरीही येतात, आणि नंबर जोडल्या क्षणापासून थेट मेसेज नेहमीप्रमाणे येत राहतात.

आयात पुन्हा चालवता येते का?

त्याच कनेक्शनवर नाही. Meta प्रत्येक सिंकला ऑनबोर्डिंगनंतर 24 तासांच्या आत एकदाच परवानगी देते, आणि ते पुन्हा चालवता येत नाही. ते पुन्हा चालवण्यासाठी ग्राहकाने नंबर डिस्कनेक्ट करून पुन्हा कनेक्ट करावा लागतो, जे नवीन ऑनबोर्डिंग मानले जाते: तुमचे गंतव्यस्थान अजूनही फाइलमध्ये असल्यास easyCoexistence आयात पुन्हा मागते, म्हणून प्रत्येक मेसेजच्या id वर डुप्लिकेट काढा. यात 14 दिवसांच्या नियमानंतर परत येणारा नंबरही येतो.

कनेक्ट लिंक पाठवण्यापूर्वी काय तयार असावे?

तुमचा एंडपॉइंट, चालू आणि उत्तर देणारा. गंतव्यस्थान लागू होताना Meta यूआरएलची GET हँडशेक तपासते, आणि आयात एकदाच, त्यानंतर लगेच विनंती केली जाते. हँडशेक अयशस्वी झाला, तरी नंबर जोडला जातो पण गंतव्यस्थानाशिवाय, सेशनचा last_error कारण सांगतो, आणि एंडपॉइंट दुरुस्त करून 24 तासांच्या आत PUT /connections/{id}/webhook ने सेट केल्याशिवाय काहीही आयात होत नाही. webhook_url नसलेल्या नंबरसाठी आयात अजिबात होत नाही, कारण easyCoexistence कडे पाठवलेला content टाकून दिला जातो.

ते कसे सेट करायचे

  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.

सामान्य चुका

  • मोठे history चंक नाकारणे. Meta चे पेलोड 3 MB पर्यंत जाऊ शकतात, तर Express डिफॉल्टने JSON फक्त 100 KB पर्यंत पार्स करते, म्हणून मर्यादा वाढवा, नाहीतर चंक अयशस्वी होतात आणि Meta ते पुन्हा प्रयत्न करत राहते.
  • चंक येण्याच्या क्रमाने प्रक्रिया करणे. ते क्रमाबाहेर येऊ शकतात, म्हणून metadata.chunk_order नुसार लावा आणि आयात पूर्ण म्हणण्यापूर्वी progress 100 ची वाट पाहा.
  • डुप्लिकेट न काढता history घालणे. थेट मेसेज आयातीशी जुळून येऊ शकतात आणि पुन्हा जोडणी आयात पुन्हा चालवते, म्हणून प्रत्येक मेसेज त्याच्या id द्वारे ओळखा.
  • Meta च्या handshake ला एंडपॉइंट उत्तर देण्यापूर्वी कनेक्ट लिंक पाठवणे. तेव्हा गंतव्यस्थान लागू होत नाही, आणि 24 तासांच्या आत सेट न केल्यास नंबरचा इतिहास कधीच आयात होत नाही.
EasyCoexistence सोबत हे करताना

प्रति कनेक्शन प्रति महिना US$ 9 ते US$ 0.75, तुम्ही कनेक्शन वाढवत गेल्यावर कमी होत जाते, पहिले 3 दिवस मोफत.

वारंवार विचारले जाणारे प्रश्न

WhatsApp चॅट इतिहास आयात किती मागे जातो?

नंबर Cloud API वर ऑनबोर्ड केला होता त्याच्या 180 दिवस आधीपर्यंत, दोन्ही दिशांच्या एकास-एक चॅटचा समावेश होतो.

गट चॅट आयात होतात का?

नाही. Meta गट चॅटचा भाग असलेले मेसेज वगळते.

ग्राहकाचे जुने WhatsApp चॅट माझ्या वेबहुकपर्यंत पोहोचतील का?

होय, 180 दिवसांपर्यंतचे एकास-एक चॅट, ऑनबोर्डिंगनंतर 24 तासांच्या आत एकदाच पाठवले जातात, जर व्यवसायाने ॲपमध्ये ते शेअर करण्याचे ठरवले असेल.

easyCoexistence आयात केलेल्या चॅटची प्रत ठेवते का?

नाही. Meta इतिहास थेट तुमच्या webhook_url वर पाठवते, थेट मेसेजप्रमाणेच, आणि वाटेत काहीही साठवले जात नाही.

पुढे वाचा

तुमच्या ग्राहकांचे WhatsApp मेसेज आणि सोशल कमेंट्स वेबहुकद्वारे मिळवाप्रत्येक कनेक्शनसाठी वेबहुक: WhatsApp मेसेज थेट Meta कडून, URL मधील गुपित की ने प्रमाणित. सोशल कमेंट्स व DM X-EC-Signature ने सही केलेले.ग्राहकाचे WhatsApp किंवा सोशल कनेक्शन तुटल्यावर ते कसे कळेलconnection.* आणि channel.* स्टेटस इव्हेंट्स: पेलोड, PRIMARY_INACTIVITY सारखी कारणे, X-EC-Signature आणि सुमारे 33 तासांचे पुन्हा प्रयत्न.WhatsApp, Instagram आणि TikTok साठी ग्राहकांचे एपीआय टोकन कसे मिळवावेWhatsApp नंबर आणि प्रत्येक सोशल खात्यासाठी क्रेडेन्शियल्स कॉल काय परत देतो, फील्डनुसार, आणि टोकन रोटेशन व token_ready कसे चालतात.history वेबहुकCoexistence नंबरवरील एकदाच होणारे चॅट इतिहास हस्तांतरण या फील्डवर मिळते. काय, केव्हा आणि एकदाच का येते ते जाणून घ्या.smb_app_state_sync वेबहुकWhatsApp Business ॲपमधील संपर्क सिंक्रोनायझेशन या फील्डवर येते. यात काय असते आणि ते मेसेज इतिहासापासून वेगळे का आहे.चॅट न गमावता WhatsApp एपीआयशी कसे कनेक्ट करावेचॅट न गमावता WhatsApp Business नंबर Cloud API शी कनेक्ट करा. चॅट्स फोनवर का राहतात आणि नेमके काय समक्रमित होते.

तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.

कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.

  • 3 दिवस मोफत
  • कधीही रद्द करा
  • फक्त अधिकृत एपीआय
  • 24/7 देखरेख

पडताळले: