તમારા CRM
દરેક સ્ટેમ્પ, વાઉચર, જન્મદિવસ અને નિષ્ક્રિયતા ટ્રિગર તમારા CRM માં ગ્રાહકના રેકોર્ડ પર આવે છે. તમે 7Stamp માં લૉગ ઇન કર્યા વિના વેચાણ, કૉલ્સ અને ટિકિટની બાજુમાં સંપૂર્ણ લોયલ્ટી સમયરેખા જોશો.
વિકાસકર્તા એકીકરણ
7Stamp વેબહુક્સ
ઉપલબ્ધદરેક લોયલ્ટી ઈવેન્ટને 7Stamp થી તમારી પોતાની સિસ્ટમ્સ પર રીઅલ ટાઇમમાં દબાણ કરો. કોઈ મતદાન નથી અને કોઈ શેડ્યૂલ કરેલ API કૉલ્સ નથી. ઘટનાઓ બનવાની સેકન્ડોમાં HTTPS POST વિનંતીઓ તરીકે આવે છે.
તમારા CRM, ERP, અથવા કસ્ટમ બેકએન્ડને લોયલ્ટી બાજુ પર શું થઈ રહ્યું છે તેની સાથે સમન્વયમાં રાખવા માટે વેબહૂકનો ઉપયોગ કરો: કોણ જોડાયું, કોણ સ્ટેમ્પ મેળવ્યું, કોણે વાઉચર રિડીમ કર્યું, જેણે જન્મદિવસની ભેટ ટ્રિગર કરી અને કોણ નિષ્ક્રિય બન્યું. પછી તમારી સિસ્ટમ્સ નક્કી કરે છે કે તે ડેટા સાથે શું કરવું.
તમે વેબહુક્સ સાથે શું કરી શકો છો
વેબહુક્સ એ એકીકરણ સ્ટેકની આઉટબાઉન્ડ બાજુ છે. તેઓ ગ્રાહકને પ્રતિબિંબિત કરે છે અને વેચાણ, સેવા, એનાલિટિક્સ અને મેસેજિંગ માટે તમે પહેલાથી જ વિશ્વાસ કરો છો તે સિસ્ટમમાં પુરસ્કાર પ્રવૃત્તિ.
તમારા પોતાના મેસેજિંગ સ્ટેકને ટ્રિગર કરો
જ્યારે કોઈ ગ્રાહક વાઉચર રિડીમ કરે, ત્યારે તમારા હાલના SMS ગેટવે પરથી આભાર SMS મોકલો. જ્યારે ગ્રાહક લક્ષ્ય પ્રાપ્ત કરે છે, ત્યારે Slack માં ઉજવણી પોસ્ટ કરો. જ્યારે કોઈ વ્યક્તિ નિષ્ક્રિય થઈ જાય, ત્યારે કેસ તમારા એકાઉન્ટ મેનેજરને મોકલો.
પાવર એનાલિટિક્સ અને સમાધાન
તમારા BI ટૂલ, વેરહાઉસ અથવા સમાધાન પાઇપલાઇનમાં ઇવેન્ટ્સને સ્ટ્રીમ કરો. POS રસીદો સામે વાઉચર રિડેમ્પશનનો મેળ કરો અને તમારા પોતાના મેટ્રિક્સમાં લોયલ્ટી ROIની ગણતરી કરો.
કાર્ડ ઇવેન્ટ પ્રકારો
SCAN — કાર્ડને સ્કેન/stamp ક્રિયા પ્રાપ્ત થઈ.
REWARD_EARNED — કાર્ડ પર પુરસ્કાર મળ્યો.
VOUCHER_ISSUED — વાઉચર જારી કરવામાં આવ્યું હતું.
VOUCHER_REDEEMED — વાઉચર રિડીમ કરવામાં આવ્યું હતું.
LOTTERY_WIN — લોટરી જીતમાં પરિણમી.
DELIVERY_INSERT — ડિલિવરી-ઇનસર્ટ ફ્લો રેકોર્ડ કરવામાં આવ્યો હતો.
CARD_JOINED — એક ગ્રાહક કાર્ડ સાથે જોડાયો.
CARD_CAMPAIGN — કાર્ડ ઝુંબેશની ઘટના બની.
BIRTHDAY_GREETING — જન્મદિવસની શુભેચ્છા પાઠવવાની ઘટના બની.
ADMIN_VOUCHER_ISSUE — એડમિનિસ્ટ્રેટરે વાઉચર જારી કર્યું.
CARD_ADDED_TO_WALLET — એક ગ્રાહકે તેમના વૉલેટમાં કાર્ડ ઉમેર્યું.
CARD_REMOVED_FROM_WALLET — એક ગ્રાહકે તેમના વૉલેટમાંથી કાર્ડ કાઢી નાખ્યું.
સુરક્ષિત વેબહૂક રીસીવર બનાવો
ટકાઉ હેન્ડલિંગ પછી સ્વીકારો
તમારા અંતિમ બિંદુએ HTTPS POST સ્વીકારવું જોઈએ, વિનંતીના આકારને માન્ય કરવો જોઈએ, ઘટનાને ચાલુ રાખો અથવા કતારમાં રાખો, પછી સફળ 2xx પ્રતિસાદ પરત કરો. સ્વીકૃતિ પહેલાં ધીમો CRM અથવા મેસેજિંગ કૉલ કરશો નહીં જો તે સુરક્ષિત રીતે કતારમાં હોઈ શકે.
External ID
સાથે સહસંબંધિત દરેક સંબંધિત ઘટના External ID અને વૈકલ્પિક External Source લઈ શકે છે જેનો તમે કાર્ડ બનાવતી વખતે અથવા સ્કેન કરતી વખતે ઉપયોગ કર્યો હતો. આ જોડીનો ઉપયોગ તમારા પોતાના CRM, POS અપડેટ કરવા અથવા નામ અથવા ઈમેલ પરથી અનુમાન લગાવ્યા વિના રેકોર્ડ ઓર્ડર કરવા માટે કરો.
Make ડિલિવરી અશક્તિ
આડઅસર શરૂ કરતા પહેલા ટકાઉ પ્રોસેસિંગ કી અથવા ઇવેન્ટ ફિંગરપ્રિન્ટ સ્ટોર કરો. જો તમારા રીસીવરને તે જ ડિલિવરી ફરીથી દેખાય, તો તેણે ડુપ્લિકેટ CRM નોંધ, વાઉચર અથવા સંદેશ ઉમેરવો જોઈએ નહીં. અંતિમ બિંદુ URL ને ગુપ્ત તરીકે માનો.
ઉદાહરણ ઇવેન્ટ પેલોડ આકાર
આને તમારા ઓટોમેશન સ્ટેપમાં કૉપિ કરો
json {
"entity": "card_event",
"action": "created",
"entity_id": 707,
"event_id": "8f05e58decec48e09d328f0edebbacf6",
"profile_id": 2,
"profile_name": "Your Business",
"profile_lang": "en",
"data": {
"event_type": "SCAN",
"scanned_at": "2026-10-01T09:19:24.179424",
"user_card_id": 10,
"card_template_id": 14,
"card_template_name": "Collect your stamps!",
"stamps_added": 3,
"stamps_before": 1,
"stamps_after": 4,
"amount": null,
"external_order_id": "ORDER-1001",
"workplace": { "id": 4, "name": "Bar Counter" },
"device_type": null,
"external_id": "odoo_contact_8821",
"external_source": "odoo",
"issued_vouchers": [
{
"id": 174,
"unique_code": "100425813507",
"stamp_number": 4,
"issued_at": "2026-10-01T09:19:24.191836",
"expires_at": "2027-01-01T23:59:59",
"status": "ACTIVE",
"voucher_template_id": 58,
"voucher_description": "Free coffee",
"voucher_image_url": "https://..."
}
],
"achieved_goals": [],
"user": {
"id": 2,
"name": "Anna",
"full_name": "Anna Smith",
"email": "anna@example.com",
"telegram_chat_id": null,
"telegram_username": null,
"whatsapp_phone": null,
"birth_date": null
}
}
}વેબહૂક ગોઠવો અને તેનું પરીક્ષણ કરો
Create an HTTPS endpoint in your backend, CRM integration layer, Make webhook, or Zapier Catch Hook. Make sure you control the destination before copying its URL.
7Stamp Admin માં, Stamp Cards → API & Integrations → Webhooks ખોલો.
એન્ડપોઇન્ટ URL ઉમેરો. વેબહૂક પ્રોફાઇલની દરેક કાર્ડ ઇવેન્ટ મેળવે છે, તેથી તમારા રીસીવરમાં data.event_type મુજબ ફિલ્ટર કરો.
પ્રોફાઇલ સેટિંગ્સ સાચવો, પછી ઇવેન્ટ બનાવવા માટે નિકાલજોગ પરીક્ષણ સ્કેન અથવા કાર્ડ ક્રિયાને ટ્રિગર કરો.
પ્રાપ્ત પેલોડની તપાસ કરો. અપેક્ષિત રેકોર્ડ સાથે External ID અને External Source મેચ કરો અને ખાતરી કરો કે પ્રાપ્તકર્તા સફળ પ્રતિસાદ આપે છે.
CRM, વાઉચર અથવા મેસેજિંગ સાઇડ ઇફેક્ટ્સને સક્ષમ કરો પછી જ તમારી પાસે નિષ્ફળતાઓ માટે રિપ્લે-સેફ હેન્ડલિંગ અને મોનિટરિંગ હોય.
નો-કોડ વિકલ્પો: Make અને Zapier
Make માં, Webhooks → Custom webhook નો ઉપયોગ કરીને પ્રોફાઇલ જનરેટ કરવા માટે ⟦818⟟ પેસ્ટ કરો અને 83⟧. Zapier માં, સમાન હેતુ માટે Webhooks by Zapier → Catch Hook નો ઉપયોગ કરો. 7Stamp પ્રોફાઇલ સબ્સ્ક્રિપ્શનની માલિકી ધરાવે છે કારણ કે વર્તમાન API સ્વયંસંચાલિત વેબહૂક નોંધણીના અંતિમ બિંદુઓને જાહેર કરતું નથી.
સુરક્ષા અને વિતરણ કરાર
વર્તમાન પેલોડ સ્કીમા માટે સ્રોત તરીકે સાર્વજનિક OpenAPI સંદર્ભના Webhooks વિભાગનો ઉપયોગ કરો. બોડી એક એન્વેલપ છે: profile_id અને profile_name 7Stamp પ્રોફાઇલ દર્શાવે છે, event_id ઇવેન્ટને ઓળખે છે, અને કાર્ડ ઇવેન્ટ પોતે data માં હોય છે (Make અથવા Zapier URL માટે કી card_event છે). દરેક ડિલિવરી એક જ હેડરમાં સહી કરેલી હોય છે, X-Webhook-Signature: t=…,s=…. તમારા વેબહૂક સિક્રેટ વડે t અને તેના પછી આવતી કાચી વિનંતી બોડી પર HMAC-SHA256 ગણો, તેને hex માં એન્કોડ કરો અને s સાથે સરખાવો; સિક્રેટ 7Stamp Admin માં વેબહૂકના પેજ પર છે. પુનરાવર્તિત ડિલિવરી છોડી દેવા માટે X-Webhook-Event-Id નો ઉપયોગ કરો: રીટ્રાય નવા t સાથે ફરીથી સહી થાય છે. તમે એન્ડપોઇન્ટને Basic Auth વડે પણ સુરક્ષિત કરી શકો છો. HTTPS ફરજિયાત રાખો અને રીસીવર URL ને સાર્વજનિક લૉગ્સથી દૂર રાખો.
વારંવાર પૂછાતા પ્રશ્નો
શું હું માત્ર અમુક વેબહૂક ઇવેન્ટ્સ પસંદ કરી શકું?
ના. 7Stamp વેબહૂક પ્રોફાઇલની દરેક કાર્ડ ઇવેન્ટ મેળવે છે. તમારા રીસીવરમાં data.event_type મુજબ ફિલ્ટર કરો; Make અને Zapier માં ઇવેન્ટ card_event હેઠળ આવે છે, તેથી card_event.event_type મુજબ ફિલ્ટર કરો.
હું વેબહુક્સને Make અથવા Zapier સાથે કેવી રીતે કનેક્ટ કરી શકું?
Make અથવા Catch Hook માં Zapier માં રીસીવિંગ વેબહુક બનાવો, જનરેટ કરેલ URL કોપી કરો, પછી તેને 7Stamp પ્રોફાઇલની વેબહૂક સેટિંગમાં પેસ્ટ કરો અને ઇવેન્ટ સેટિંગનું પરીક્ષણ કરો.
મારે મારા CRM સંપર્ક સાથે ઇવેન્ટનો મેળ કેવી રીતે કરવો જોઈએ?
data.external_id અને, જો હાજર હોય તો, data.external_source નો ઉપયોગ કરો: તમે તમારા પોતાના ID સાથે API દ્વારા જારી કરેલાં કાર્ડ્સ માટે તે દરેક વેબહૂકમાં પાછા આવે છે. જે ગ્રાહકે કાર્ડ જાતે લીધું હોય તેની પાસે External ID હોતું નથી, તેથી તેનો મેળ data.user.email દ્વારા બેસાડો. Apple “Hide My Email” સરનામું એક રિલે સરનામું છે, તમારા CRM માંનું સરનામું નથી.
વેબહૂક 7Stamp માંથી આવ્યો છે તે કેવી રીતે તપાસવું?
X-Webhook-Signature હેડરને t અને s માં વિભાજિત કરો, 7Stamp Admin માંથી મળેલા વેબહૂક સિક્રેટ વડે t અને તેના પછી આવતી કાચી વિનંતી બોડી પર HMAC-SHA256 ગણો, તેને hex માં એન્કોડ કરો અને s સાથે સરખાવો. t ને બરાબર જેમ મોકલાયું હોય તેમ જ લો અને બોડીને કોઈપણ JSON પાર્સિંગ પહેલાં, મળેલા કાચા બાઇટ્સ તરીકે લો. જે ડિલિવરીનો X-Webhook-Event-Id તમે પહેલેથી પ્રોસેસ કરી લીધો હોય તેને છોડી દો: રીટ્રાય નવા t સાથે ફરીથી સહી થાય છે.
સંબંધિત પૃષ્ઠો
આગલું પગલું
પ્રથમ કાર્ડ ઇવેન્ટ મોકલવા માટે તૈયાર છો?
રીસીવર બનાવો, તેનો HTTPS URL પ્રોફાઇલમાં પેસ્ટ કરો, નિકાલજોગ સ્કેન ચલાવો અને ડાઉનસ્ટ્રીમ ઓટોમેશનને સક્ષમ કરતા પહેલા મેચિંગ External IDને માન્ય કરો.