நீங்கள் ஏற்கெனவே பயன்படுத்தும் மென்பொருளுடன் LumaKol-ஐ இணைத்தல்

ஒரு வணிகம் இயக்கும் ஒரே அமைப்பு எந்த CRM-உம் அல்ல. ஒரு கணக்கியல் மென்பொருள், ஒரு இணையதளம், ஒரு டிக்கெட் கருவி, ஒரு கிடங்கு அமைப்பு, 2019-இல் யாரோ உருவாக்கி இன்னும் எல்லோரும் சார்ந்திருக்கும் ஒரு ஸ்ப்ரெட்ஷீட் — இவை எல்லாம் இருக்கின்றன. இவற்றில் எதனுடனும் பேச முடியாத CRM இன்னொரு தீவாகிவிடுகிறது; தீவுகளுக்கு இடையிலான பாலம், நாள் முடிவில் வரிசைகளைக் கையால் நகலெடுக்கும் ஒரு நபராகிவிடுகிறது.

LumaKol-இல் இப்போது பொது API-யும் வெளிச்செல்லும் webhooks-உம் உள்ளன. இரண்டும் சேர்ந்து இரு திசைகளையும் உள்ளடக்குகின்றன: உங்களுக்குத் தேவைப்படும்போது LumaKol-இடம் தரவைக் கேட்கலாம்; ஏதாவது நடந்த கணமே LumaKol உங்களுக்குச் சொல்லலாம். இந்தப் பதிவு ஒரு குறிப்புக் கையேடு அல்ல; அவை எப்படி உருவாக்கப்பட்டுள்ளன, எதைப் பயன்படுத்துவது என்று எப்படி முடிவு செய்வது என்பதைப் பற்றியது — endpoint பட்டியல், நீங்கள் கீகளை உருவாக்கும் இடத்துக்கு அருகில், செயலியின் டெவலப்பர் பகுதியில் உள்ளது.

கீகள் ஒரு நபருக்கு அல்ல, பணியிடத்துக்குச் சொந்தமானவை

இதுதான் முதல் வடிவமைப்பு முடிவு; ஒரு திங்கள் காலையைக் காப்பாற்றுவதும் இதுதான். LumaKol-இல் வழங்கப்படும் API கீ பணியிடத்துக்குச் சொந்தமானது. அதை உருவாக்கிய டெவலப்பர் நிறுவனத்தை விட்டு வெளியேறி, அவரது கணக்கு முடக்கப்படும்போது, அவர் உருவாக்கிய ஒருங்கிணைப்பு தொடர்ந்து இயங்குகிறது: கீ அதன் உருவாக்கியவருடன் சேர்ந்து செயலிழக்காமல், பணியிட உரிமையாளராகச் செயல்படுவதற்கு மாறுகிறது.

தனிப்பட்ட உள்நுழைவின் மீது கட்டப்பட்ட ஒருங்கிணைப்பை இயக்கிய எவருக்கும் இது ஏன் முக்கியம் என்று தெரியும். அந்த நபர் வெளியேறிச் சில வாரங்கள் கழித்து அந்த ஒருங்கிணைப்புகள் சத்தமில்லாமல் தோல்வியடைகின்றன; பிரச்சினையின் முதல் அறிகுறி, ஓட்டை விழுந்த ஒரு அறிக்கைதான்.

வரம்புகள் (scopes)

ஒரு கீ, அது என்ன செய்யலாம் என்பதற்கான வெளிப்படையான பட்டியலுடன் வழங்கப்படுகிறது; வேறு எதையும் செய்ய முடியாது:

ஒவ்வொரு ஒருங்கிணைப்புக்கும், வேலையைச் செய்யும் மிகச் சிறிய scope-உடன் தனிக் கீயைக் கொடுங்கள். வரைபடங்களை மட்டும் வரையும் டாஷ்போர்டுக்கு leads:read, calls:read கிடைக்கும்; கீ போகக்கூடாத இடத்துக்குப் போனாலும் அது எந்தச் சேதமும் செய்ய முடியாது. இணையதளப் படிவக் கையாளிக்கு leads:write கிடைக்கும்; அது உங்கள் அழைப்பு வரலாற்றைப் படிக்க முடியாது. கீயை உருவாக்கும்போது இந்தப் பழக்கத்துக்கு எந்தச் செலவும் இல்லை; ஏதாவது தவறாகும் நாளில் அது மிகுந்த மதிப்புடையது.

சேமிப்பும் ரத்தும்

கீ உருவாக்கப்படும் கணத்தில் ஒருமுறை மட்டுமே காட்டப்படுகிறது, மீண்டும் ஒருபோதும் இல்லை. LumaKol சேமிப்பது அதன் ஒருவழி hash மட்டுமே; எனவே தரவுத்தளத்திலிருந்து அதை யாரும் — நாங்கள் உட்பட — திரும்பப் படிக்க முடியாது. அதைத் தொலைத்தால், புதியதை வழங்குவீர்கள்; வடிவமைப்பின்படியே மீட்பு வழி இல்லை.

ரத்து உடனடியானது. ரத்து என்பதை அழுத்தினால், அந்தக் கீயுடன் செய்யப்படும் அடுத்த கோரிக்கை மறுக்கப்படும். சலுகைக் காலமோ, பரவுவதற்காகக் காத்திருக்கும் தாமதமோ இல்லை — ஒரு லேப்டாப் காணாமல் போகும்போதோ, ஒப்பந்ததாரரின் பணி முடியும்போதோ உங்களுக்கு வேண்டியது அதுதான்.

கீகள் பணியிடத்தின் நிலையையும் மதிக்கின்றன. ஒரு பணியிடம் இடைநீக்கம் செய்யப்பட்டால், அதன் கீகள் முற்றிலும் வேலை செய்வதை நிறுத்துகின்றன. அது படிக்க மட்டுமான நிலையில் இருந்தால் — காலாவதியான சோதனை, ரத்து செய்யப்பட்ட திட்டம் — செயலியைப் போலவே, கீகள் GET கோரிக்கைகளுக்குத் தொடர்ந்து பதில் தருகின்றன, ஆனால் எழுதுவதை மறுக்கின்றன. ஒரு ஒருங்கிணைப்பு ஒருபோதும் கணக்கின் நிலையைச் சுற்றிச் செல்லும் பின்வாசலாக இருக்க முடியாது.

API-ஐ அளவுக்கு மீறி அழுத்தாமல் தரவைப் படித்தல்

அடிப்படை URL https://api.lumakol.com/api/v1. பட்டியல்கள் பக்க எண்களால் அல்லாமல் ஒரு கர்சரால் பக்கப்பிரிக்கப்படுகின்றன; இது தோன்றுவதைவிட முக்கியமானது.

ஒத்திசைவின்போது பக்க எண்கள் உடைகின்றன. நீங்கள் முதல் பக்கத்தைப் பெறுகிறீர்கள், யாரோ ஒரு லீடைப் புதுப்பிக்கிறார்கள், வரிசை மாறுகிறது, இரண்டாம் பக்கம் இப்போது நீங்கள் பார்க்காத ஒரு பதிவுக்குப் பிறகு தொடங்குகிறது. சில ஆயிரம் லீடுகளின் இரவு நேர ஒத்திசைவில், ஒவ்வொரு இரவும் சில பதிவுகள் விடுபடுகின்றன; அது நடந்தது என்பதற்கு எந்த அறிகுறியும் இல்லை. கர்சர் வரிசையில் ஒரு நிலையான இடத்தைச் சுட்டுகிறது; எனவே மக்கள் வேலை செய்துகொண்டிருக்கும்போதும், தொகுப்பைப் பக்கம் பக்கமாகப் படிப்பது ஒவ்வொரு பதிவையும் சரியாக ஒருமுறை தருகிறது.

ஒரு பட்டியல் பதிலில் வரிசைகள், அடுத்த கர்சர், இன்னும் மீதம் உள்ளதா என்று சொல்லும் ஒரு கொடி ஆகியவை உள்ளன. சுழற்சி இதுதான்: கோருங்கள், செயலாக்குங்கள், கர்சரைத் திருப்பி அனுப்புங்கள், கொடி false ஆகும் வரை மீண்டும் செய்யுங்கள். இதை updated-since வடிகட்டியுடன் இணைத்தால் படிப்படியான ஒத்திசைவு எளிதாகிறது — உங்கள் கடைசி வெற்றிகரமான ஓட்டத்துக்குப் பிறகு மாறிய அனைத்தையும் கேளுங்கள், பக்கம் பக்கமாகப் படியுங்கள், நேர முத்திரையைச் சேமியுங்கள், நிறுத்துங்கள். நிலை, உரிமையாளர், மூலம், குறிச்சொல், கட்டற்ற உரை ஆகியவற்றுக்கான வடிகட்டிகளும், உங்கள் சொந்த வெளிப்புற அடையாளங்காட்டி மூலம் தேடும் வசதியும் உள்ளன; எனவே ஒரு மேப்பிங் அட்டவணையை வைத்திருக்காமலேயே LumaKol-இன் லீடுகளை உங்கள் சொந்த அமைப்பில் உள்ள பதிவுகளுடன் பொருத்தலாம்.

Webhooks: எதிர்வினையாற்றத் தகுந்த ஆறு நிகழ்வுகள்

உடனே நடக்க வேண்டிய எதற்கும் போலிங் தவறான கருவி. ஒரு லீட் குறிப்பிட்ட நிலையை அடையும்போது ஒரு செய்தி அனுப்பப்பட வேண்டுமென்றால், பதினைந்து நிமிடங்களுக்கு ஒருமுறை சரிபார்ப்பது என்பது செய்தி பதினைந்து நிமிடங்கள் வரை தாமதமாகும் என்பதும், பயனுள்ள ஒவ்வொரு கோரிக்கைக்கும் தொண்ணூற்றாறு பயனற்ற கோரிக்கைகளைச் செய்திருக்கிறீர்கள் என்பதும்தான்.

உங்களுடைய ஒரு HTTPS endpoint-ஐ ஆறு நிகழ்வுகளின் எந்தச் சேர்க்கைக்கும் சந்தா செய்யலாம்:

• lead.created — எந்த மூலத்திலிருந்தாவது ஒரு லீட் பணியிடத்துக்குள் வந்தது.
• lead.updated — ஒரு லீடின் புலம் மாறியது.
• lead.stage_changed — லீட் பைப்லைனில் நகர்ந்தது. பெரும்பாலான வணிகத் தர்க்கம் சார்ந்திருக்கும் நிகழ்வு இது.
• lead.assigned — லீடுக்குப் புதிய உரிமையாளர் கிடைத்தார்.
• call.logged — ஒரு லீடுக்கு எதிராக ஒரு அழைப்பு அதன் முடிவுடன் பதிவானது.
• follow_up.due — வாக்களித்த மீள் அழைப்புக்கான நேரம் வந்துவிட்டது.

நிகழ்வுகள் அந்த விஷயம் நடந்த கணமே, மாற்றத்துடன் ஒரே மூச்சில் வரிசைப்படுத்தப்படுகின்றன; எனவே செயலுக்கும் அறிவிப்புக்கும் இடையே நிகழும் ஒரு மறுதொடக்கத்தால் ஒரு நிகழ்வு இழக்கப்பட முடியாது. செயலியின் பார்வையில் அவை அனுப்பி-மறந்துவிடும் வகை: செயலிழந்த அல்லது மெதுவான webhook endpoint, ஒரு முகவர் அழைப்பைப் பதிவு செய்வதை ஒருபோதும் தாமதப்படுத்தவோ தோல்வியடையச் செய்யவோ முடியாது.

ஒரு அனுப்புதல் உண்மையில் எங்களிடமிருந்தே வந்ததா என்று சரிபார்த்தல்

உங்கள் endpoint பொது இணையத்தில் உள்ள ஒரு URL; அதைத் தெரிந்துகொள்ளும் எவரும் அதற்கு post செய்யலாம். எனவே ஒவ்வொரு அனுப்புதலிலும் நிகழ்வையும் அனுப்புதலையும் அடையாளம் காட்டும் headers, ஒரு நேர முத்திரை, உங்களுடன் மட்டுமே பகிரப்பட்ட ஒரு ரகசியத்தைப் பயன்படுத்தி நேர முத்திரை மற்றும் body மீது கணக்கிடப்பட்ட HMAC-SHA256 கையொப்பம் ஆகியவை இருக்கும்.

payload-இல் உள்ள ஒரு புலத்தைக்கூட நம்பும் முன், உங்கள் பெறுநர் மூலக் கோரிக்கை body-யிலிருந்து அந்தக் கையொப்பத்தை மீண்டும் கணக்கிட்டு ஒப்பிட வேண்டும். நடைமுறையில் இரண்டு விவரங்கள் முக்கியம்: பாகுபடுத்தப்பட்ட JSON-இன் மீண்டும் வரிசைப்படுத்தப்பட்ட பதிப்பை அல்லாமல் மூல body-யைப் பயன்படுத்துங்கள், ஏனெனில் ஒரே ஒரு இடைவெளி வேறுபாடுகூடக் கையொப்பத்தை மாற்றிவிடும்; சாதாரண சமத்துவச் சோதனையை அல்லாமல் constant-time ஒப்பீட்டைப் பயன்படுத்துங்கள். ரகசியத்தைக் கோரும்போது மீண்டும் காட்டலாம் — எனவே webhook-ஐ நீக்காமலேயே பெறுநரை மீண்டும் உருவாக்கலாம் — தேவைப்படும்போது மாற்றலாம்.

உங்கள் endpoint செயலிழந்திருக்கும்போது

தோல்வியடைந்த அனுப்புதல்கள், சுமார் அரை நாள் நீளும், தொடக்கத்தில் அடர்த்தியான ஒரு அட்டவணையில் மீண்டும் முயற்சிக்கப்படுகின்றன: முதல் மறுமுயற்சிகள் சில நிமிடங்களுக்குள், பிறகு இடைவெளிகள் மணிக்கணக்காக விரிகின்றன. ஒரு deploy-க்காகச் செயலிழந்திருக்கும் பெறுநர் எதையும் இழப்பதில்லை. நாள் முழுவதும் செயலிழந்திருக்கும் பெறுநர் கைவிடப்படுகிறது, ஏனெனில் அந்த நேரத்தில் நிகழ்வுகள் பழையவையாகிவிடுகின்றன; வரம்பில்லாமல் வளரும் வரிசை யாருக்கும் உதவாது.

சமீபத்திய அனுப்புதல் முயற்சிகள் அவற்றின் நிலை, முயற்சி எண்ணிக்கை, உங்கள் endpoint கொடுத்த பதில் ஆகியவற்றுடன் செயலியில் தெரிகின்றன; இது வழக்கமான “தவறு அவர்களிடமா, நம்மிடமா?” விவாதத்தை ஒரு பட்டியலைப் பார்க்கும் இரண்டு நிமிட வேலையாக மாற்றுகிறது. சோதனை அனுப்புதல் பொத்தானும் உள்ளது; எனவே ஒரு பெறுநரைச் சார்ந்திருக்கும் முன் அது வேலை செய்கிறது என்று நிரூபிக்கலாம். Webhook URL-கள் HTTPS ஆக இருக்க வேண்டும், பொது முகவரிக்குத் தீர்வாக வேண்டும் — தனிப்பட்ட அல்லது உள் வரம்பைச் சுட்டும் URL சேமிக்கும்போதே மறுக்கப்படுகிறது, ஒவ்வொரு அனுப்புதலுக்கு முன்பும் மீண்டும் சரிபார்க்கப்படுகிறது.

குறியீடு எழுதாமல் இணைத்தல்

Zapier-க்கான LumaKol செயலி உருவாக்கப்பட்டு Zapier-இன் மதிப்பாய்வுக்காகக் காத்திருக்கிறது; அது அவர்களின் கோப்பகத்தில் தோன்றும் வரையும், Make, n8n அல்லது Pabbly Connect-இலும், வழி கைமுறை இணைப்புதான். அதற்கு ஒரு செயலி தேவையில்லை. அந்தத் தளங்கள் ஒவ்வொன்றும் பொதுவான webhook தூண்டுதலையும் பொதுவான HTTP செயலையும் வழங்குகின்றன; இரண்டையும் கொண்டு ஒரு பிரத்யேகச் செயலி தருவதில் பெரும்பாலானவற்றை உருவாக்கலாம்.

1. தானியக்கத் தளத்தில், அதன் உள்வரும் webhook தூண்டுதலுடன் தொடங்கும் புதிய scenario-வை உருவாக்குங்கள் — “Webhooks by Zapier”, Make-இல் “Custom webhook”, n8n-இல் Webhook node, Pabbly-இல் “Catch Hook”. அது தரும் URL-ஐ நகலெடுங்கள்.
2. LumaKol-இல், அந்த URL-ஐச் சுட்டும் ஒரு webhook-ஐச் சேர்த்து, உங்களுக்கு முக்கியமான நிகழ்வுகளுக்கு அதைச் சந்தா செய்யுங்கள். தளம் payload வடிவத்தைப் பார்த்து அதன் புல மேப்பிங்கை உருவாக்க, ஒரு சோதனை அனுப்புதலை அனுப்புங்கள்.
3. உங்கள் செயல் படியைச் சேருங்கள்: Google Sheets-இல் ஒரு வரிசை, Slack-இல் ஒரு செய்தி, உங்கள் கணக்கியல் அமைப்பில் ஒரு பதிவு, ஒரு மேலாளருக்கு மின்னஞ்சல்.
4. LumaKol-க்குத் திரும்ப எழுத, அங்கீகார header-இல் உங்கள் கீகளில் ஒன்றுடன், API-க்கு எதிராகத் தளத்தின் HTTP request செயலைப் பயன்படுத்துங்கள் — லீடை உருவாக்க, நிலையைப் புதுப்பிக்க அல்லது குறிப்பைச் சேர்க்க. புதிய லீடுகளை அனுப்புவது மட்டுமே உங்களுக்குத் தேவை என்றால், “இணையதளம் அல்லது பிற செயலி” வகை லீட் மூலம் (அமைப்பு → லீட் மூலங்கள்) கீ தேவையில்லாத ஒரு தனிப்பட்ட webhook URL-ஐத் தருகிறது; அது அந்த மூலத்தின் உரிமையாளர், நிலை, குறிச்சொற்களை ஒவ்வொரு லீடுக்கும் பொருத்துகிறது.
5. scenario-வை இயக்குங்கள்; அதைச் சார்ந்திருக்கும் முன், வேண்டுமென்றே அதை உடையுங்கள்: தவறான URL-ஐச் சுட்டச் செய்து, அனுப்புதல் பட்டியல் தோல்வியைக் காட்டுவதைப் பாருங்கள் — உண்மையாக ஒரு பிரச்சினை நடக்கும்போது அது எப்படித் தோன்றும் என்று தெரிந்துகொள்வீர்கள்.

Zapier செயலி பட்டியலிடப்பட்டதும் அங்கே சில கிளிக்குகள் மிச்சமாகும். பொதுவான வழி இன்றே எல்லாத் தளங்களிலும் வேலை செய்கிறது; அது ஒரு சாதாரணக் கையொப்பமிட்ட webhook-உம் சாதாரண REST அழைப்பும் என்பதால், பின்னர் எந்தத் தானியக்கத் தளத்துக்கு மாறினாலும் தொடர்ந்து வேலை செய்யும்.