નવા CRM સંપર્ક પછી કાર્ડ બનાવો
CRM સંપર્ક ID નો External ID તરીકે ઉપયોગ કરો, 7stamp કાર્ડ બનાવો External ID દ્વારા તમારું પરત આમંત્રણ મોકલો, પછી 38. સામાન્ય ઇમેઇલ, SMS અથવા મેસેજિંગ સ્ટેપ.
નો-કોડ ઓટોમેશન માર્ગદર્શિકા
7stamp ને CRM, POS, ઓનલાઈન શોપ, સ્પ્રેડશીટ, મેસેજિંગ ટૂલ અથવા કોઈપણ સિસ્ટમ સાથે કનેક્ટ કરવા માટે Make નો ઉપયોગ કરો કે જે કોઈ દૃશ્યમાં ડેટા મોકલી શકે. પ્રોડક્શન-રેડી રૂટ આજે 7stamp API કૉલ્સ માટે Make ની HTTP એપ્લિકેશન છે અને આવનારી 7stamp ઈવેન્ટ્સ માટે Makeની Custom webhook છે.
Makeના એપ પીકરમાં હજુ સુધી કોઈ સાર્વજનિક 7stamp એપ્લિકેશન નથી. એકની રાહ જોશો નહીં: HTTP → Make a request ઉમેરો, ચોક્કસ URL, પદ્ધતિ, Bearer હેડર, અને JSON નીચેનો ઉપયોગ કરો, પછી તમારા સ્રોત મોડ્યુલમાંથી ફીલ્ડ્સને મેપ કરો. આ તે જ 7stamp Integration API છે જેનો ભાવિ કનેક્ટર ઉપયોગ કરશે.
એક ઇવેન્ટ અને એક પરિણામ સાથે પ્રારંભ કરો. એકવાર ટેસ્ટ ડેટા સાચો થઈ જાય, પછી તેની આસપાસ ફિલ્ટર્સ, રાઉટર્સ, CRM અપડેટ્સ અને ફોલો-અપ સંદેશાઓ ઉમેરો.
CRM સંપર્ક ID નો External ID તરીકે ઉપયોગ કરો, 7stamp કાર્ડ બનાવો External ID દ્વારા તમારું પરત આમંત્રણ મોકલો, પછી 38. સામાન્ય ઇમેઇલ, SMS અથવા મેસેજિંગ સ્ટેપ.
પેઇડ POS અથવા ઈકોમર્સ ઓર્ડરથી દૃશ્યને ટ્રિગર કરો. તેના સ્થિર ગ્રાહક IDનો નકશો બનાવો અને ID સ્કેન અ કાર્ડમાં ઓર્ડર કરો, પછી રકમ અથવા સ્પષ્ટ સ્ટેમ્પ ગણતરીનો ઉપયોગ કરો.
જ્યારે કોઈ કાર્ડ ઈવેન્ટ ઈનામ અથવા વાઉચરની જાણ કરે, ત્યારે દૃશ્યને બ્રાન્ચ કરો: CRM અપડેટ કરો, ટીમને સૂચિત કરો અને જ્યારે જરૂર હોય ત્યારે જ વૉલેટ-કાર્ડ પુશ અથવા ઈમેલ મોકલો.
વગર સિસ્ટમને હેન્ડલ કરો 7stamp ને સીધો કૉલ કરવા માટે Make ના HTTP મોડ્યુલનો ઉપયોગ કરો. કસ્ટમ POS, ERP, બુકિંગ એન્જિન અથવા કોઈપણ API-પ્રથમ સેવા માટે આ સાર્વત્રિક પસંદગી છે.
નીચેના દરેક કાર્ડ માટે, HTTP → Make a request ઉમેરો, પછી પદ્ધતિ અને URL બરાબર બતાવ્યા પ્રમાણે સેટ કરો. દરેક વિનંતી માટે સમાન Bearer કીનો ઉપયોગ કરો. જરૂરી મેપિંગ તમને જણાવે છે કે તમારા CRM, POS અથવા ઈકોમર્સ ટ્રિગરમાંથી શું સપ્લાય કરવું.
Webhooks → Custom webhook Make માં Custom webhook બનાવો, તેની URL નકલ કરો, પછી તે URL ને 7stamp પ્રોફાઇલ વેબહુક સેટિંગ્સમાં પેસ્ટ કરો. જ્યારે 7stamp SCAN, REWARD_EARNED, અથવા VOUCHER_ISSUED જેવી કોઈ ઇવેન્ટ મોકલે છે ત્યારે આ દૃશ્ય શરૂ થાય છે.
POST /cards/invite એક બાહ્ય સંપર્ક માટે નવું વ્યક્તિગત ઇન્સ્ટોલ URL અને ડિલિવરી-ઇનસર્ટ કોડ બનાવે છે.
POST /cards/invite/bulk એક વિનંતીમાં 100 જેટલી આમંત્રણ લિંક્સ બનાવે છે. તેનો ઉપયોગ નિયંત્રિત સ્થળાંતર અથવા ઝુંબેશ માટે કરો, અમર્યાદિત સંપર્ક નિકાસ માટે નહીં.
GET /cards વૈકલ્પિક નમૂના અને સ્ત્રોત ફિલ્ટર્સ સાથે, External ID દ્વારા કાર્ડ રેકોર્ડ્સ શોધે છે.
GET /cards/{user_card_id} જ્યારે અગાઉનું પગલું તેનું આંતરિક User Card ID પરત કરે ત્યારે એક કાર્ડની સંપૂર્ણ સ્થિતિ વાંચે છે.
POST /cards/scan ખરીદીની રકમ અથવા સ્પષ્ટ ગણતરીમાંથી સ્ટેમ્પ ઉમેરે છે. તે User Card ID અથવા External ID સ્વીકારે છે અને બાહ્ય ઓર્ડર સંદર્ભ જાળવી શકે છે.
GET /templates API કી પર ઉપલબ્ધ કાર્ડ નમૂનાઓની યાદી આપે છે. કનેક્શન ચકાસવા અથવા ગતિશીલ રીતે ટેમ્પલેટ પસંદ કરવા માટે તેનો ઉપયોગ કરો.
GET /templates/{template_id}/design જાણીતા નમૂના માટે વિઝ્યુઅલ ડિઝાઇન સેટિંગ્સ પરત કરે છે, જ્યારે અન્ય સિસ્ટમને સુસંગત કાર્ડ પસંદગી દર્શાવવાની જરૂર હોય ત્યારે ઉપયોગી.
POST /vouchers/issue External ID અથવા User Card ID દ્વારા ઓળખાયેલ કાર્ડ માલિકને વાઉચર ઈશ્યુ કરે છે.
POST /messages/send રૂપરેખાંકિત ચેનલ અને સંમતિ નિયમોને આધીન, વૉલેટ-કાર્ડ પુશ અને/or ઇમેઇલ દ્વારા કાર્ડ માલિકને સામગ્રી મોકલે છે.
Full 7stamp endpoint URL આ Make મોડ્યુલ છે જે ઉપરના દરેક 7stamp રૂટને કૉલ કરે છે. સંપૂર્ણ URL નો ઉપયોગ કરો, દસ્તાવેજીકૃત પદ્ધતિ પસંદ કરો, Bearer હેડર ઉમેરો અને JSON નો ઉપયોગ ફક્ત ત્યારે જ કરો જ્યારે રૂટને બોડીની જરૂર હોય.
નીચેના નામો વાસ્તવિક Make મોડ્યુલ છે. પ્રથમ દૃશ્યથી પ્રારંભ કરો, તેને નિકાલજોગ સંપર્ક સામે ચલાવો, અને પછી જ રાઉટર્સ, ફિલ્ટર્સ અથવા ઉત્પાદન શેડ્યૂલિંગ ઉમેરો.
અપેક્ષિત પરિણામ: ગ્રાહકને 7stamp દ્વારા પરત કરવામાં આવેલ install_url પ્રાપ્ત થાય છે; તમારું CRM તે URL સમાન સંપર્ક રેકોર્ડમાં રાખી શકે છે.
કોઈપણ લિંક્સ મોકલતા પહેલા: POST /cards/invite હંમેશા નવું આમંત્રણ બનાવે છે. જો તમારો વ્યવસાય નિયમ હાલના સંપર્ક માટે બીજા આમંત્રણને ટાળવાનો હોય તો પહેલા Find Cards નો ઉપયોગ કરો.
અપેક્ષિત પરિણામ: સફળ સ્કેન પ્રતિસાદમાં સફળતા, scan_id, stamps_added અને તમારા આગલા પગલા માટે પોસ્ટ-સ્કેન કાર્ડની સ્થિતિ શામેલ છે.
કોઈપણ લિંક્સ મોકલતા પહેલા: ફરીથી પ્રયાસો પર સમાન external_order_id નો ઉપયોગ કરો જેથી પછીની વેબહૂક ઇવેન્ટ્સમાં ઓર્ડર શોધી શકાય; અસ્પષ્ટ નિષ્ફળ રન પછી બે વાર સ્ટેમ્પ્સ આપશો નહીં.
અપેક્ષિત પરિણામ: Make તરત જ 7stamp ઇવેન્ટ મેળવે છે અને મેળ ખાતી CRM⟧7 અને રેકોર્ડ 4 દ્વારા શોધી શકે છે. external_source.
કોઈપણ લિંક્સ મોકલતા પહેલા: વેબહૂક URL ખાનગી રાખો. બદલી ન શકાય તેવા સંદેશાઓ, વાઉચર્સ અથવા CRM ફેરફારો પર સ્વિચ કરતા પહેલા વાસ્તવિક ઘટનાનું પરીક્ષણ કરો.
આ ચોક્કસ 7stamp Admin સ્ક્રીનો છે. એકવાર કી બનાવો, તેને Make ના સુરક્ષિત HTTP કનેક્શન/keychain માં કૉપિ કરો, પછી તરત જ તેને તમારા ક્લિપબોર્ડમાંથી દૂર કરો.
, API & Integrations → API Keys → Add API Key પર જાઓ. જ્યારે તે વિકલ્પ ઉપલબ્ધ હોય ત્યારે મૂલ્યને Make ના HTTP API-કી કનેક્શન/keychain માં સ્ટોર કરો. ટેક્સ્ટ ફીલ્ડમાંથી કીને ક્યારેય મેપ કરશો નહીં, તેને નોંધમાં મૂકો અથવા બ્રાઉઝર-ફેસિંગ વર્કફ્લોમાં તેનો ઉપયોગ કરશો નહીં. ચાવી એક 7stamp કાર્યસ્થળની છે/profile.
તમારા ⟦552⟟, commer⟧5ce⟧5ce⟧,5ce⟧ માટે પ્લેટફોર્મ પરથી અપરિવર્તનશીલ ID નો નકશો બનાવો. CRM સંપર્ક ID અથવા ગ્રાહક UUID. External Source ઉમેરો જેમ કે હબસ્પોટ, શોપાઇફ અથવા પોસ્ટર જ્યારે સમાન ઓળખકર્તા એક કરતાં વધુ સિસ્ટમમાં દેખાઈ શકે.
જ્યારે કનેક્ટેડ 7stamp પ્રોફાઇલમાં એક સક્રિય કાર્ડ નમૂનો હોય, ત્યારે નમૂનો ખાલી છોડી શકાય છે. બહુવિધ નમૂનાઓ સાથે, નકશો બનાવો અથવા template_id ઇરાદાપૂર્વક પસંદ કરો જેથી દરેક આમંત્રણ અને સ્કેન ઇચ્છિત લોયલ્ટી પ્રોગ્રામ સુધી પહોંચે.
http Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
Authorization: Bearer YOUR_7STAMP_API_KEY
Content-Type: application/json
Body type: Raw / JSON
{
"external_id": "crm_contact_8821",
"external_source": "hubspot",
"template_id": 42
} 7stamp Admin માં, API & Integrations → API Keys → Add API Key માં એક કી બનાવો. જ્યારે તમારું એકાઉન્ટ સેટઅપ તેને મંજૂરી આપે ત્યારે એક અલગ ટેસ્ટ પ્રોફાઇલ/key નો ઉપયોગ કરો.
Make માં, એક દૃશ્ય બનાવો અને સ્રોત ટ્રિગર ઉમેરો. મેપિંગ કરતા પહેલા તેને એકવાર ચલાવો જેથી તમે વાસ્તવિક નમૂનાનો સંપર્ક અથવા પેઇડ ઓર્ડર જોઈ શકો.
આગલા પ્લસ પર ક્લિક કરો, HTTP શોધો અને Make વિનંતી પસંદ કરો. આ પૃષ્ઠ પર ઓપરેશન કાર્ડમાંથી પદ્ધતિ, સંપૂર્ણ URL અને હેડર સેટ કરો.
પ્રથમ વિનંતી તરીકે GET https://api.7loc.com/cards-api/templates નો ઉપયોગ કરો. તેનો સફળ પ્રતિસાદ કોઈપણ ગ્રાહક ડેટાને બદલ્યા વિના મુખ્ય કાર્યોને સાબિત કરે છે.
POST રૂટ માટે, application/json પસંદ કરો અને આ માર્ગદર્શિકામાંથી શરીરનો આકાર પેસ્ટ કરો. એક સ્થિર નકશો External ID; જો પ્રોફાઇલમાં બહુવિધ સક્રિય નમૂનાઓ હોય તો જ template_id ઉમેરો.
નિકાલજોગ સંપર્ક સાથે ચલાવો, HTTP આઉટપુટનું નિરીક્ષણ કરો અને પછી જ તેના ચોક્કસ પ્રતિભાવ ફીલ્ડને આગલા CRM, ઇમેઇલ અથવા મેસેજિંગ મોડ્યુલમાં મેપ કરો.
હવે 7stamp માટે HTTP નો ઉપયોગ કરો: તે દસ્તાવેજીકૃત, ઉત્પાદન-તૈયાર માર્ગ છે, ઘટાડો ફોલબેક નથી. જ્યારે પણ તમને 7stamp ઓપરેશન, નવો API રૂટ અથવા કસ્ટમ POS/ERP કનેક્શનની જરૂર હોય ત્યારે તેને પસંદ કરો. OpenAPI સંદર્ભ એ પદ્ધતિ, સંપૂર્ણ માર્ગ, મુખ્ય ભાગ અને પ્રતિભાવ યોજના માટે સત્યનો સ્ત્રોત છે; બેરર કી અને આધાર URL સમાન રહે છે.
ઇવેન્ટ-સંચાલિત દૃશ્ય માટે, Webhooks → Custom webhook ઉમેરો અને વેબહૂક બનાવો. તેની URL કૉપિ કરો, 7stamp પ્રોફાઇલમાં API & Integrations → Webhooks ખોલો, URL પેસ્ટ કરો, ઇવેન્ટ પ્રકારો પસંદ કરો, સાચવો અને વાસ્તવિક પરીક્ષણ ઇવેન્ટ મોકલો. 7stamp પ્રોફાઇલ તે સબ્સ્ક્રિપ્શનની માલિકી ધરાવે છે; વર્તમાન API ઓટોમેટિક વેબહૂક સબ્સ્ક્રાઇબ/unsubscribe એન્ડપોઇન્ટ્સને છતી કરતું નથી.
આ પૃષ્ઠ પરની સૂચનાઓ Make મોડ્યુલોનો ઉપયોગ કરે છે જે દરેક Make એકાઉન્ટ માટે ઉપલબ્ધ છે. જો તમે HTTP ને બદલે ભાવિ મૂળ 7stamp મોડ્યુલ ઈચ્છો છો, તો અમને તમને જોઈતો વર્કફ્લો મોકલો; ત્યાં સુધી, HTTP અને Custom webhook દરેક દસ્તાવેજીકૃત 7stamp ઓપરેશનને આવરી લે છે.
હા. આજે Make માં કોઈ સાર્વજનિક 7stamp એપ્લિકેશન નથી. HTTP > Make વિનંતી ઉમેરો, સંપૂર્ણ 7stamp એન્ડપોઈન્ટ URL નો ઉપયોગ કરો અને Authorization: Bearer પછી તમારી 7stamp API કી મોકલો. HTTP દરેક દસ્તાવેજીકૃત અંતિમ બિંદુને કૉલ કરી શકે છે.
7stamp Admin માં, API એકીકરણ ખોલો, પછી API Keys, પછી Add API Key. કી કાર્યસ્થળ /profile માટે સ્કોપ્ડ છે જેણે તેને બનાવ્યું છે, તેથી જ્યારે પણ શક્ય હોય ત્યારે પરીક્ષણ દૃશ્યો માટે પરીક્ષણ પ્રોફાઇલનો ઉપયોગ કરો.
સ્ત્રોત સિસ્ટમમાંથી સ્થિર ઓળખકર્તાનો ઉપયોગ કરો, પ્રાધાન્ય CRM સંપર્ક ID અથવા ગ્રાહક UUID. પ્રદર્શન નામનો ઉપયોગ કરશો નહીં. ફોન નંબર અથવા ઈમેલ કામ કરી શકે છે, પરંતુ બદલાઈ શકે છે અને તેને સતત હેન્ડલ કરવું જોઈએ.
Make માં વેબહૂક > Custom webhook બનાવો, પછી 7stamp પ્રોફાઇલના વેબહુક સેટિંગ્સમાં તેના જનરેટ કરેલ URL પેસ્ટ કરો. ડિલિવરી પછી ઇનકમિંગ event_type હેન્ડલ કરવા માટે Make ફિલ્ટર અથવા રાઉટરનો ઉપયોગ કરો.
આગલું પગલું
API કી બનાવો, List Templates પરીક્ષણ કરો અને નિકાલજોગ સંપર્ક સાથે એક આમંત્રણ અથવા સ્કેન દૃશ્ય બનાવો. સરળ પ્રવાહ વિશ્વસનીય હોય તે પછી જ રાઉટર્સ અને મેસેજિંગ ઉમેરો.