வாடிக்கையாளரின் WhatsApp அல்லது சமூக இணைப்பு துண்டிக்கப்படும்போது எப்படித் தெரிந்துகொள்வது
easyCoexistence, வாடிக்கையாளரின் இணைப்பு இணைந்தாலோ, துண்டிக்கப்பட்டாலோ, அகற்றப்பட்டாலோ அல்லது இடைநிறுத்தப்பட்டாலோ, உங்கள் தளத்துக்குக் கையொப்பமிட்ட ஸ்டேட்டஸ் நிகழ்வுகளை அனுப்புகிறது. WhatsApp எண் connection.connected, Meta-வின் காரணத்துடன் connection.disconnected, connection.removed, connection.suspended அல்லது connection.token_missing ஆகியவற்றை அனுப்பும்; சமூகக் கணக்கு இவற்றுக்கு இணையான channel.* நிகழ்வுகளை அனுப்பும், token_missing இல்லாமல். ஒவ்வொன்றும் X-EC-Signature உடன் கையொப்பமிடப்பட்ட JSON POST ஆகும்; உங்கள் எண்ட்பாயிண்ட் 2xx பதில் அளிக்கும் வரை சுமார் 33 மணி நேரம் படிப்படியான இடைவெளியில் மீண்டும் அனுப்பப்படும்.
PRIMARY_INACTIVITY: முதன்மைச் சாதனத்தில் WhatsApp Business ஆப் சுமார் 14 நாட்களுக்குப் பயன்படுத்தப்படாததால் Coexistence எண் துண்டிக்கப்பட்டதைக் குறிக்கும் Meta-வின் காரணம்.
COMPANION_INACTIVITY: துணைச் சாதனம் சுமார் 30 நாட்களுக்குச் செயலற்று இருந்ததைக் குறிக்கும் Meta-வின் காரணம்.
துண்டிப்பைத் தெரிவிக்கும் வெப்ஹூக். Meta இதை எப்போதும் ஆப்பின் இயல்புநிலை கால்பேக் URL-க்கு அனுப்பும், ஒருபோதும் மேலெழுதப்பட்ட முகவரிக்கு அனுப்பாது.
2xx அல்லாத பதில் வந்தால் ஸ்டேட்டஸ் நிகழ்வு எத்தனை முறை முயற்சிக்கப்படும்: 1 நிமிடம் முதல் 24 மணி நேரம் வரையிலான இடைவெளிகளில், சுமார் 33 மணி நேரத்தில்.
எண்ட்பாயிண்ட் ஏற்க வேண்டிய ஸ்டேட்டஸ் நிகழ்வின் பழைய கையொப்பமிட்ட நேர முத்திரை t; HMAC-ஐ நிலையான நேரத்தில் ஒப்பிட வேண்டும்.
எந்த ஸ்டேட்டஸ் நிகழ்வுகள் உள்ளன?
ஒன்பது, ஒரே எண்ட்பாயிண்டையும் ஒரே கையொப்பமிடும் ரகசியத்தையும் பகிரும் இரண்டு குடும்பங்களில். எண்கள் connection.* பயன்படுத்துகின்றன, சமூகக் கணக்குகள் channel.* பயன்படுத்துகின்றன; எனவே எண்களுக்காக எழுதப்பட்ட ஒரு ரிசீவர் channel நிகழ்வுகளைப் பெயரால் தவிர்க்கலாம். டாஷ்போர்டில் Profile, பின்னர் Developers என்ற வழியில் எண்ட்பாயிண்டை அமையுங்கள், அல்லது MCP கருவி set_partner_events_url மூலம்; கையொப்பமிடும் ரகசியம் URL சேமிக்கப்படும்போது ஒருமுறை மட்டுமே காட்டப்படும்.
இணைப்பு நிகழ்வில் என்ன இருக்கும்?
டெலிவரியின் id (UUID), நிகழ்வின் பெயர், ISO 8601 வடிவில் occurred_at, மற்றும் id, external_ref, connect_session_id, phone, name, waba_id, phone_number_id, status, token_ready ஆகியவற்றைக் கொண்ட இணைப்புப் பொருள். சில நிகழ்வுகள் மேல்மட்டப் புலத்தையும் சேர்க்கும்: connection.disconnected மற்றும் connection.suspended-இல் reason; easyCoexistence-இன் சொந்தத் தொடர் சரிபார்ப்பு, Meta-வின் வெப்ஹூக்குக்குப் பதிலாக, துண்டிப்பைக் கண்டறிந்தால் detected_by மதிப்பு health_check; இணைப்பு அமர்வு நிகழ்வை உருவாக்கினால் connect_session_id.
{
"id": "5c2a9e70-…",
"event": "connection.disconnected",
"occurred_at": "2026-10-31T10:15:02.114Z",
"connection": {
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "disconnected",
"token_ready": true
},
"reason": "PRIMARY_INACTIVITY"
}சேனல் நிகழ்வில் என்ன இருக்கும்?
அதே அமைப்பு, இணைப்புப் பொருளுக்குப் பதிலாக channel பொருளுடன். இது GET /channels/{id} காட்சி: id, channel (நெட்வொர்க்), external_ref, connect_session_id, name, username, external_id, status, token_ready, webhook_url, disconnected_reason, last_checked_at, created_at. சேனல்களுக்கு token_missing இல்லை, ஏனெனில் சமூக உள்நுழைவு எப்போதும் வாடிக்கையாளரின் சொந்த டோக்கனையே தருகிறது. இணைப்பு அமர்விலிருந்து வரும் channel.connected நிகழ்வும் மேல்மட்டத்தில் connect_session_id-ஐக் கொண்டிருக்கும்.
{
"id": "0b7e41d2-…",
"event": "channel.disconnected",
"occurred_at": "2026-10-31T10:15:02.114Z",
"channel": {
"id": "<CHANNEL_ID>",
"channel": "tiktok",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"name": "Clínica Sorriso",
"username": "clinicasorriso",
"external_id": "<TIKTOK_OPEN_ID>",
"status": "disconnected",
"token_ready": false,
"webhook_url": "https://hooks.example.com/social",
"disconnected_reason": "<THE_NETWORK'S_MESSAGE>",
"last_checked_at": "2026-10-31T10:15:02.000Z",
"created_at": "2026-10-28T16:40:09.000Z"
}
}துண்டிப்புக் காரணங்களின் பொருள் என்ன?
connection.disconnected-இல் உள்ள reason என்பது, WhatsApp Business ஆப் மற்றும் Cloud API ஆகிய இரண்டிலும் உள்ள எண்களுக்கு Meta சேர்க்கும், account_update வெப்ஹூக்கின் disconnection_info-இல் Meta வைத்த குறியீடு. Meta எதுவும் தராவிட்டால் அது null. Meta-வின் குறிப்பில் உள்ள குறியீடுகள்:
PRIMARY_INACTIVITY: WhatsApp Business ஆப்பை இயக்கும் தொலைபேசி சுமார் 14 நாட்களுக்குச் செயலற்று இருந்தது, இது 14 நாள் விதி. புதிய இணைப்பு அமர்வு எண்ணை மீண்டும் இணைக்கும்.ACCOUNT_DISCONNECTED: Meta-வின் அமலாக்கத்தின் மூலமாகவோ அல்லது வாடிக்கையாளரின் மூலமாகவோ கணக்கு துண்டிக்கப்பட்டது; அவர் அணுகலை நீக்கி இருக்கலாம் அல்லது கணக்கை அழித்திருக்கலாம்.COMPANION_INACTIVITY: துணைச் சாதனம் சுமார் 30 நாட்களுக்குச் செயலற்று இருந்தது.BUSINESS_DOWNGRADE: எண் நுகர்வோர் WhatsApp ஆப்புடன் பதிவு செய்யப்பட்டிருந்தது.CHANGE_NUMBERமற்றும்USER_RE_REGISTERED: வாடிக்கையாளர் எண்ணை மாற்றினார், அல்லது புதிய சாதனத்தில் மீண்டும் பதிவு செய்தார்.
ஸ்டேட்டஸ் நிகழ்வுடன் எந்த ஹெடர்கள் வருகின்றன?
ஐந்து, ஒவ்வொரு முயற்சியிலும்: Content-Type application/json, User-Agent easyCoexistence-webhooks/1, நிகழ்வின் பெயருடன் X-EC-Event, உடலில் உள்ள அதே id-உடன் X-EC-Delivery, மற்றும் X-EC-Signature. கையொப்பம் t=<unix>,v1=<hex> என இருக்கும்; v1 என்பது t, புள்ளி மற்றும் மூல உடல் ஆகியவற்றின் HMAC-SHA256, உங்கள் கணக்கின் கையொப்பமிடும் ரகசியத்தை (whsec_ என்று தொடங்கும்) விசையாகக் கொண்டு குறியிடப்பட்டது. ஒவ்வொரு முயற்சியும் புதிதாகக் கையொப்பமிடப்படும், எனவே மறுமுயற்சி அதே உடலின் மேல் புதிய t-ஐக் கொண்டிருக்கும்.
import hashlib, hmac, json, os, time
SECRET = os.environ["EC_EVENTS_SECRET"].encode() # whsec_..., shown once in Profile > Developers
def verify(raw: bytes, header: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, v1 = parts.get("t", ""), parts.get("v1", "")
if not t.isdigit() or abs(time.time() - int(t)) > 300:
return False # missing, or more than 5 minutes off
mac = hmac.new(SECRET, t.encode() + b"." + raw, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, v1)
def handle(raw: bytes, headers) -> int:
if not verify(raw, headers.get("X-EC-Signature", "")):
return 401
event = json.loads(raw)
if already_processed(event["id"]): # the X-EC-Delivery id, the same on every retry
return 200
enqueue(event) # act on event["event"]; the latest occurred_at wins
return 200தோல்வியடைந்த டெலிவரிகள் எப்படி மறுமுயற்சி செய்யப்படுகின்றன?
முதல் முயற்சி நிகழ்வு நடக்கும்போதே அனுப்பப்படும். 2xx அல்லாத பதில், 10 வினாடிக்குள் பதில் இல்லாதது, பிணைய பிழை அல்லது திருப்பிவிடல் ஆகியவை தோல்வியாகக் கருதப்படும்; நிகழ்வு 1 நிமிடம் முதல் 24 மணி நேரம் வரை அதிகரிக்கும் இடைவெளிகளில், மொத்தம் ஏழு முயற்சிகளில், சுமார் 33 மணி நேரத்தில், கைவிடப்படும் முன் மீண்டும் முயற்சிக்கப்படும். டெலிவரிகள் பொது IP-க்குத் தீர்க்கப்படும் HTTPS முகவரிக்கு மட்டுமே செல்லும். எண்ட்பாயிண்ட் அமைக்கப்படாத நேரத்தில் நடக்கும் நிகழ்வு ஒருபோதும் வரிசையில் வைக்கப்படாது, எண்ட்பாயிண்டை நீக்குவது நிலுவையிலுள்ள அனைத்தையும் நிறுத்தும்.
ஒவ்வொரு id-ஐயும் ஒருமுறை கையாள்வதும் occurred_at-ஐச் சரிபார்ப்பதும் ஏன்?
ஏனெனில் மறுமுயற்சி டெலிவரியை அப்படியே மீண்டும் அனுப்புகிறது, உடலிலும் X-EC-Delivery-யிலும் அதே id-உடன்; மேலும் மறுமுயற்சி செய்யப்பட்ட நிகழ்வு ஒரு புதிய நிகழ்வுக்குப் பின் வரக்கூடும். செயலாக்கிய id-களைச் சேமித்து, மீண்டும் வருவனவற்றைத் தவிர்க்கவும். பின்னர் occurred_at-ஐ அந்த இணைப்புக்காகப் பதிவு செய்த கடைசி நிலையுடன் ஒப்பிடுங்கள், அல்லது பழையதாக இருக்கக்கூடிய நிகழ்வின்மீது செயல்படும் முன் GET /connections/{id} அல்லது GET /channels/{id}-ஐப் படியுங்கள்.
எண் துண்டிக்கப்பட்டால் தளம் என்ன செய்ய வேண்டும்?
காரணத்தின்படி செயல்படுங்கள். PRIMARY_INACTIVITY-க்குப் பிறகு, WhatsApp Business ஆப்பைத் திறக்குமாறு வாடிக்கையாளரிடம் கேட்டு, அதே எண்ணுக்கு ஒரு புதிய இணைப்பு அமர்வை அனுப்புங்கள். அதே WhatsApp Business கணக்கில் மீண்டும் இணைப்பது அதன் இணைப்பு ID-ஐ வைத்திருக்கும், உங்கள் வெப்ஹூக் இலக்கை மீண்டும் அமைக்கும், connection.connected-ஐ அனுப்பும்; அதன் பின் அதன் நற்சான்றுகளை மீண்டும் படியுங்கள். connection.token_missing என்றால் அந்த முயற்சியில் Meta டோக்கன் வழங்கவில்லை என்று பொருள். துண்டிப்பின் பின்னால் உள்ள account_update-ஐ Meta உங்கள் URL-க்கு அல்ல, ஆப்பின் சொந்த கால்பேக்குக்கு மட்டுமே அனுப்புகிறது; எனவே இந்த நிகழ்வே உங்கள் தளம் அதை அறியும் வழி.
சமூகக் கணக்கு துண்டிக்கப்பட்டால் தளம் என்ன செய்ய வேண்டும்?
channel.disconnected-இல், அதே சேனலுடன் ஒரு புதிய இணைப்பு அமர்வு, அதே சேனல் ID-இன் கீழ் கணக்கை மீண்டும் உள்நுழைக்கும். channel.removed என்றால் அணுகல் போய்விட்டது என்று பொருள்: டோக்கன் மறக்கப்படும், வெப்ஹூக் இலக்கு அழிக்கப்படும், எனவே வாடிக்கையாளர் மீண்டும் இணைந்தால் இலக்கை மீண்டும் அமையுங்கள். இடைநிறுத்தப்பட்ட எண் அல்லது சேனல், உங்கள் சந்தா மீண்டும் செயலில் வந்ததும் ஒருமுறை மீண்டும் இணைப்பதன் மூலம் திரும்பும்.
பொதுவான தவறுகள்
- நிகழ்வை புதிய நிகழ்வாகக் கருதுவது. மறுமுயற்சியில் உடலிலும் X-EC-Delivery-யிலும் அதே id இருக்கும், எனவே செயலாக்கிய id-களைப் பதிவு செய்யுங்கள், இல்லையெனில் ஒரே துண்டிப்பு வாடிக்கையாளருக்கு இருமுறை எச்சரிக்கை அனுப்பலாம்.
- நிகழ்வுகளை வந்த வரிசைப்படி செயலாக்குவது. மறுமுயற்சி செய்யப்பட்ட நிகழ்வு புதியதற்குப் பின் வரக்கூடும், எனவே occurred_at-ஐ ஒப்பிடுங்கள், அல்லது செயல்படும் முன் இணைப்பைப் படியுங்கள்.
- எழுத்துப் பிழையைச் சரிசெய்ய நிகழ்வுகள் URL-ஐ மீண்டும் சேமிப்பது, பின்தளத்தைப் புதுப்பிக்காமல். சேமிப்பது புதிய கையொப்பமிடும் ரகசியத்தை வழங்கும், உங்கள் எண்ட்பாயிண்ட் அதைப் பயன்படுத்தும் வரை ஒவ்வொரு டெலிவரியும் சரிபார்ப்பில் தோல்வியடையும்.
- பதில் அளிக்கும் முன் வேலை செய்வது. 10 வினாடிக்கு மேல் எடுக்கும் கையாளுதல் தோல்வியாகக் கருதப்படும், நிகழ்வு திரும்ப வரும், எனவே முதலில் 2xx பதிலளித்து பின்னர் செயலாக்குங்கள்.
easyCoexistence, ஒவ்வொரு வாடிக்கையாளரின் WhatsApp எண்ணையும் சமூகக் கணக்குகளையும் இடைவிடாமல் கண்காணிக்கிறது; ஒன்று இணைந்தாலோ, துண்டிக்கப்பட்டாலோ, அகற்றப்பட்டாலோ அல்லது இடைநிறுத்தப்பட்டாலோ, உங்கள் தளத்துக்குக் கையொப்பமிட்ட நிகழ்வை அனுப்புகிறது, துண்டிக்கப்படும் எண்ணுக்கு Meta-வின் காரணத்துடன். ஒரு இணைப்புக்கு மாதத்துக்கு US$ 9 முதல் US$ 0.75 வரை, இணைப்புகளைச் சேர்க்கச் சேர்க்கக் குறைகிறது, முதல் 7 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
PRIMARY_INACTIVITY என்றால் என்ன?
இது Coexistence எண்ணைத் துண்டிப்பதற்கான Meta-வின் காரணம்; அந்த வாடிக்கையாளரின் WhatsApp Business ஆப் முதன்மைச் சாதனத்தில் சுமார் 14 நாட்களாகப் பயன்படுத்தப்படாமல் இருந்தது. அந்த வாடிக்கையாளருக்கான புதிய இணைப்பு அமர்வு எண்ணை மீண்டும் இணைக்கும்.
ஸ்டேட்டஸ் நிகழ்வுகளில் மெசேஜ்கள் இருக்குமா?
இல்லை. அவை இணைப்பின் ஸ்டேட்டஸ் பற்றியவை மட்டுமே. ஒரு எண்ணின் மெசேஜ்கள் Meta-விலிருந்து அதன் சொந்த வெப்ஹூக் இலக்குக்குச் செல்லும்; சமூகக் கருத்துகளும் நேரடி மெசேஜ்களும் (DM) ஒவ்வொரு சேனலின் இலக்குக்குச் செல்லும்.
நிகழ்வுகள் URL-ஐ எங்கே அமைப்பது?
டாஷ்போர்டில் Profile, பின்னர் Developers என்ற வழியில், அல்லது MCP கருவி set_partner_events_url மூலம். கையொப்பமிடும் ரகசியம் ஒருமுறை மட்டுமே காட்டப்படும், URL-ஐ மீண்டும் சேமித்தால் புதியது வழங்கப்படும்.
எண்களை மட்டும் கையாண்டால் சேனல் நிகழ்வுகளைப் புறக்கணிக்கலாமா?
ஆம். channel.* நிகழ்வுகளுக்கு தனிப் பெயர்கள் உண்டு, இணைப்புப் பொருளுக்குப் பதிலாக channel பொருளைக் கொண்டிருக்கும்; எனவே பெயர் connection என்று தொடங்காத எந்த நிகழ்வையும் ரிசீவர் தவிர்க்கலாம்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: