మీరు ఇప్పటికే నడుపుతున్న సాఫ్ట్‌వేర్‌కు LumaKolను అనుసంధానించడం

ఏ వ్యాపారమూ CRM ఒక్కటే నడపదు. ఒక అకౌంటింగ్ ప్యాకేజీ, ఒక వెబ్‌సైట్, ఒక టికెటింగ్ సాధనం, ఒక వేర్‌హౌస్ సిస్టమ్, 2019లో ఎవరో తయారుచేసిన, అందరూ ఇప్పటికీ ఆధారపడే ఒక స్ప్రెడ్‌షీట్ ఉంటాయి. వాటిలో దేనితోనూ మాట్లాడలేని CRM మరో ద్వీపంగా మారుతుంది, ద్వీపాల మధ్య వారధి చివరికి రోజు చివర్లో చేతితో వరుసలు కాపీ చేసే ఒక వ్యక్తి అవుతారు.

LumaKolకు ఇప్పుడు పబ్లిక్ API, అవుట్‌గోయింగ్ webhooks ఉన్నాయి. రెండూ కలిసి రెండు దిశలనూ కవర్ చేస్తాయి: మీకు అవసరమైనప్పుడు LumaKolను డేటా అడగవచ్చు, ఏదైనా జరిగిన క్షణంలోనే LumaKol మీకు తెలియజేయగలదు. ఈ పోస్ట్ రిఫరెన్స్ కాదు, అవి ఎలా నిర్మించబడ్డాయి, ఏది ఉపయోగించాలో ఎలా నిర్ణయించుకోవాలి అనే దాని గురించి — ఎండ్‌పాయింట్ జాబితా యాప్‌లోని డెవలపర్ విభాగంలో, మీరు కీలను సృష్టించే చోటే ఉంటుంది.

కీలు వర్క్‌స్పేస్‌కు చెందుతాయి, ఒక వ్యక్తికి కాదు

ఇదే మొదటి డిజైన్ నిర్ణయం, మీకు ఒక సోమవారం ఉదయాన్ని కాపాడేది కూడా ఇదే. LumaKolలో జారీ చేసిన API కీ వర్క్‌స్పేస్‌కు చెందుతుంది. దాన్ని సృష్టించిన డెవలపర్ కంపెనీ వదిలి వెళ్లి, వారి ఖాతా డీయాక్టివేట్ అయినప్పుడు, వారు నిర్మించిన ఇంటిగ్రేషన్ పనిచేస్తూనే ఉంటుంది: కీ దాని సృష్టికర్తతో పాటు చనిపోకుండా, వర్క్‌స్పేస్ యజమానిగా పనిచేయడానికి మారుతుంది.

వ్యక్తిగత లాగిన్‌పై నిర్మించిన ఇంటిగ్రేషన్‌ను నడిపిన ఎవరికైనా ఇది ఎందుకు ముఖ్యమో తెలుసు. ఆ వ్యక్తి వెళ్లిపోయిన వారాల తర్వాత ఆ ఇంటిగ్రేషన్‌లు నిశ్శబ్దంగా విఫలమవుతాయి, సమస్యకు మొదటి సంకేతం ఖాళీలున్న ఒక నివేదిక.

స్కోప్‌లు

కీ అది ఏమేమి చేయగలదో స్పష్టంగా చెప్పే జాబితాతో జారీ చేయబడుతుంది, అంతకుమించి ఏమీ చేయదు:

ప్రతి ఇంటిగ్రేషన్‌కు, ఆ పనికి సరిపోయే అతి చిన్న స్కోప్‌తో దాని సొంత కీ ఇవ్వండి. చార్ట్‌లు మాత్రమే గీసే డాష్‌బోర్డ్‌కు leads:read, calls:read లభిస్తాయి, కీ ఉండకూడని చోటికి చేరినా అది ఎలాంటి నష్టం చేయలేదు. వెబ్‌సైట్ ఫారం హ్యాండ్లర్‌కు leads:write లభిస్తుంది, అది మీ కాల్ చరిత్రను చదవలేదు. కీని సృష్టించేటప్పుడు ఈ అలవాటుకు ఏ ఖర్చూ ఉండదు, ఏదైనా తప్పు జరిగిన రోజు ఇది చాలా విలువైనదిగా నిరూపిస్తుంది.

నిల్వ, రద్దు

కీ సృష్టించిన క్షణంలో ఒక్కసారి మాత్రమే చూపించబడుతుంది, మళ్లీ ఎప్పుడూ కాదు. LumaKol నిల్వ చేసేది దాని వన్-వే హ్యాష్, కాబట్టి డేటాబేస్ నుంచి కీని ఎవరూ తిరిగి చదవలేరు — మేము కూడా. మీరు దాన్ని పోగొట్టుకుంటే, కొత్తది జారీ చేస్తారు; ఉద్దేశపూర్వకంగానే రికవరీ లేదు.

రద్దు తక్షణమే జరుగుతుంది. రద్దు చేయండి నొక్కితే, ఆ కీతో చేసే తర్వాతి అభ్యర్థన తిరస్కరించబడుతుంది. గ్రేస్ పీరియడ్ లేదు, ప్రచారం కోసం వేచి ఉండాల్సిన ఆలస్యం లేదు — ల్యాప్‌టాప్ పోయినప్పుడు లేదా కాంట్రాక్టర్ ఒప్పందం ముగిసినప్పుడు మీకు కావలసింది ఇదే.

కీలు వర్క్‌స్పేస్ స్థితిని కూడా గౌరవిస్తాయి. వర్క్‌స్పేస్ సస్పెండ్ అయితే, దాని కీలు పూర్తిగా పనిచేయడం ఆగిపోతాయి. అది రీడ్-ఓన్లీ అయితే — గడువు ముగిసిన ట్రయల్, రద్దు చేసిన ప్లాన్ — కీలు GET అభ్యర్థనలకు సేవలందిస్తూనే ఉంటాయి కానీ రైట్‌లను తిరస్కరిస్తాయి, సరిగ్గా యాప్ స్వయంగా చేసినట్టే. ఇంటిగ్రేషన్ ఎప్పుడూ ఖాతా స్థితిని దాటవేసే వెనుక ద్వారం కాలేదు.

APIపై అతిగా భారం వేయకుండా డేటాను చదవడం

బేస్ URL https://api.lumakol.com/api/v1. జాబితాలు పేజీ నంబర్‌లతో కాకుండా కర్సర్‌తో పేజినేట్ చేయబడతాయి, ఇది వినిపించే దానికంటే ఎక్కువ ముఖ్యమైనది.

సింక్ జరుగుతున్నప్పుడు పేజీ నంబర్‌లు విఫలమవుతాయి. మీరు మొదటి పేజీని తెస్తారు, ఎవరో ఒక లీడ్‌ను అప్‌డేట్ చేస్తారు, క్రమం మారుతుంది, ఇప్పుడు రెండో పేజీ మీరు ఎప్పుడూ చూడని రికార్డ్ తర్వాత మొదలవుతుంది. కొన్ని వేల లీడ్‌ల రాత్రిపూట సింక్‌లో, అంటే ప్రతి రాత్రి కొన్ని రికార్డులు తప్పిపోతాయి, అలా జరిగిందని సూచించేది ఏదీ ఉండదు. కర్సర్ క్రమంలో ఒక స్థిర స్థానాన్ని సూచిస్తుంది, కాబట్టి ప్రజలు పనిచేస్తుండగానే సెట్ మొత్తాన్ని పేజీలవారీగా చూస్తే ప్రతి రికార్డ్ సరిగ్గా ఒక్కసారి వస్తుంది.

జాబితా ప్రతిస్పందనలో వరుసలు, తర్వాతి కర్సర్, ఇంకా మిగిలి ఉన్నాయో లేదో చెప్పే ఫ్లాగ్ ఉంటాయి. లూప్ ఇది: అభ్యర్థించండి, ప్రాసెస్ చేయండి, కర్సర్‌ను తిరిగి పంపండి, ఫ్లాగ్ false అయ్యే వరకు పునరావృతం చేయండి. దీన్ని updated-since ఫిల్టర్‌తో కలిపితే ఇంక్రిమెంటల్ సింక్ సరళమవుతుంది — మీ చివరి విజయవంతమైన రన్ నుంచి మారిన ప్రతిదాన్నీ అడగండి, పేజీలవారీగా చూడండి, టైమ్‌స్టాంప్‌ను నిల్వ చేయండి, ఆపండి. దశ, యజమాని, సోర్స్, ట్యాగ్, ఫ్రీ టెక్స్ట్ కోసం ఫిల్టర్‌లు ఉన్నాయి, అలాగే మీ సొంత బాహ్య ఐడెంటిఫైయర్ ద్వారా లుకప్ కూడా ఉంది, తద్వారా మ్యాపింగ్ టేబుల్ ఉంచుకోకుండానే LumaKol లీడ్‌లను మీ సొంత సిస్టమ్‌లోని రికార్డులతో సరిపోల్చవచ్చు.

Webhooks: స్పందించదగిన ఆరు ఈవెంట్‌లు

వెంటనే జరగాల్సిన దేనికైనా పోలింగ్ తప్పు సాధనం. లీడ్ ఒక నిర్దిష్ట దశకు చేరినప్పుడు సందేశం పంపాలనుకుంటే, ప్రతి పదిహేను నిమిషాలకు తనిఖీ చేయడం అంటే సందేశం పదిహేను నిమిషాల వరకు ఆలస్యమవుతుంది, ఉపయోగపడే ప్రతి ఒక్క అభ్యర్థనకు తొంభై ఆరు అర్థం లేని అభ్యర్థనలు చేసినట్టవుతుంది.

మీ HTTPS ఎండ్‌పాయింట్‌ను ఈ ఆరు ఈవెంట్‌లలో ఏ కలయికకైనా సబ్‌స్క్రైబ్ చేయవచ్చు:

• lead.created — ఏ సోర్స్ నుంచైనా ఒక లీడ్ వర్క్‌స్పేస్‌లోకి వచ్చింది.
• lead.updated — లీడ్‌పై ఒక ఫీల్డ్ మారింది.
• lead.stage_changed — లీడ్ పైప్‌లైన్‌లో ముందుకు కదిలింది. చాలా వ్యాపార లాజిక్ ఆధారపడే ఈవెంట్ ఇదే.
• lead.assigned — లీడ్‌కు కొత్త యజమాని వచ్చారు.
• call.logged — ఒక లీడ్‌పై కాల్ దాని ఫలితంతో నమోదైంది.
• follow_up.due — మాట ఇచ్చిన కాల్‌బ్యాక్ గడువు వచ్చింది.

సంఘటన జరిగిన క్షణంలోనే, మార్పుతో పాటే ఈవెంట్‌లు క్యూలో పెట్టబడతాయి, కాబట్టి చర్యకు, నోటిఫికేషన్‌కు మధ్య రీస్టార్ట్ వల్ల ఈవెంట్ పోదు. యాప్ దృష్టికోణం నుంచి అవి ఫైర్-అండ్-ఫర్గెట్ కూడా: డౌన్‌లో ఉన్న లేదా నెమ్మదిగా ఉన్న webhook ఎండ్‌పాయింట్ ఏజెంట్ కాల్ నమోదు చేయడాన్ని ఎప్పుడూ ఆలస్యం చేయలేదు, విఫలం చేయలేదు.

డెలివరీ నిజంగా మా నుంచే వచ్చిందని ధృవీకరించడం

మీ ఎండ్‌పాయింట్ పబ్లిక్ ఇంటర్నెట్‌లోని ఒక URL, అది తెలిసిన ఎవరైనా దానికి పోస్ట్ చేయవచ్చు. అందుకే ప్రతి డెలివరీలో ఈవెంట్‌ను, డెలివరీని గుర్తించే హెడర్‌లు, ఒక టైమ్‌స్టాంప్, మీతో మాత్రమే పంచుకున్న సీక్రెట్‌ను ఉపయోగించి టైమ్‌స్టాంప్, బాడీపై లెక్కించిన HMAC-SHA256 సంతకం ఉంటాయి.

పేలోడ్‌లోని ఒక్క ఫీల్డ్‌ను నమ్మే ముందు, మీ రిసీవర్ రా రిక్వెస్ట్ బాడీ నుంచి ఆ సంతకాన్ని మళ్లీ లెక్కించి పోల్చాలి. ఆచరణలో రెండు వివరాలు ముఖ్యమైనవి: పార్స్ చేసిన JSONను మళ్లీ సీరియలైజ్ చేసిన వెర్షన్ కాకుండా రా బాడీని ఉపయోగించండి, ఎందుకంటే ఒక్క వైట్‌స్పేస్ తేడా కూడా సంతకాన్ని మారుస్తుంది; సాధారణ సమానత్వ తనిఖీ కాకుండా కాన్‌స్టంట్-టైమ్ పోలికను ఉపయోగించండి. సీక్రెట్‌ను అవసరమైనప్పుడు మళ్లీ చూపించవచ్చు — కాబట్టి webhookను తొలగించకుండానే రిసీవర్‌ను తిరిగి నిర్మించవచ్చు — అవసరమైనప్పుడు రొటేట్ కూడా చేయవచ్చు.

మీ ఎండ్‌పాయింట్ డౌన్‌లో ఉన్నప్పుడు

విఫలమైన డెలివరీలు దాదాపు సగం రోజు పాటు, ప్రారంభంలోనే ఎక్కువ ప్రయత్నాలు ఉండే షెడ్యూల్‌లో మళ్లీ ప్రయత్నించబడతాయి: మొదటి పునఃప్రయత్నాలు నిమిషాల్లోనే వస్తాయి, తర్వాత అంతరాలు గంటలకు పెరుగుతాయి. డిప్లాయ్ కోసం డౌన్‌లో ఉన్న రిసీవర్ ఏమీ కోల్పోదు. రోజంతా డౌన్‌లో ఉన్నదాన్ని వదిలేస్తారు, ఎందుకంటే ఆ సమయానికి ఈవెంట్‌లు పాతబడిపోతాయి, హద్దు లేకుండా పెరిగే క్యూ ఎవరికీ ఉపయోగపడదు.

ఇటీవలి డెలివరీ ప్రయత్నాలు వాటి స్థితి, ప్రయత్నాల సంఖ్య, మీ ఎండ్‌పాయింట్ ఇచ్చిన ప్రతిస్పందనతో యాప్‌లో కనిపిస్తాయి, ఇది సాధారణంగా జరిగే “తప్పు వారిదా మనదా?” వాదనను ఒక జాబితాను రెండు నిమిషాలు చూడటంగా మారుస్తుంది. టెస్ట్ డెలివరీ బటన్ కూడా ఉంది, కాబట్టి రిసీవర్‌పై ఆధారపడే ముందే అది పనిచేస్తుందని నిరూపించవచ్చు. Webhook URLలు HTTPS అయి ఉండాలి, పబ్లిక్ అడ్రస్‌కు రిసాల్వ్ కావాలి — ప్రైవేట్ లేదా అంతర్గత రేంజ్‌ను సూచించే URLను సేవ్ చేసేటప్పుడే తిరస్కరిస్తారు, ప్రతి డెలివరీకి ముందు మళ్లీ తనిఖీ చేస్తారు.

కోడ్ రాయకుండా అనుసంధానించడం

Zapier కోసం LumaKol యాప్ నిర్మించబడింది, Zapier సమీక్ష కోసం వేచి ఉంది; అది వారి డైరెక్టరీలో కనిపించే వరకు, అలాగే Make, n8n లేదా Pabbly Connectలో, మార్గం మాన్యువల్ కనెక్షనే. దీనికి యాప్ అవసరం లేదు. ఆ ప్లాట్‌ఫామ్‌లలో ప్రతి ఒక్కటీ జెనరిక్ webhook ట్రిగ్గర్‌ను, జెనరిక్ HTTP యాక్షన్‌ను అందిస్తుంది, ఆ రెండింటితో ప్రత్యేక యాప్ ఇచ్చే వాటిలో చాలావరకు మీరు నిర్మించవచ్చు.

1. ఆటోమేషన్ ప్లాట్‌ఫామ్‌లో, దాని ఇన్‌కమింగ్ webhook ట్రిగ్గర్‌తో మొదలయ్యే కొత్త సినారియోను సృష్టించండి — “Webhooks by Zapier”, Makeలో “Custom webhook”, n8nలో Webhook నోడ్, Pabblyలో “Catch Hook”. అది ఇచ్చే URLను కాపీ చేయండి.
2. LumaKolలో, ఆ URLను సూచించే webhookను జోడించి, మీకు ముఖ్యమైన ఈవెంట్‌లకు సబ్‌స్క్రైబ్ చేయండి. ప్లాట్‌ఫామ్ పేలోడ్ ఆకారాన్ని చూసి దాని ఫీల్డ్ మ్యాపింగ్‌ను నిర్మించగలిగేలా టెస్ట్ డెలివరీ పంపండి.
3. మీ యాక్షన్ స్టెప్‌ను జోడించండి: Google Sheetsలో ఒక వరుస, Slackలో ఒక సందేశం, మీ అకౌంటింగ్ సిస్టమ్‌లో ఒక రికార్డ్, మేనేజర్‌కు ఒక ఇమెయిల్.
4. LumaKolలోకి తిరిగి రాయడానికి, మీ కీలలో ఒకదాన్ని ఆథరైజేషన్ హెడర్‌లో ఉంచి APIకి ప్లాట్‌ఫామ్ HTTP రిక్వెస్ట్ యాక్షన్‌ను ఉపయోగించండి — లీడ్ సృష్టించడం, దశను అప్‌డేట్ చేయడం లేదా నోట్ జోడించడం. మీకు కావలసింది కేవలం కొత్త లీడ్‌లను పంపడమే అయితే, “వెబ్‌సైట్ లేదా ఇతర యాప్” రకం లీడ్ సోర్స్ (సెటప్ → లీడ్ సోర్స్‌లు) కీ అవసరం లేని ప్రైవేట్ webhook URLను ఇస్తుంది, ఆ సోర్స్ యజమాని, దశ, ట్యాగ్‌లను ప్రతి లీడ్‌కు వర్తింపజేస్తుంది.
5. సినారియోను ఆన్ చేయండి, దానిపై ఆధారపడే ముందు ఉద్దేశపూర్వకంగా దాన్ని విఫలం చేయండి: దాన్ని తప్పు URLకు సూచించి, డెలివరీ జాబితా వైఫల్యాన్ని చూపించడం గమనించండి, తద్వారా నిజంగా సమస్య వచ్చినప్పుడు అది ఎలా కనిపిస్తుందో మీకు తెలుస్తుంది.

Zapier యాప్ జాబితాలోకి వచ్చిన తర్వాత అక్కడ కొన్ని క్లిక్‌లు ఆదా అవుతాయి. జెనరిక్ మార్గం ఈ రోజే ప్రతి ప్లాట్‌ఫామ్‌లో పనిచేస్తుంది, అది సాధారణ సంతకం చేసిన webhook, సాధారణ REST కాల్ కాబట్టి, మీరు తర్వాత ఏ ఆటోమేషన్ ప్లాట్‌ఫామ్‌కు మారినా పనిచేస్తూనే ఉంటుంది.