లాగిన్ చేయండిఉచిత ట్రయల్ ప్రారంభించండి
easyCoexistence అధికారిక APIలు

API ద్వారా WhatsApp Business యాప్ చాట్ హిస్టరీ మరియు కాంటాక్ట్‌లను ఎలా దిగుమతి చేయాలి

Coexistence ద్వారా కనెక్ట్ అయిన WhatsApp Business యాప్ నంబర్ తన ఇప్పటికే ఉన్న కాంటాక్ట్‌లను, మరియు 180 రోజుల వరకు ఒకరితో ఒకరు జరిగిన చాట్‌లను, ఆన్‌బోర్డింగ్ అయిన 24 గంటల లోపల ఒకసారి APIకి పంపగలదు. కాంటాక్ట్‌లు smb_app_state_sync వెబ్‌హుక్‌ల ద్వారా, చాట్‌లు history వెబ్‌హుక్‌ల ద్వారా వస్తాయి, metadata.chunk_order ప్రకారం క్రమబద్ధీకరించిన భాగాలలో; metadata.progress 100 అయినప్పుడు దిగుమతి పూర్తయినట్లు. చాట్‌లను షేర్ చేయాలా వద్దా అనేది వ్యాపారం యాప్‌లోనే ఎంచుకుంటుంది.

easyCoexistence మీ కస్టమర్ల WhatsApp Business యాప్ నంబర్లను Coexistence ద్వారా కనెక్ట్ చేస్తుంది, మరియు మీ వెబ్‌హుక్ సిద్ధమైన క్షణంలోనే వారి కాంటాక్ట్‌లు, చాట్ హిస్టరీ కోసం Metaను అడుగుతుంది.

180 days

వ్యాపారాన్ని Cloud APIలో ఆన్‌బోర్డ్ చేసిన క్షణం నుండి లెక్కించి, హిస్టరీ వెబ్‌హుక్‌లు ఎంత వెనక్కి వెళ్తాయి.

24 hours

వ్యాపారం యొక్క కాంటాక్ట్‌లు మరియు మెసేజ్ హిస్టరీ సింక్రనైజ్ కావాల్సిన ఆన్‌బోర్డింగ్ తర్వాత సమయం.

2593109

వ్యాపారం WhatsApp Business యాప్‌లో హిస్టరీ షేరింగ్‌ను ఆఫ్ చేసినప్పుడు history వెబ్‌హుక్‌పై వచ్చే ఎర్రర్ కోడ్.

Once

ప్రతి సింక్ ఎంత తరచుగా జరగవచ్చు; దాన్ని మళ్లీ చేయాలంటే కస్టమర్ ఆఫ్‌బోర్డ్ చేసి Embedded Signupను మళ్లీ పూర్తి చేయాలి.

100

హిస్టరీ సింక్రనైజేషన్ పూర్తయినట్లు సూచించే progress విలువ.

దిగుమతి ఎలా మొదలవుతుంది?

నంబర్‌పై వెబ్‌హుక్ గమ్యం ఉన్నప్పుడు. కనెక్ట్ సెషన్‌లో webhook_url ఇప్పటికే సెట్ చేసి ఉంటే, లేదా కనెక్ట్ అయిన 24 గంటల లోపల PUT /connections/{id}/webhook ద్వారా సెట్ చేస్తే, easyCoexistence డేటా కోసం Metaను ఒకసారి అడుగుతుంది: మొదట కాంటాక్ట్‌ల కోసం sync_type smb_app_state_sync తో, తర్వాత చాట్‌ల కోసం history తో, Meta డాక్యుమెంట్ చేసిన క్రమంలో POST /{phone_number_id}/smb_app_data. నంబర్ ఈవెంట్ లాగ్‌లో సపోర్ట్ కోసం 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, దాని విలువలో state_sync శ్రేణితో. ప్రతి అంశంలో type contact; full_name, first_name మరియు phone_number ఫీల్డ్‌లతో contact ఆబ్జెక్ట్; add లేదా remove అనే action; మరియు metadata.timestamp ఉంటాయి. remove లో పేర్లు ఉండవు. వ్యాపారం WhatsApp Business యాప్‌లో కాంటాక్ట్‌ను జోడించినా, మార్చినా, తీసివేసినా, దిగుమతి తర్వాత కూడా Meta ఈ వెబ్‌హుక్‌లు పంపుతూనే ఉంటుంది, కాబట్టి మీ అడ్రస్ బుక్ ఫోన్‌తో సమానంగా ఉంటుంది.

హిస్టరీ వెబ్‌హుక్‌లలో ఏముంటుంది?

ఫీల్డ్ history, దాని విలువలో history శ్రేణితో. ప్రతి అంశంలో metadata ఉంటుంది, దానిలో phase, chunk_order మరియు progress; అలాగే ఒక్కో కస్టమర్‌కు ఒక చొప్పున 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 వేరుగా history వెబ్‌హుక్‌లు పంపుతుంది, మీడియా IDలతో, కానీ ఆన్‌బోర్డింగ్‌కు 14 రోజుల లోపల పంపిన మీడియాకు మాత్రమే; ఆ ఫైళ్లను కస్టమర్ టోకెన్‌తో Meta నుండి తీసుకోండి. అంతకంటే పాత మీడియా ప్లేస్‌హోల్డర్‌గానే ఉంటుంది, కాబట్టి థ్రెడ్‌లో ఖాళీ వదలకుండా అందుబాటులో లేని అటాచ్‌మెంట్‌గా చూపించండి.

chunkలు ఏ క్రమంలో వస్తాయి, దిగుమతి ఎప్పుడు పూర్తవుతుంది?

ఎల్లప్పుడూ క్రమంలో ఉండవు. Meta చాట్‌లను మూడు ఫేజ్‌లుగా విభజిస్తుంది, కొత్తవి మొదట: ఫేజ్ 0 ఆన్‌బోర్డింగ్‌కు ముందు రోజు, ఫేజ్ 1 90 రోజుల వెనక్కి, ఫేజ్ 2 180 రోజుల వెనక్కి. chunkలు క్రమం తప్పి రావచ్చు, కాబట్టి వాటిని metadata.chunk_order ప్రకారం క్రమబద్ధీకరించండి. metadata.progress మొత్తం సింక్‌లో శాతం, 100 అంటే పూర్తయింది; ఫేజ్ నంబర్ మాత్రమే ఫేజ్ ముగిసిందని చెప్పదు.

వ్యాపారం చాట్‌లను షేర్ చేయడానికి నిరాకరిస్తే?

కనెక్షన్ సమయంలో 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 URLను దాని GET హ్యాండ్‌షేక్‌తో తనిఖీ చేస్తుంది, దిగుమతి ఒకసారి, వెంటనే అభ్యర్థించబడుతుంది. హ్యాండ్‌షేక్ విఫలమైతే నంబర్ కనెక్ట్ అవుతుంది కానీ గమ్యం లేకుండా, సెషన్ 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.

సాధారణ పొరపాట్లు

  • పెద్ద హిస్టరీ chunkలను తిరస్కరించడం. Meta పేలోడ్‌లు 3 MB వరకు ఉండవచ్చు, Express డిఫాల్ట్‌గా JSONను 100 KB వరకు మాత్రమే పార్స్ చేస్తుంది, కాబట్టి పరిమితిని పెంచండి, లేదంటే chunkలు విఫలమవుతాయి మరియు Meta వాటిని మళ్లీ ప్రయత్నిస్తూనే ఉంటుంది.
  • chunkలను వచ్చిన క్రమంలో ప్రాసెస్ చేయడం. అవి క్రమం తప్పి రావచ్చు, కాబట్టి metadata.chunk_order ప్రకారం క్రమబద్ధీకరించి, దిగుమతి పూర్తయిందని చెప్పే ముందు progress 100 కోసం వేచి ఉండండి.
  • డూప్లికేట్‌లను తొలగించకుండా హిస్టరీని చేర్చడం. లైవ్ మెసేజ్‌లు దిగుమతితో అతివ్యాప్తి చెందవచ్చు, రీకనెక్షన్ దాన్ని మళ్లీ రన్ చేస్తుంది, కాబట్టి ప్రతి మెసేజ్‌ను దాని id తో గుర్తించండి.
  • Meta హ్యాండ్‌షేక్‌కు ఎండ్‌పాయింట్ స్పందించకముందే కనెక్ట్ లింక్ పంపడం. అప్పుడు గమ్యం వర్తించదు, మరియు 24 గంటల లోపల సెట్ చేయకపోతే నంబర్ హిస్టరీ ఎప్పటికీ దిగుమతి కాదు.
EasyCoexistenceతో దీన్ని చేయడం

కాబట్టి హిస్టరీ మధ్యలో ఏమీ నిల్వ చేయకుండా నేరుగా మీ ఎండ్‌పాయింట్‌కు చేరుతుంది, ప్రతి నంబర్‌ను 24/7 పర్యవేక్షిస్తుంది. ప్రతి కనెక్షన్‌కు నెలకు 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 గంటల రీట్రైలు, id తో డూప్లికేట్ తొలగింపు.WhatsApp, Instagram మరియు TikTok కోసం కస్టమర్ల API టోకెన్లను ఎలా పొందాలికస్టమర్ WhatsApp నంబర్, ప్రతి సోషల్ ఖాతా credentials కాల్ ఏం ఇస్తుందో, టోకెన్ రొటేషన్, token_ready ఎలా పని చేస్తాయో వివరిస్తుంది.history వెబ్‌హుక్Coexistence నంబర్‌లో ఒక్కసారి జరిగే చాట్ హిస్టరీ బదిలీ ఈ ఫీల్డ్‌లో వస్తుంది. ఏమి, ఎప్పుడు, ఎందుకు ఒక్కసారే వస్తుందో తెలుసుకోండి.smb_app_state_sync వెబ్‌హుక్WhatsApp Business యాప్ నుంచి కాంటాక్ట్ సింక్రనైజేషన్ ఈ ఫీల్డ్‌లో వస్తుంది. ఇందులో ఏముంటుంది, మెసేజ్ హిస్టరీకి ఇది ఎందుకు వేరుగా ఉందో తెలుసుకోండి.చాట్‌లు కోల్పోకుండా WhatsAppను APIకి ఎలా కనెక్ట్ చేయాలిచాట్‌లు కోల్పోకుండా WhatsApp Business నంబర్‌ను Cloud APIకి కనెక్ట్ చేయడం, ఫోన్‌లో ఏమి ఉండి ఏది సింక్ అవుతుందో తెలుసుకోండి.

మీ మొదటి ఛానెల్‌ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.

ప్లాట్‌ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్‌ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.

  • 3 రోజులు ఉచితం
  • ఎప్పుడైనా రద్దు చేయండి
  • అధికారిక APIలు మాత్రమే
  • 24/7 పర్యవేక్షణ

ధృవీకరించిన తేదీ