તમે પહેલેથી વાપરો છો તે સૉફ્ટવેર સાથે LumaKol ને જોડવું

કોઈ પણ CRM વ્યવસાયમાં ચાલતી એકમાત્ર સિસ્ટમ નથી હોતી. એકાઉન્ટિંગ પૅકેજ હોય છે, વેબસાઇટ, ટિકિટિંગ ટૂલ, વેરહાઉસ સિસ્ટમ, અને 2019 માં કોઈએ બનાવેલી એક સ્પ્રેડશીટ જેના પર હજી બધા આધાર રાખે છે. જે CRM આમાંના કોઈ સાથે વાત ન કરી શકે તે બીજો એક ટાપુ બની જાય છે, અને ટાપુઓ વચ્ચેનો પુલ અંતે દિવસના છેડે હાથેથી હરોળો કૉપિ કરતી એક વ્યક્તિ બની જાય છે.

LumaKol પાસે હવે જાહેર API અને આઉટગોઇંગ વેબહુક છે. બંને મળીને બંને દિશા આવરી લે છે: જ્યારે જરૂર હોય ત્યારે તમે LumaKol પાસે ડેટા માગી શકો છો, અને કંઈક થાય કે તરત LumaKol તમને જણાવી શકે છે. આ લેખ સંદર્ભ નથી, પણ તે કેવી રીતે બનાવાયા છે અને કયું વાપરવું તે કેવી રીતે નક્કી કરવું તેના વિશે છે — એન્ડપૉઇન્ટની યાદી ઍપના ડેવલપર વિભાગમાં છે, જ્યાં તમે કી બનાવો છો તેની બાજુમાં.

કી વર્કસ્પેસની હોય છે, કોઈ વ્યક્તિની નહીં

આ પહેલો ડિઝાઇન નિર્ણય છે, અને એ જ તમારી એક સોમવારની સવાર બચાવે છે. LumaKol માં જારી થયેલી API કી વર્કસ્પેસની હોય છે. જ્યારે તેને બનાવનાર ડેવલપર કંપની છોડે અને તેમનું ખાતું નિષ્ક્રિય થાય, ત્યારે તેમણે બનાવેલું ઇન્ટિગ્રેશન ચાલુ રહે છે: કી તેના લેખક સાથે બંધ થઈ જવાને બદલે વર્કસ્પેસના માલિક તરીકે કામ કરવા લાગે છે.

વ્યક્તિગત લૉગિન પર બનેલું ઇન્ટિગ્રેશન ચલાવ્યું હોય તે કોઈપણ જાણે છે કે આ શા માટે મહત્ત્વનું છે. એવાં ઇન્ટિગ્રેશન વ્યક્તિ ગયાનાં અઠવાડિયાં પછી ચૂપચાપ નિષ્ફળ જાય છે, અને મુશ્કેલીનો પહેલો સંકેત એક અધૂરો રિપોર્ટ હોય છે.

સ્કોપ

કી તે શું કરી શકે તેની સ્પષ્ટ યાદી સાથે જારી થાય છે, અને બીજું કંઈ નહીં:

દરેક ઇન્ટિગ્રેશનને તેની પોતાની કી આપો, કામ પૂરું કરે એવા સૌથી નાના સ્કોપ સાથે. ફક્ત ચાર્ટ દોરતા ડેશબોર્ડને leads:read અને calls:read મળે છે, અને કી ખોટી જગ્યાએ પહોંચી જાય તો પણ તે કોઈ નુકસાન કરી શકતું નથી. વેબસાઇટ ફોર્મ હૅન્ડલરને leads:write મળે છે અને તે તમારો કૉલ ઇતિહાસ વાંચી શકતું નથી. કી બનાવતી વખતે આ ટેવનો કોઈ ખર્ચ નથી, અને જે દિવસે કંઈક ખોટું થાય તે દિવસે તે ઘણી કીમતી સાબિત થાય છે.

સંગ્રહ અને રદ કરવું

કી ફક્ત એક વાર બતાવવામાં આવે છે, જે ક્ષણે તે બને છે ત્યારે, અને પછી ક્યારેય નહીં. LumaKol તેનો એક-દિશાનો હૅશ સંગ્રહે છે, તેથી કોઈ પણ — અમે પણ — ડેટાબેઝમાંથી કી પાછી વાંચી શકતું નથી. જો તે ખોવાઈ જાય, તો તમે નવી જારી કરો છો; ઇરાદાપૂર્વક, પુનઃપ્રાપ્તિની કોઈ રીત નથી.

રદ કરવું તરત અમલમાં આવે છે. રદ કરો દબાવો અને એ કી સાથેની આગલી વિનંતી નકારવામાં આવે છે. કોઈ છૂટનો સમયગાળો નથી અને ફેલાવાના વિલંબની રાહ જોવાની નથી, અને લૅપટૉપ ગુમ થાય કે કોન્ટ્રાક્ટરનું કામ પૂરું થાય ત્યારે તમને આ જ જોઈએ છે.

કી વર્કસ્પેસની સ્થિતિનું પણ પાલન કરે છે. જો વર્કસ્પેસ સસ્પેન્ડ થાય, તો તેની કી સંપૂર્ણપણે કામ કરતી બંધ થઈ જાય છે. જો તે ફક્ત-વાંચન સ્થિતિમાં હોય — સમાપ્ત થયેલી ટ્રાયલ, રદ થયેલો પ્લાન — તો કી GET વિનંતીઓ પૂરી પાડતી રહે છે પણ લખવાનું નકારે છે, બરાબર ઍપ પોતે કરે છે તેમ. ઇન્ટિગ્રેશન ક્યારેય ખાતાની સ્થિતિને ટાળવાનો પાછલો દરવાજો બની શકતું નથી.

API પર ભાર નાખ્યા વિના ડેટા વાંચવો

બેઝ URL https://api.lumakol.com/api/v1 છે. યાદીઓ પેજ નંબરને બદલે કર્સરથી પેજિનેટ થાય છે, જે સાંભળવામાં લાગે તેના કરતાં વધુ મહત્ત્વનું છે.

સિંક દરમિયાન પેજ નંબર તૂટી જાય છે. તમે પહેલું પેજ મેળવો, કોઈ લીડ અપડેટ કરે, ક્રમ ખસી જાય, અને હવે બીજું પેજ એવા રેકોર્ડ પછીથી શરૂ થાય છે જે તમે ક્યારેય જોયો નથી. થોડા હજાર લીડ્સના રાત્રિના સિંકમાં, દરરોજ રાત્રે થોડા રેકોર્ડ ખૂટે છે અને આવું થયું તેનો કોઈ સંકેત નથી મળતો. કર્સર ક્રમમાં એક નિશ્ચિત સ્થાન તરફ નિર્દેશ કરે છે, તેથી લોકો કામ કરતા હોય ત્યારે પણ સમૂહનાં પેજ ફેરવતાં તમને દરેક રેકોર્ડ બરાબર એક વાર મળે છે.

યાદીના જવાબમાં હરોળો, આગલું કર્સર, અને હજી વધુ બાકી છે કે નહીં તે જણાવતો ફ્લૅગ હોય છે. લૂપ આ છે: વિનંતી કરો, પ્રોસેસ કરો, કર્સર પાછું મોકલો, ફ્લૅગ false થાય ત્યાં સુધી પુનરાવર્તન કરો. તેને updated-since ફિલ્ટર સાથે જોડો અને ઇન્ક્રિમેન્ટલ સિંક સરળ બની જાય છે — તમારા છેલ્લા સફળ રન પછી બદલાયેલું બધું માગો, તેનાં પેજ ફેરવો, ટાઇમસ્ટેમ્પ સાચવો, અટકો. તબક્કો, માલિક, સ્રોત, ટૅગ અને મુક્ત લખાણ માટે ફિલ્ટર છે, સાથે તમારા પોતાના બાહ્ય ઓળખકર્તા દ્વારા શોધવાની સુવિધા પણ, જેથી મૅપિંગ ટેબલ રાખ્યા વિના તમે LumaKol ની લીડ્સને તમારી પોતાની સિસ્ટમના રેકોર્ડ સાથે મેળવી શકો.

વેબહુક: પ્રતિક્રિયા આપવા લાયક છ ઘટનાઓ

જે કંઈ તરત થવું જોઈએ તેના માટે પોલિંગ ખોટું સાધન છે. જો તમે ઇચ્છો કે લીડ કોઈ ચોક્કસ તબક્કે પહોંચે ત્યારે મેસેજ મોકલાય, તો દર પંદર મિનિટે તપાસ કરવાનો અર્થ છે કે મેસેજ પંદર મિનિટ સુધી મોડો પહોંચે છે અને દરેક ઉપયોગી વિનંતી માટે તમે છન્નું નકામી વિનંતીઓ કરી છે.

તમે તમારા એક HTTPS એન્ડપૉઇન્ટને છ ઘટનાઓના કોઈપણ સંયોજન માટે સબ્સ્ક્રાઇબ કરી શકો છો:

• lead.created — કોઈપણ સ્રોતમાંથી વર્કસ્પેસમાં લીડ આવી.
• lead.updated — લીડ પરનું કોઈ ફીલ્ડ બદલાયું.
• lead.stage_changed — લીડ પાઇપલાઇનમાં આગળ વધી. મોટાભાગનું બિઝનેસ લૉજિક આ ઘટના પર ટકેલું હોય છે.
• lead.assigned — લીડને નવો માલિક મળ્યો.
• call.logged — લીડ સામે તેના પરિણામ સાથે કૉલ નોંધાયો.
• follow_up.due — વચન આપેલા કૉલબૅકનો સમય થયો.

વસ્તુ થાય એ જ ક્ષણે, ફેરફારની સાથે સાથે જ ઘટનાઓ કતારમાં મુકાય છે, તેથી ક્રિયા અને સૂચના વચ્ચે રીસ્ટાર્ટને કારણે ઘટના ખોવાઈ શકતી નથી. ઍપની દૃષ્ટિએ તે ફાયર-એન્ડ-ફરગેટ પણ છે: બંધ કે ધીમો વેબહુક એન્ડપૉઇન્ટ એજન્ટના કૉલ લૉગ કરવામાં ક્યારેય વિલંબ કે નિષ્ફળતા લાવી શકતો નથી.

ડિલિવરી ખરેખર અમારા તરફથી આવી છે તેની ખાતરી કરવી

તમારો એન્ડપૉઇન્ટ જાહેર ઇન્ટરનેટ પરનું URL છે, અને તેને જાણનાર કોઈપણ તેના પર પોસ્ટ કરી શકે છે. તેથી દરેક ડિલિવરીમાં ઘટના અને ડિલિવરીને ઓળખતા હેડર, ટાઇમસ્ટેમ્પ, અને ફક્ત તમારી સાથે શેર કરેલા સિક્રેટનો ઉપયોગ કરીને ટાઇમસ્ટેમ્પ અને બૉડી પર ગણેલી HMAC-SHA256 સહી હોય છે.

પેલોડના એક પણ ફીલ્ડ પર વિશ્વાસ કરતાં પહેલાં તમારા રિસીવરે કાચા રિક્વેસ્ટ બૉડી પરથી એ સહી ફરી ગણવી જોઈએ અને સરખાવવી જોઈએ. વ્યવહારમાં બે વિગતો મહત્ત્વની છે: પાર્સ કરેલા JSON ના ફરી-સિરિયલાઇઝ કરેલા સ્વરૂપને બદલે કાચું બૉડી વાપરો, કારણ કે એક જ ખાલી જગ્યાનો ફરક સહી બદલી નાખે છે; અને સાદી સમાનતા તપાસને બદલે કૉન્સ્ટન્ટ-ટાઇમ સરખામણી વાપરો. સિક્રેટ માગણી પર ફરી બતાવી શકાય છે — જેથી વેબહુક ડિલીટ કર્યા વિના તમે રિસીવર ફરી બનાવી શકો — અને જરૂર પડે ત્યારે બદલી શકાય છે.

જ્યારે તમારો એન્ડપૉઇન્ટ બંધ હોય

નિષ્ફળ ડિલિવરી લગભગ અડધા દિવસમાં ફેલાયેલા, શરૂઆતમાં વધુ વારંવારના સમયપત્રક પર ફરી પ્રયાસ થાય છે: પહેલા ફરી પ્રયાસો થોડી મિનિટોમાં આવે છે, પછી અંતર વધીને કલાકો થાય છે. ડિપ્લૉય માટે બંધ રહેલો રિસીવર કંઈ જ ગુમાવતો નથી. આખો દિવસ બંધ રહેલા રિસીવર માટે પ્રયાસ છોડી દેવાય છે, કારણ કે ત્યાં સુધીમાં ઘટનાઓ જૂની થઈ ગઈ હોય છે અને અમર્યાદ વધતી કતાર કોઈને મદદ કરતી નથી.

તાજેતરના ડિલિવરી પ્રયાસો તેમની સ્થિતિ, પ્રયાસોની સંખ્યા અને તમારા એન્ડપૉઇન્ટે આપેલા જવાબ સાથે ઍપમાં દેખાય છે, જે સામાન્ય “ભૂલ તેમની છે કે આપણી?” ચર્ચાને યાદી પર બે મિનિટની નજરમાં ફેરવે છે. ટેસ્ટ ડિલિવરી બટન પણ છે, જેથી રિસીવર પર આધાર રાખતાં પહેલાં તમે સાબિત કરી શકો કે તે કામ કરે છે. વેબહુક URL HTTPS હોવા જોઈએ અને જાહેર સરનામા પર રિઝૉલ્વ થવા જોઈએ — ખાનગી કે આંતરિક રેન્જ તરફ નિર્દેશ કરતું URL સાચવતી વખતે નકારાય છે અને દરેક ડિલિવરી પહેલાં ફરી તપાસાય છે.

કોડ લખ્યા વિના તેને જોડવું

Zapier માટેની LumaKol ઍપ બનીને Zapier ની સમીક્ષાની રાહ જુએ છે; તે તેમની ડિરેક્ટરીમાં દેખાય ત્યાં સુધી, અને Make, n8n કે Pabbly Connect પર, રસ્તો મેન્યુઅલ કનેક્શનનો છે. તેના માટે તમારે ઍપની જરૂર નથી. આ દરેક પ્લૅટફૉર્મ સામાન્ય વેબહુક ટ્રિગર અને સામાન્ય HTTP ઍક્શન આપે છે, અને બંને મળીને ખાસ ઍપ જે આપે તેમાંથી મોટાભાગનું તમે બનાવી શકો છો.

1. ઑટોમેશન પ્લૅટફૉર્મમાં, તેના ઇનકમિંગ વેબહુક ટ્રિગરથી શરૂ થતો નવો સિનારિયો બનાવો — “Webhooks by Zapier”, Make માં “Custom webhook”, n8n માં Webhook નોડ, Pabbly માં “Catch Hook”. તે આપે તે URL કૉપિ કરો.
2. LumaKol માં, એ URL તરફ નિર્દેશ કરતો વેબહુક ઉમેરો અને તમને મહત્ત્વની ઘટનાઓ માટે તેને સબ્સ્ક્રાઇબ કરો. ટેસ્ટ ડિલિવરી મોકલો જેથી પ્લૅટફૉર્મ પેલોડનો આકાર જોઈ શકે અને તેનું ફીલ્ડ મૅપિંગ બનાવી શકે.
3. તમારું ઍક્શન સ્ટેપ ઉમેરો: Google Sheets માં હરોળ, Slack માં મેસેજ, તમારી એકાઉન્ટિંગ સિસ્ટમમાં રેકોર્ડ, મેનેજરને ઇમેઇલ.
4. LumaKol માં પાછું લખવા, ઑથોરાઇઝેશન હેડરમાં તમારી એક કી સાથે API સામે પ્લૅટફૉર્મની HTTP રિક્વેસ્ટ ઍક્શન વાપરો — લીડ બનાવવી, તબક્કો અપડેટ કરવો કે નોંધ ઉમેરવી. જો તમારે ફક્ત નવી લીડ્સ મોકલવાની હોય, તો “વેબસાઇટ કે બીજી ઍપ” પ્રકારનો લીડ સ્રોત (સેટઅપ → લીડ સ્રોત) તમને એક ખાનગી વેબહુક URL આપે છે જેને કીની જરૂર નથી અને જે એ સ્રોતનો માલિક, તબક્કો અને ટૅગ દરેક લીડ પર લાગુ કરે છે.
5. સિનારિયો ચાલુ કરો અને, તેના પર આધાર રાખતાં પહેલાં, જાણીજોઈને તેને તોડો: તેને ખરાબ URL તરફ દોરો અને ડિલિવરી યાદીમાં નિષ્ફળતા દેખાતી જુઓ, જેથી ખરેખર સમસ્યા થાય ત્યારે તે કેવી દેખાય છે તે તમે જાણતા હો.

Zapier ઍપ લિસ્ટ થઈ જાય પછી તે ત્યાં થોડા ક્લિક બચાવશે. સામાન્ય રસ્તો આજે દરેક પ્લૅટફૉર્મ પર કામ કરે છે અને, કારણ કે તે એક સાદો સાઇન કરેલો વેબહુક અને સાદો REST કૉલ છે, તમે પછીથી કોઈપણ ઑટોમેશન પ્લૅટફૉર્મ પર જાઓ તો પણ તે કામ કરતો રહે છે.