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ను అడుగుతుంది.
వ్యాపారాన్ని Cloud APIలో ఆన్బోర్డ్ చేసిన క్షణం నుండి లెక్కించి, హిస్టరీ వెబ్హుక్లు ఎంత వెనక్కి వెళ్తాయి.
వ్యాపారం యొక్క కాంటాక్ట్లు మరియు మెసేజ్ హిస్టరీ సింక్రనైజ్ కావాల్సిన ఆన్బోర్డింగ్ తర్వాత సమయం.
వ్యాపారం WhatsApp Business యాప్లో హిస్టరీ షేరింగ్ను ఆఫ్ చేసినప్పుడు history వెబ్హుక్పై వచ్చే ఎర్రర్ కోడ్.
ప్రతి సింక్ ఎంత తరచుగా జరగవచ్చు; దాన్ని మళ్లీ చేయాలంటే కస్టమర్ ఆఫ్బోర్డ్ చేసి Embedded Signupను మళ్లీ పూర్తి చేయాలి.
హిస్టరీ సింక్రనైజేషన్ పూర్తయినట్లు సూచించే 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 నమోదవుతుంది.
కాంటాక్ట్ వెబ్హుక్లలో ఏముంటుంది?
ఫీల్డ్ 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. గ్రూప్ చాట్లు చేర్చబడవు.
{
"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కు పంపిన కంటెంట్ తొలగించబడుతుంది.
దీన్ని ఎలా సెటప్ చేయాలి
- 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.
సాధారణ పొరపాట్లు
- పెద్ద హిస్టరీ chunkలను తిరస్కరించడం. Meta పేలోడ్లు 3 MB వరకు ఉండవచ్చు, Express డిఫాల్ట్గా JSONను 100 KB వరకు మాత్రమే పార్స్ చేస్తుంది, కాబట్టి పరిమితిని పెంచండి, లేదంటే chunkలు విఫలమవుతాయి మరియు Meta వాటిని మళ్లీ ప్రయత్నిస్తూనే ఉంటుంది.
- chunkలను వచ్చిన క్రమంలో ప్రాసెస్ చేయడం. అవి క్రమం తప్పి రావచ్చు, కాబట్టి metadata.chunk_order ప్రకారం క్రమబద్ధీకరించి, దిగుమతి పూర్తయిందని చెప్పే ముందు progress 100 కోసం వేచి ఉండండి.
- డూప్లికేట్లను తొలగించకుండా హిస్టరీని చేర్చడం. లైవ్ మెసేజ్లు దిగుమతితో అతివ్యాప్తి చెందవచ్చు, రీకనెక్షన్ దాన్ని మళ్లీ రన్ చేస్తుంది, కాబట్టి ప్రతి మెసేజ్ను దాని id తో గుర్తించండి.
- Meta హ్యాండ్షేక్కు ఎండ్పాయింట్ స్పందించకముందే కనెక్ట్ లింక్ పంపడం. అప్పుడు గమ్యం వర్తించదు, మరియు 24 గంటల లోపల సెట్ చేయకపోతే నంబర్ హిస్టరీ ఎప్పటికీ దిగుమతి కాదు.
కాబట్టి హిస్టరీ మధ్యలో ఏమీ నిల్వ చేయకుండా నేరుగా మీ ఎండ్పాయింట్కు చేరుతుంది, ప్రతి నంబర్ను 24/7 పర్యవేక్షిస్తుంది. ప్రతి కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు కనెక్షన్లు జోడించే కొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
WhatsApp చాట్ హిస్టరీ దిగుమతి ఎంత వెనక్కి వెళ్తుంది?
Cloud APIలో నంబర్ ఆన్బోర్డ్ అయ్యే ముందు 180 రోజుల వరకు, రెండు దిశల్లోని ఒకరితో ఒకరు జరిగిన చాట్లను కవర్ చేస్తుంది.
గ్రూప్ చాట్లు దిగుమతి అవుతాయా?
లేదు. గ్రూప్ చాట్లో భాగమైన మెసేజ్లను Meta చేర్చదు.
కస్టమర్ పాత WhatsApp చాట్లు నా వెబ్హుక్కు చేరతాయా?
అవును, వ్యాపారం యాప్లో వాటిని షేర్ చేయడానికి ఎంచుకుంటే, ఒకరితో ఒకరు జరిగిన 180 రోజుల వరకు చాట్లు, ఆన్బోర్డింగ్ తర్వాత 24 గంటల లోపల ఒకసారి పంపబడతాయి.
easyCoexistence దిగుమతి చేసిన చాట్ల కాపీని ఉంచుతుందా?
లేదు. Meta హిస్టరీని లైవ్ మెసేజ్ల వలె నేరుగా మీ webhook_urlకు పంపుతుంది, మధ్యలో ఏమీ నిల్వ చేయబడదు.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ