පුරනය වන්නනොමිලේ trial කාලය ආරම්භ කරන්න
easyCoexistence නිල API

API හරහා WhatsApp Business app chat history සහ contacts import කරන ආකාරය

Coexistence හරහා සම්බන්ධ කළ WhatsApp Business app අංකයකට තිබෙන contacts සහ දින 180 දක්වා one-to-one chats, onboarding වී පැය 24ක් ඇතුළත, API එකට එක වරක් යැවිය හැක. Contacts smb_app_state_sync webhook එක හරහාද, chats history webhook එක හරහාද ලැබේ; chats metadata.chunk_order අනුව පිළිවෙළ කළ chunk වලින් පැමිණේ. metadata.progress 100 වූ විට import සම්පූර්ණ වේ. chats බෙදාගන්නේද යන්න app එකේ තීරණය කරන්නේ ව්‍යාපාරයයි.

easyCoexistence ඔබේ පාරිභෝගිකයින්ගේ WhatsApp Business app අංක Coexistence හරහා සම්බන්ධ කර, ඔබේ webhook සූදානම් වූ මොහොතේම Meta වෙතින් ඔවුන්ගේ contacts සහ chat history ඉල්ලයි; එවිට history කිසිවක් අතරමග ගබඩා නොකර ඔබේ endpoint වෙත කෙලින්ම යයි, සෑම අංකයක්ම 24/7 නිරීක්ෂණය වේ.

180 days

History webhooks කොපමණ දුරට පසුපසට ළඟා වේද යන්න; ව්‍යාපාරය Cloud API වෙත onboarding කළ දින සිට ගණනය කෙරේ.

24 hours

ව්‍යාපාරයේ contacts සහ පණිවිඩ ඉතිහාසය sync කළ යුතු, onboarding වීමෙන් පසු කාල සීමාව.

2593109

WhatsApp Business app එකේ ව්‍යාපාරය history බෙදාගැනීම අක්‍රිය කර ඇති විට history webhook මත ලැබෙන දෝෂ කේතය.

Once

සෑම sync එකක්ම කොපමණ වාර ගණනකට ධාවනය විය හැකිද යන්න; නැවත කිරීමට පාරිභෝගිකයා offboard වී Embedded Signup නැවත සම්පූර්ණ කළ යුතුය.

100

History sync එක සම්පූර්ණ බව සලකුණු කරන progress අගය.

Import ආරම්භ වන්නේ කෙසේද?

අංකය මත webhook ගමනාන්තයක් ඇති විටය. connect session එකේ webhook_url දැනටමත් සකසා connect කළහොත්, නැතහොත් connect වී පැය 24ක් ඇතුළත PUT /connections/{id}/webhook සමඟ එකක් සැකසුවහොත්, easyCoexistence එක් වරක් Meta වෙතින් දත්ත ඉල්ලයි: contacts සඳහා sync_type smb_app_state_sync සමඟ, ඉන්පසු chats සඳහා history සමඟ, Meta ලේඛනගත කරන අනුපිළිවෙළට. අංකයේ event log එකේ, සහාය සඳහා 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

Contact webhooks තුළ කුමක් ඇතුළත් වේද?

smb_app_state_sync field එක, value තුළ state_sync array එකක් සමඟ. එක් item එකක type contact; full_name, first_name සහ phone_number සහිත contact object එකක්; add හෝ remove action එකක් සහ metadata.timestamp ඇත. remove වලදී නම් ඇතුළත් නොවේ. ව්‍යාපාරය WhatsApp Business app එකේ contact එකක් එකතු කරන, සංස්කරණය කරන හෝ ඉවත් කරන විට Meta import වූ පසුවත් මෙම webhooks යවයි; එබැවින් ඔබේ address book එක දුරකථනය සමඟ සමාන ව පවතී.

History webhooks තුළ කුමක් ඇතුළත් වේද?

history field එක, value තුළ history array එකක් සමඟ. එක් item එකක metadata ඇත, එහි phase, chunk_order සහ progress ඇත; සහ threads, එක් පාරිභෝගිකයෙකුට එකක් බැගින්: thread id එක පාරිභෝගිකයාගේ අංකයයි, messages මගින් එම one-to-one සංවාදය ලැයිස්තු කරයි, ඇතුළට හා පිටතට යන දෙකම, from මගින් එක් එක් පණිවිඩය යැවූ පැත්ත පෙන්වයි. පණිවිඩයක id, timestamp, type, type නමට යටතේ එහි content, සහ history_context.status (READ හෝ DELIVERED වැනි) ඇත. Group chats ඇතුළත් නොවේ.

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" }
                      }
                    ]
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  ]
}

Media messages කෙසේ import වේද?

පළමුව placeholder ලෙස. media message එකක් type media_placeholder සමඟ පැමිණේ, content හෝ media ID නැතිව. ඉන්පසු Meta වෙනම history webhooks යවයි, media IDs සහිතව, නමුත් onboarding වී දින 14ක් ඇතුළත යැවූ media සඳහා පමණි; එම files පාරිභෝගිකයාගේ token සමඟ Meta වෙතින් ලබාගන්න. ඊට වඩා පැරණි media placeholder ලෙසම පවතී; එබැවින් thread එකේ හිස් ඉඩක් තැබීමට වඩා එය ලබාගත නොහැකි attachment එකක් ලෙස පෙන්වන්න.

chunks පැමිණෙන අනුපිළිවෙළ කුමක්ද, import කවදා සම්පූර්ණ වේද?

අනිවාර්යයෙන්ම අනුපිළිවෙළට නොවේ. Meta chats අවධි තුනකට බෙදයි, අලුත්ම ඒවා පළමුව: phase 0 onboarding වීමට පෙර දිනය, phase 1 දින 90 දක්වා, phase 2 දින 180 දක්වා පසුපසට යයි. chunks අනුපිළිවෙළින් නොපැමිණිය හැකි බැවින්, metadata.chunk_order අනුව ඒවා පිළිවෙළට තබන්න. metadata.progress යනු සම්පූර්ණ sync එකේ ප්‍රතිශතයයි, 100 යනු සම්පූර්ණ බව; phase අංකය පමණක් අවධියක් අවසන් වූ බව නොපෙන්වයි.

ව්‍යාපාරය chats බෙදාගැනීමට ප්‍රතික්ෂේප කළොත් කුමක් වේද?

සම්බන්ධ කරන අතරතුර, WhatsApp Business app එක ව්‍යාපාරයෙන් chat history බෙදාගන්නේද කියා අසයි. ප්‍රතික්ෂේප කිරීම messages නොමැතිව history webhook එකක් ලෙස පැමිණේ, දෝෂ කේතය 2593109 ඇති errors array එකක් සමඟ, මාතෘකාව History sync is turned off by the business from the WhatsApp Business App. Contacts තවමත් පැමිණෙන අතර, අංකය සම්බන්ධ වූ මොහොතේ සිට live messages සාමාන්‍ය පරිදි ගලා එයි.

Import නැවත ධාවනය කළ හැකිද?

එම connection එකේ නම් නොහැක. Meta සෑම sync එකකටම අවසර දෙන්නේ onboarding වී පැය 24ක් ඇතුළත එක වරක් පමණි, එය නැවත ධාවනය කළ නොහැක. නැවත කිරීමට පාරිභෝගිකයා අංකය විසන්ධි කර නැවත සම්බන්ධ කළ යුතුය; එය නව onboarding එකක් ලෙස ගැනේ. ඔබේ ගමනාන්තය තවමත් තිබේ නම්, easyCoexistence නැවත import ඉල්ලයි, එබැවින් සෑම message එකකම id අනුව අනුපිටපත් ඉවත් කරන්න. ඒ අතරට 14 දින රීතිය ඉක්මවා ආපසු පැමිණෙන අංකයක් ද ඇතුළත් වේ.

connect link එක යැවීමට පෙර කුමක් සූදානම් විය යුතුද?

ඔබේ endpoint එක ක්‍රියාත්මකව පිළිතුරු දෙමින්. ගමනාන්තය යෙදූ විට Meta URL එක GET handshake මගින් පරීක්ෂා කරන අතර, import එක ඉන් වහාම පසුව එක් වරක් ඉල්ලයි. handshake අසාර්ථක වුවහොත්, අංකය තවමත් සම්බන්ධ වේ නමුත් ගමනාන්තයක් නැතිව; session එකේ last_error හේතුව පැහැදිලි කරයි, ඔබ endpoint එක නිවැරදි කර පැය 24ක් ඇතුළත PUT /connections/{id}/webhook සමඟ සකසන තුරු කිසිවක් import නොවේ. webhook_url නොමැති අංකයකට කිසිම import එකක් ලැබෙන්නේ නැත, මන්ද 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 chunks ප්‍රතික්ෂේප කිරීම. Meta payloads 3 MB දක්වා ළඟා විය හැකි වන අතර, Express JSON පෙරනිමියෙන් 100 KB දක්වා පමණක් parse කරයි; එබැවින් සීමාව ඉහළ දමන්න, නැතහොත් chunks අසාර්ථක වන අතර Meta ඒවා නැවත නැවතත් යවයි.
  • chunks ලැබෙන අනුපිළිවෙළට සැකසීම. ඒවා අනුපිළිවෙළින් නොපැමිණිය හැකි බැවින්, metadata.chunk_order අනුව sort කර, import සම්පූර්ණ ලෙස සලකුණු කිරීමට පෙර progress 100 වන තුරු බලා සිටින්න.
  • අනුපිටපත් ඉවත් නොකර history ඇතුළත් කිරීම. live messages import සමඟ අතිච්ඡාදනය විය හැකි අතර, නැවත සම්බන්ධ කිරීම import එක නැවත ධාවනය කරයි; එබැවින් සෑම message එකකම id එක යතුර ලෙස භාවිතා කරන්න.
  • endpoint එක Meta හි handshake ට පිළිතුරු දීමට පෙර connect link එක යැවීම. ගමනාන්තය එවිට යෙදී නොයන අතර, පැය 24ක් ඇතුළත එය සකසන්නේ නැත්නම්, අංකයේ history කිසිවිටක import නොවේ.
EasyCoexistence සමඟ මෙය කිරීම

සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන තරමට පහත යයි, පළමු දින 3 නොමිලේ trial කාලය.

නිතර අසන ප්‍රශ්න

WhatsApp chat history import කොපමණ දුරට පසුපසට යයි?

ව්‍යාපාරය Cloud API වෙත onboarding කිරීමට පෙර දින 180 දක්වා, one-to-one chats දෙපැත්තටම ආවරණය කරමින්.

Group chats import කරනවාද?

නැත. Group chat එකක කොටසක් වන පණිවිඩ Meta ඉවත් කරයි.

පාරිභෝගිකයෙකුගේ පැරණි WhatsApp chats මගේ webhook එකට ළඟා වේද?

ඔව්, දින 180 දක්වා one-to-one chats, onboarding වී පැය 24ක් ඇතුළත එක වරක් යවනු ලැබේ, ව්‍යාපාරය app එකේ ඒවා බෙදාගැනීමට තෝරා ගත්තොත්.

easyCoexistence import කළ chats පිටපතක් තබා ගන්නවාද?

නැත. Meta history කෙලින්ම ඔබේ webhook_url වෙත යවයි, live messages මෙන්, අතරමග කිසිවක් ගබඩා නොවේ.

තවදුරටත් කියවන්න

පාරිභෝගිකයින්ගේ WhatsApp පණිවිඩ සහ comment webhook එක හරහා ලබා ගන්නේ කෙසේදසෑම සම්බන්ධතාවයකටම webhook එකක්: WhatsApp පණිවිඩ Meta වෙතින් කෙලින්ම, URL එකේ රහස්‍ය යතුරෙන් සත්‍යාපනය, comment සහ DM X-EC-Signature සමඟ.පාරිභෝගිකයාගේ WhatsApp හෝ social සම්බන්ධතාවය විසන්ධි වූ විට දැනගන්නේ කෙසේදconnection.* සහ channel.* status events: payload, PRIMARY_INACTIVITY වැනි හේතු, X-EC-Signature, පැය 33ක් පමණ retry, id අනුව අනුපිටපත් ඉවත් කිරීම.පාරිභෝගිකයාගේ WhatsApp, Instagram සහ TikTok API token ලබා ගන්නේ කෙසේදපාරිභෝගිකයාගේ WhatsApp අංකය සහ සෑම social account එකක් සඳහා credentials call එකෙන් ලැබෙන දත්ත, token_ready ක්‍රියා කරන ආකාරයhistory webhook එකCoexistence අංකයක එක්වරක් සිදු කරන පණිවිඩ ඉතිහාස මාරුව history field එකෙන් ලැබේ. එය ලැබෙන වේලාව සහ හේතුව මෙහි ඇත.smb_app_state_sync webhook එකWhatsApp Business යෙදුමෙන් සම්බන්ධතා synchronisation මේ ක්ෂේත්‍රයට ලැබේ. එහි අන්තර්ගතය සහ message history එකෙන් වෙනස.සංවාද නැතිව WhatsApp API එකට සම්බන්ධ වන්නේ කෙසේදWhatsApp Business අංකයක් සංවාද නැතිව Cloud API එකට සම්බන්ධ කරන්නේ කෙසේද. සංවාද දුරකථනයේ රැඳෙන්නේ ඇයි සහ සමමුහුර්ත වන්නේ කුමක්ද.

ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.

වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්‍ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්‍රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.

  • දින 3ක් නොමිලේ
  • ඕනෑම වේලාවක අවලංගු කරන්න
  • නිල API පමණි
  • 24/7 නිරීක්ෂණය කෙරේ

සත්‍යාපනය කළේ