നിങ്ങളുടെ CRM
ലോയൽറ്റി ഹിസ്റ്ററിയിലേക്ക് മിറർ ചെയ്യുക. 7Stamp-ലേക്ക് ലോഗിൻ ചെയ്യാതെ തന്നെ വിൽപ്പന, കോളുകൾ, ടിക്കറ്റുകൾ എന്നിവയ്ക്ക് അടുത്തുള്ള മുഴുവൻ ലോയൽറ്റി ടൈംലൈൻ നിങ്ങൾക്ക് കാണാം.
ഡെവലപ്പർ സംയോജനം
7Stamp Webhooks
ലഭ്യമാണ്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
എന്നതുമായി പരസ്പരബന്ധം പുലർത്തുക. നിങ്ങളുടെ സ്വന്തം 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
}
}
}ഒരു വെബ്‌ഹുക്ക് കോൺഫിഗർ ചെയ്യുകയും പരിശോധിക്കുകയും ചെയ്യുക
നിങ്ങളുടെ ബാക്കെൻഡിൽ HTTPS എൻഡ്‌പോയിൻ്റ് സൃഷ്‌ടിക്കുക, CRM ഇൻ്റഗ്രേഷൻ ലെയർ, Make⟧⟦3, അല്ലെങ്കിൽ 26 Catch Hook. Make ലക്ഷ്യസ്ഥാനം URL പകർത്തുന്നതിന് മുമ്പ് നിങ്ങൾ അത് നിയന്ത്രിക്കുന്നുവെന്ന് ഉറപ്പാക്കുക.
7Stamp Admin-ൽ, Stamp Cards → API & Integrations → Webhooks തുറക്കുക.
എൻഡ്‌പോയിന്റ് URL ചേർക്കുക. വെബ്‌ഹുക്കിന് പ്രൊഫൈലിലെ എല്ലാ കാർഡ് ഇവന്റുകളും ലഭിക്കുന്നതിനാൽ, നിങ്ങളുടെ റിസീവറിൽ data.event_type അനുസരിച്ച് ഫിൽട്ടർ ചെയ്യുക.
പ്രൊഫൈൽ ക്രമീകരണങ്ങൾ സംരക്ഷിക്കുക, തുടർന്ന് ഒരു ഇവൻ്റ് നിർമ്മിക്കുന്നതിന് ഡിസ്പോസിബിൾ ടെസ്റ്റ് സ്കാൻ അല്ലെങ്കിൽ കാർഡ് പ്രവർത്തനം ട്രിഗർ ചെയ്യുക.
ലഭിച്ച പേലോഡ് പരിശോധിക്കുക. പ്രതീക്ഷിച്ച റെക്കോർഡുമായി External ID, External Source എന്നിവ പൊരുത്തപ്പെടുത്തുക, റിസീവർ വിജയകരമായ പ്രതികരണം നൽകുന്നുവെന്ന് സ്ഥിരീകരിക്കുക.
നിങ്ങൾക്ക് റീപ്ലേ-സേഫ് ഹാൻഡ്‌ലിംഗിനും പരാജയങ്ങൾ നിരീക്ഷിക്കുന്നതിനും ശേഷം മാത്രം CRM, വൗച്ചർ അല്ലെങ്കിൽ സന്ദേശമയയ്ക്കൽ പാർശ്വഫലങ്ങൾ പ്രവർത്തനക്ഷമമാക്കുക.
നോ-കോഡ് ഓപ്‌ഷനുകൾ: Make, Zapier
Make-ൽ, സ്വീകരിക്കുന്ന പ്രൊഫൈൽ സൃഷ്ടിക്കുന്നതിന് Webhooks → Custom webhook ഉപയോഗിക്കുക. Zapier-ൽ, ഇതേ ആവശ്യത്തിനായി Webhooks by Zapier → Catch Hook ഉപയോഗിക്കുക. നിലവിലെ API സ്വയമേവയുള്ള വെബ്‌ഹുക്ക് രജിസ്‌ട്രേഷൻ എൻഡ്‌പോയിൻ്റുകൾ വെളിപ്പെടുത്താത്തതിനാൽ 7Stamp പ്രൊഫൈലിന് സബ്‌സ്‌ക്രിപ്‌ഷൻ ഉണ്ട്.
സെക്യൂരിറ്റിയും ഡെലിവറി കരാറും
നിലവിലെ പേലോഡ് സ്കീമയുടെ ഉറവിടമായി പൊതു 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-മായി താരതമ്യം ചെയ്യുക. ഏതൊരു JSON പാഴ്‌സിംഗിനും മുമ്പ്, t അയച്ചതുപോലെ തന്നെയും ബോഡി ലഭിച്ച റോ ബൈറ്റുകളായും എടുക്കുക. നിങ്ങൾ ഇതിനകം പ്രോസസ്സ് ചെയ്ത X-Webhook-Event-Id ഉള്ള ഡെലിവറി ഒഴിവാക്കുക: വീണ്ടും ശ്രമിക്കുമ്പോൾ പുതിയ t ഉപയോഗിച്ച് വീണ്ടും സൈൻ ചെയ്യുന്നു.
അനുബന്ധ പേജുകൾ
അടുത്ത ഘട്ടം
ആദ്യ കാർഡ് ഇവൻ്റ് അയയ്ക്കാൻ തയ്യാറാണോ?
ഒരു റിസീവർ സൃഷ്‌ടിക്കുക, അതിൻ്റെ HTTPS URL പ്രൊഫൈലിൽ ഒട്ടിക്കുക, ഡിസ്പോസിബിൾ സ്കാൻ പ്രവർത്തിപ്പിക്കുക, ഡൗൺസ്ട്രീം ഓട്ടോമേഷൻ പ്രവർത്തനക്ഷമമാക്കുന്നതിന് മുമ്പ് പൊരുത്തപ്പെടുന്ന External ID സാധൂകരിക്കുക.