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-விடமிருந்து கேட்கிறது.
Cloud API-க்கு ஆன்போர்டு செய்யப்பட்ட நாளிலிருந்து கணக்கிடப்பட்டு, history வெப்ஹூக்குகள் எவ்வளவு பின்னோக்கிச் செல்லும் என்பது.
ஒரு வணிகத்தின் தொடர்புகளும் மெசேஜ் வரலாறும் ஒத்திசைக்கப்பட வேண்டிய ஆன்போர்டிங்குக்குப் பிந்தைய நேர வரம்பு.
வணிகம் WhatsApp Business ஆப்பில் அரட்டை பகிர்வை நிறுத்தியிருக்கும்போது history வெப்ஹூக்கில் வரும் பிழைக் குறியீடு.
ஒவ்வொரு ஒத்திசைவும் எத்தனை முறை இயங்கலாம்; மீண்டும் செய்ய வாடிக்கையாளர் இணைப்பைத் துண்டித்து, Embedded Signup-ஐ மீண்டும் முடிக்க வேண்டும்.
வரலாற்று ஒத்திசைவு முழுமையானது எனக் குறிக்கும் progress மதிப்பு.
இறக்குமதி எப்படித் தொடங்குகிறது?
எண்ணில் ஒரு வெப்ஹூக் இலக்கு இருப்பதுடன் தொடங்குகிறது. இணைப்பு அமர்வில் webhook_url ஏற்கனவே அமைக்கப்பட்டிருந்தாலோ, அல்லது இணைத்த 24 மணி நேரத்திற்குள் PUT /connections/{id}/webhook மூலம் அமைத்தாலோ, easyCoexistence Meta-விடம் தரவை ஒருமுறை கேட்கிறது: தொடர்புகளுக்கு sync_type smb_app_state_sync உடனும், அரட்டைகளுக்கு history உடனும் POST /{phone_number_id}/smb_app_data அனுப்பப்படும்; இது Meta ஆவணப்படுத்தியுள்ள வரிசை. எண்ணின் நிகழ்வுப் பதிவு history_sync_requested நிகழ்வை Meta-வின் request_id மதிப்புகளுடன் உதவிக்காகப் பதிவு செய்கிறது, அல்லது காரணத்துடன் history_sync_failed பதிவு செய்கிறது.
தொடர்பு வெப்ஹூக்குகளில் என்ன இருக்கும்?
புலம் smb_app_state_sync, மதிப்பில் state_sync வரிசையுடன். ஒவ்வொரு உருப்படியிலும் type contact; full_name, first_name மற்றும் phone_number கொண்ட contact பொருள்; add அல்லது remove என்ற action; மற்றும் metadata.timestamp உள்ளன. நீக்கும்போது பெயர்கள் விடப்படும். வணிகம் WhatsApp Business ஆப்பில் தொடர்பைச் சேர்க்கும், திருத்தும் அல்லது நீக்கும்போதெல்லாம் இறக்குமதிக்குப் பின்னும் Meta இந்த வெப்ஹூக்குகளை அனுப்பிக்கொண்டே இருக்கும்; அதனால் உங்கள் முகவரிப் புத்தகம் தொலைபேசியுடன் ஒத்திருக்கும்.
history வெப்ஹூக்குகளில் என்ன இருக்கும்?
புலம் history, மதிப்பில் history வரிசையுடன். ஒவ்வொரு உருப்படியிலும் phase, chunk_order, progress கொண்ட metadata உள்ளது; மேலும் ஒவ்வொரு வாடிக்கையாளருக்கும் ஒரு thread. 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 மீடியா ID-களுடன் தனி history வெப்ஹூக்குகளை அனுப்பும், ஆனால் ஆன்போர்டு ஆன 14 நாட்களுக்குள் அனுப்பப்பட்ட மீடியாவுக்கு மட்டுமே; அந்தக் கோப்புகளை வாடிக்கையாளரின் டோக்கனுடன் Meta-விடமிருந்து பெறுங்கள். அதற்கு முந்தைய மீடியா பிளேஸ்ஹோல்டராகவே இருக்கும்; எனவே thread-இல் இடைவெளி விடாமல், கிடைக்காத கோப்பு இணைப்பாகக் காட்டுங்கள்.
பகுதிகள் எந்த வரிசையில் வரும், இறக்குமதி எப்போது முடியும்?
வரிசையாக வருவதற்கு உத்தரவாதம் இல்லை. Meta அரட்டைகளை மூன்று கட்டங்களாகப் பிரிக்கிறது, புதியதிலிருந்து தொடங்கி: கட்டம் 0 என்பது ஆன்போர்டிங்குக்கு முந்தைய நாள்; கட்டம் 1 90-ஆம் நாள் வரை; கட்டம் 2 180-ஆம் நாள் வரை செல்லும். பகுதிகள் வரிசை மாறி வரலாம், எனவே metadata.chunk_order-ஆல் வரிசைப்படுத்துங்கள். metadata.progress என்பது முழு ஒத்திசைவின் சதவீதம்; 100 என்றால் முடிந்தது; கட்டத்தின் எண் மட்டும் ஒரு கட்டம் முடிந்ததைச் சொல்லாது.
வணிகம் அரட்டைகளைப் பகிர மறுத்தால் என்ன ஆகும்?
இணைப்பின்போது, WhatsApp Business ஆப் அரட்டை வரலாற்றைப் பகிர்வதா என்று வணிகத்திடம் கேட்கும். மறுத்தால் messages இல்லாத 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.
பொதுவான தவறுகள்
- பெரிய history பகுதிகளை நிராகரித்தல். Meta-வின் பேலோட்கள் 3 MB வரை செல்லலாம், ஆனால் Express இயல்பாக 100 KB வரை மட்டுமே JSON-ஐ பாகுபடுத்தும்; எனவே வரம்பை உயர்த்துங்கள், இல்லையெனில் பகுதிகள் தோல்வியடையும், Meta அவற்றை மீண்டும் முயற்சித்துக்கொண்டே இருக்கும்.
- பகுதிகளை வந்த வரிசையில் செயலாக்குதல். அவை வரிசை மாறி வரலாம், எனவே 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 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: