உங்கள் பயனர்கள் WhatsApp, Instagram மற்றும் TikTok கணக்குகளை உங்கள் ஆப்ஸுடன் இணைப்பது எப்படி
உங்கள் பயனர்கள் WhatsApp, Instagram மற்றும் TikTok கணக்குகளை உங்கள் ஆப்ஸுடன் இணைக்க, easyCoexistence-இன் Partner API-இல் ஓர் இணைப்பு அமர்வை உருவாக்கி, பயனரை அதன் ஹோஸ்ட் செய்யப்பட்ட URL-க்கு அனுப்புங்கள். அங்கே அவர்கள் Meta-வின் Embedded Signup மூலம் WhatsApp எண்ணை இணைக்கலாம், அல்லது Instagram, Facebook, TikTok, YouTube, LinkedIn மற்றும் இன்னும் பல சேனல்களில் உள்நுழையலாம்; பின்னர் புதிய இணைப்பு அல்லது channel id-உடன் உங்கள் redirect_url-க்குத் திரும்புவார்கள். லிங்க்குகள் ஒரு மணி நேரம் செயல்படும்.
ஒரு இணைப்பு லிங்க் எவ்வளவு நேரம் செயல்படும்; அதன் பிறகு அமர்வு காலாவதியானதாகக் காட்டும், புதிய லிங்க் தேவைப்படும்.
ஒரு கணக்கு ஒரே நேரத்தில் திறந்திருக்கக்கூடிய இணைப்பு அமர்வுகள், அதனருகே ஒரு மணி நேரத்திற்கு 100 புதிய அமர்வுகள் என்ற வரம்புடன்.
GET /connect-sessions/:id அறிக்கை செய்வது போல், அமர்வு உருவாக்கப்படும், திறக்கப்படும், இணைக்கப்படும், ரத்து செய்யப்படும் அல்லது காலாவதியாகும்.
ஒரு WhatsApp எண்ணின் மெசேஜ் வெப்ஹூக்குகளை வேறிடத்துக்குத் திருப்பிவிட Meta ஏற்கும் மிக நீளமான மாற்று callback URL.
இணைப்பு லிங்க் எப்படி வேலை செய்கிறது?
செக்அவுட் பக்கம் போல. உங்கள் சர்வர் ஓர் அமர்வை உருவாக்கும், உங்கள் இடைமுகம் பயனரை அதன் URL-க்கு அனுப்பும், பயனர் easycoexistence.com-இல் உள்ள பக்கத்தில் இணைவார், உலாவி உங்கள் redirect_url-க்குத் திரும்பும். பின்னர் உங்கள் சர்வர் முடிவை உறுதிசெய்து, உங்கள் API key மூலம் புதிய இணைப்பின் நற்சான்றுகளைப் பெறும்.
கோரிக்கையில் என்ன இருக்க வேண்டும்?
https://easycoexistence.com/api/v1/connect-sessions முகவரிக்கு அனுப்பப்படும் JSON பாடி, உங்கள் API key ஒரு Bearer டோக்கனாக. redirect_url மட்டுமே கட்டாயம்:
redirect_url: பயனர் பின்னர் வந்தடையும் ஒரு https URL.- channel: whatsapp, இயல்புநிலை; அல்லது உங்கள் கணக்கில் திறந்திருக்கும் ஒரு சமூக வலைத்தளம், அதன் சிறிய எழுத்துப் பெயரால், எடுத்துக்காட்டாக instagram, tiktok அல்லது youtube.
external_ref: இந்த வாடிக்கையாளருக்கான உங்கள் சொந்த id, 200 எழுத்துகள் வரை.partner_name: ஹோஸ்ட் பக்கம் காட்டும் பெயர், 80 எழுத்துகள் வரை; இயல்பாக உங்கள் கணக்கின் பெயர்.webhook_urlஉடன்webhook_verify_token: எண்களுக்கு மட்டும், எப்போதும் ஒன்றாக. இணைந்த தருணத்திலிருந்தே Meta அந்த எண்ணின் மெசேஜ்களை அங்கு அனுப்பும்.
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "whatsapp",
"redirect_url": "https://app.example.com/connect/return",
"external_ref": "customer_4821",
"partner_name": "ClinicApp",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"webhook_verify_token": "another-long-random-string"
}'என்ன திரும்பக் கிடைக்கும்?
201 பதிலுடன் அமர்வு கிடைக்கும். பயனரை url-க்கு அனுப்புங்கள், பின்னர் அமர்வைத் தேட cs_ எனத் தொடங்கும் id-ஐ வைத்திருங்கள். expires_at உருவாக்கிய ஒரு மணி நேரத்தில் காலாவதியாகும், பயனர் இணைந்ததும் அமர்வின் சேனலைப் பொறுத்து connection_id அல்லது channel_id நிரம்பும். GET /connect-sessions/:id எந்த நேரத்திலும் அதே வடிவத்தைத் தரும்.
{
"id": "cs_…",
"url": "https://easycoexistence.com/connect/cs_…",
"channel": "whatsapp",
"status": "created",
"external_ref": "customer_4821",
"connection_id": null,
"channel_id": null,
"token_ready": false,
"redirect_url": "https://app.example.com/connect/return",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"last_error": null,
"expires_at": "2026-10-31T15:00:00.000Z",
"opened_at": null,
"finished_at": null,
"created_at": "2026-10-31T14:00:00.000Z"
}அமர்வை உருவாக்கும்போது என்ன பிழைகள் வரலாம்?
ஒவ்வொரு பிழைக்கும் ஒரே உடல் வடிவம்: code மற்றும் message கொண்ட ஒரு பொருள், message என்ன சரிசெய்ய வேண்டும் என்று சொல்லும். அமர்வை உருவாக்குவது இவற்றைத் திருப்பலாம்:
- 400
invalid_jsonஅல்லதுinvalid_request: பாடி JSON பொருளாக இல்லை, அல்லது ஒரு புலம் சரிபார்ப்பில் தோல்வியடைந்தது, எடுத்துக்காட்டாக https அல்லாதredirect_url. - 400
channel_unavailable: இந்தக் கணக்கில் இந்தச் சேனல் திறக்கப்படவில்லை; திறந்திருப்பவற்றை மெசேஜ் பட்டியலிடும். - 401 unauthorized: API key இல்லை அல்லது தவறானது.
- 402
billing_required: கணக்கில் இன்னும் கார்டு இல்லை; அதன் மூலம் இணைக்கப்படும் அனைத்துக்கும் அதற்கே கட்டணம் வசூலிக்கப்படும். - 429
cap_reached: ஏற்கனவே 50 அமர்வுகள் திறந்துள்ளன; சில முடியும் அல்லது காலாவதியாகும் வரை காத்திருங்கள். - 429
rate_limited: இந்த மணி நேரத்தில் 100-க்கு மேல் அமர்வுகள்; எவ்வளவு நேரம் காத்திருக்க வேண்டும் என்று மெசேஜ் சொல்லும்.
பயனர் பின்னர் எங்கே வந்தடைவார்?
உங்கள் redirect_url-இல், அதன் க்வெரி ஸ்ட்ரிங்கில் முடிவு சேர்க்கப்பட்டு. அதே முடிவு அமர்வில் இருக்கும், அதை உங்கள் சர்வர் GET /connect-sessions/:id மூலம் படிக்கும்:
- session: அமர்வு id, cs_ மற்றும் அதைத் தொடர்ந்து சீரற்ற எழுத்துகள்.
- status: பயனர் Cancel and go back-ஐத் தேர்ந்தெடுத்தால் cancelled, இல்லையெனில் connected.
external_ref: அமர்வில் அது இருந்தால், வாடிக்கையாளருக்கான உங்கள் id.connection_id: புதிய எண்ணின் id, /connections-க்காக.channel_id: புதிய சமூக ஊடகக் கணக்கின் id, /channels-க்காக.
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…அமர்வுக்கு என்ன நிலைகள் இருக்கலாம்?
ஐந்து. GET /connect-sessions/:id தற்போதைய நிலையை அறிக்கை செய்கிறது, opened_at, finished_at மற்றும் last_error உடன்; கடைசி முயற்சி ஏன் தோல்வியடைந்தது என்று last_error சொல்லும்:
- created: உங்கள் சர்வர் உருவாக்கியது, இன்னும் திறக்கப்படவில்லை.
- opened: பயனர் ஹோஸ்ட் பக்கத்தை ஏற்றிவிட்டார்.
- connected: ஓர் எண் அல்லது சமூக ஊடகக் கணக்கு இணைந்தது, அதன் id அமர்வில் உள்ளது.
- cancelled: பயனர் Cancel and go back வழியாக வெளியேறினார்.
- expired: அமர்வு முடிவதற்குள் ஒரு மணி நேரம் முடிந்துவிட்டது.
லிங்க் எவ்வளவு நேரம் செயல்படும்?
உருவாக்கியதிலிருந்து ஒரு மணி நேரம். அதன் பிறகு ஹோஸ்ட் பக்கம் லிங்க் காலாவதியானது என்று பயனருக்குச் சொல்லும், status=cancelled எனக் குறிக்கப்பட்ட உங்கள் redirect_url-க்குத் திரும்பும் பொத்தானுடன்; அமர்வு expired எனக் காட்டும். ஒரு கணக்கு 50 திறந்த அமர்வுகளை வைத்திருக்கலாம், ஒரு மணி நேரத்தில் 100 உருவாக்கலாம்; ஏனெனில் ஒவ்வொரு முதல் முறை ஆன்போர்டிங்கையும் Meta, எல்லாக் கணக்குகளும் பகிரும் ஆப் அளவிலான வரம்புக்கு எதிராக எண்ணுகிறது.
external_ref என்ன செய்கிறது?
ஒவ்வொரு இணைப்பையும் உங்கள் வாடிக்கையாளருடன் இணைக்கிறது. நீங்கள் அனுப்பும் மதிப்பு, அமர்வு உருவாக்கும் எண் அல்லது சேனலில் சேமிக்கப்படும், திருப்பிவிடலில் சேர்க்கப்படும், அது பற்றிய ஒவ்வொரு ஸ்டேட்டஸ் நிகழ்விலும் சேர்க்கப்படும். எனவே GET /connections?external_ref=customer_4821 மற்றும் GET /channels?external_ref=customer_4821 அந்த வாடிக்கையாளர் இணைத்தவற்றைப் பட்டியலிடும். Facebook அல்லது LinkedIn உள்நுழைவு ஒரே நேரத்தில் பல Pages-ஐக் கொண்டு வரலாம்: திருப்பிவிடல் முதலாவதைக் குறிப்பிடும், வடிகட்டி மீதமுள்ளவற்றைப் பட்டியலிடும். உங்கள் தரவுத்தளத்திலிருந்து நிலையான id-ஐப் பயன்படுத்துங்கள், மாறக்கூடிய மின்னஞ்சலை அல்ல.
பயனர் ரத்து செய்தால் அல்லது உள்நுழைவு தோல்வியடைந்தால் என்ன?
அது எங்கே நிகழ்ந்தது என்பதைப் பொறுத்தது; அமர்வு பதிவை வைத்திருக்கும்:
- Meta-வின் பாப்-அப் தோல்வியடைந்தாலோ மூடப்பட்டாலோ: லிங்க் திறந்திருக்கும் வரை அதே பக்கத்தில் பயனர் மீண்டும் Connect அழுத்த வேண்டும்.
- சமூக உள்நுழைவு ரத்தாகியோ மறுக்கப்பட்டோ இருந்தால்: பயனர் காரணத்துடன் ஹோஸ்ட் பக்கத்துக்குத் திரும்புவார், லிங்க் காலாவதியாகும் வரை மீண்டும் முயலலாம்.
- கணக்கு வேறொரு easyCoexistence கணக்கு வழியாக ஏற்கனவே இணைந்திருந்தால்:
last_errorஅதைச் சொல்லும், பயனர் வேறொரு கணக்குடன் உள்நுழைய வேண்டும். - பயனர் Cancel and go back-ஐத் தேர்ந்தெடுத்தால்: உங்கள்
redirect_urlstatus=cancelled பெறும், அமர்வு மூடப்படும்; மற்றொரு முயற்சிக்கு புதியதை உருவாக்குங்கள். - லிங்க் காலாவதியானால்: புதிய அமர்வை உருவாக்குங்கள்.
பயனரின் டோக்கன் இல்லாமல் எண் இணைந்தால் என்ன?
Meta சில நேரங்களில் Embedded Signup-ஐ பயனரின் சொந்த வணிக டோக்கனை வழங்காமல் முடிக்கும். அப்போது ஹோஸ்ட் பக்கம் இன்னொரு முறை கேட்கும், அது சில நொடிகள் ஆகும். பயனர் அதைத் தவிர்த்தால், அமர்வு token_ready false உடன் connected எனக் காட்டும், உங்கள் நிகழ்வுகள் URL connection.token_missing பெறும்: id-கள் சரியானவை என்பதால் எண் மெசேஜ்களைப் பெறும், ஆனால் புதிய இணைப்பு அமர்வு அதை மீண்டும் இணைத்து டோக்கனை வழங்கும் வரை அனுப்ப முடியாது.
webhook_url Meta-வின் சோதனையில் தோல்வியடைந்தால் என்ன?
எண் இன்னும் இணையும். Meta webhook_url-ஐ GET கைகுலுக்கல் மூலம் சோதிக்கும்; hub.verify_token பொருந்தினால் உங்கள் எண்ட்பாயிண்ட் hub.challenge-ஐ திருப்பி அனுப்பி அதைத் தாண்டும். தோல்வியடைந்தால், அமர்வின் last_error webhook_url was not applied என்று தொடங்கி Meta-வின் காரணத்தைத் தரும்; எண்ட்பாயிண்ட் பதிலளித்ததும் PUT /connections/:id/webhook இலக்கை அமைக்கும். இணைந்த 24 மணி நேரத்திற்குள் அமைத்தால், ஒரு முறை நடக்கும் தொடர்புகள் இறக்குமதியையும், பயனர் பகிர ஒப்புக்கொண்டால் அரட்டை வரலாற்றையும் அது பெறும்.
பயனர் என்ன பார்ப்பார்?
easycoexistence.com-இல் உள்ள பக்கம், partner_name-இலிருந்து உங்கள் பெயருடன், நிரப்ப கணக்கு, மின்னஞ்சல் அல்லது கார்டு எதுவும் இல்லை. WhatsApp எண்ணுக்கு, சுருக்கமான தகுதிப் பட்டியல், பின்னர் Meta-வின் பாப்-அப், WhatsApp Business ஆப்ஸில் ஸ்கேன் செய்ய ஒரு QR குறியீடு. சமூகக் கணக்குக்கு, Continue with TikTok போன்ற ஒரே பொத்தான் காட்டும்; அது அதே டேபில் நெட்வொர்க்கின் சொந்த ஒப்புதல் திரையைத் திறக்கும், எனவே கைபேசிகளிலும் வேலை செய்யும்.
பொதுவான தவறுகள்
- க்வெரி ஸ்ட்ரிங்கை மட்டும் நம்புவது. எவரும் URL-இல் status=connected என தட்டச்சு செய்யலாம், எனவே பயனரை இணைந்ததாகக் குறிப்பதற்கு முன் உங்கள் சர்வரிலிருந்து GET /connect-sessions/:id மூலம் உறுதிசெய்யுங்கள்.
- லிங்கை iframe-இல் உட்பொதிப்பது. redirect அல்லது புதிய டேப் மூலம் பயனருக்கு அனுப்புங்கள்; ஹோஸ்ட் பக்கமும் அது திறக்கும் உள்நுழைவுகளும் அப்படித்தான் இயங்க வேண்டும்.
- முன்கூட்டியே லிங்குகளை உருவாக்குவது. ஒவ்வொன்றும் ஒரு மணி நேரம் செயல்படும், திறந்திருக்கும் ஒவ்வொன்றும் 50 வரம்பில் கணக்கிடப்படும்; எனவே பயனர் இணையப் போகும் போது அமர்வை உருவாக்குங்கள்.
- 200 எழுத்துகளுக்கு மேல் webhook_url அனுப்புவது. Meta 200 எழுத்துகள் வரையிலான மாற்று callback URL-களை ஏற்கும்; நீளமானது அமல்படுத்தப்படாது, எண் அது இல்லாமலேயே இணையும்.
easyCoexistence உங்கள் பயனர்களின் WhatsApp எண்களையும் அவர்களின் Instagram, Facebook, TikTok, YouTube மற்றும் LinkedIn கணக்குகளையும், இன்னும் பல சேனல்களையும், ஒரே ஹோஸ்ட் லிங்க் மூலம் உங்கள் மென்பொருளுடன் இணைக்கிறது; பின்னர் உங்கள் சர்வருக்கு ஒவ்வொரு இணைப்பின் நற்சான்றுகள், வெப்ஹூக்குகள் மற்றும் கையொப்பமிட்ட ஸ்டேட்டஸ் நிகழ்வுகளை வழங்குகிறது. ஓர் இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, இணைப்புகளைச் சேர்க்கச் சேர்க்கக் குறையும்; முதல் 3 நாட்கள் இலவச ட்ரையலுடன்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
ஒரே இணைப்பு லிங்கை இரண்டு முறை பயன்படுத்தலாமா?
இல்லை. ஒரு லிங்க் ஓர் எண்ணுடனோ அல்லது ஒரே சமூக உள்நுழைவுடனோ முடியும், அது Facebook அல்லது LinkedIn-இல் பல Pages-ஐக் கொண்டு வரலாம். அதன் பிறகு அது connected எனக் காட்டும்; அடுத்த இணைப்புக்கு புதிய அமர்வை உருவாக்குங்கள்.
லிங்கை மின்னஞ்சல் அல்லது சாட் மூலம் அனுப்பலாமா?
ஆம், பயனர் அதை ஒரு மணி நேரத்திற்குள் திறக்கும் வரை. URL-இல் உள்ள அமர்வு id தான் பக்கத்தை அங்கீகரிக்கிறது, எனவே ஒவ்வொரு லிங்கையும் அது உருவாக்கப்பட்ட பயனருக்கு மட்டுமே அனுப்புங்கள்.
ஹோஸ்ட் பக்கம் கைபேசிகளில் வேலை செய்யுமா?
சமூக உள்நுழைவுகள் செய்யும், ஏனெனில் அவை அதே டேபில் திறக்கும். WhatsApp எண்ணை கணினியிலிருந்து இணைப்பது சிறந்தது: கைபேசியில் Meta-வின் பாப்-அப் புதிய டேபாகத் திறக்கும், QR குறியீட்டை ஸ்கேன் செய்ய கைபேசி தேவை.
தொடர்ந்து சரிபார்க்காமல் பயனர் இணைந்ததை எப்படி அறிவது?
டாஷ்போர்டில் Profile, Developers என்பதன் கீழ் ஸ்டேட்டஸ் நிகழ்வுகள் URL-ஐ அமையுங்கள். இணைப்பு உருவானவுடன் easyCoexistence connection.connected அல்லது channel.connected ஐ அனுப்பும்; அது கையொப்பமிட்டு உங்கள் external_ref-ஐக் கொண்டிருக்கும்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: