డెవలపర్ ఇంటిగ్రేషన్
7Stamp నుండి ప్రతి లాయల్టీ ఈవెంట్‌ను నిజ సమయంలో మీ స్వంత సిస్టమ్‌లకు పుష్ చేయండి. పోలింగ్ మరియు షెడ్యూల్ చేయబడిన API కాల్‌లు లేవు. ఈవెంట్‌లు జరిగిన కొన్ని సెకన్లలో HTTPS POST అభ్యర్థనల వలె అందుతాయి.
మీ CRM, ERP లేదా అనుకూల బ్యాకెండ్‌ని లాయల్టీ వైపు జరిగే వాటితో సమకాలీకరించడానికి వెబ్‌హూక్‌లను ఉపయోగించండి: ఎవరు చేరారు, ఎవరు స్టాంప్ పొందారు, ఎవరు వోచర్‌ను రీడీమ్ చేసారు, పుట్టినరోజు బహుమతిని ట్రిగ్గర్ చేసినవారు మరియు నిష్క్రియంగా మారిన వారు. ఆ డేటాతో ఏమి చేయాలో మీ సిస్టమ్‌లు నిర్ణయిస్తాయి.
Webhookలు ఇంటిగ్రేషన్ స్టాక్ యొక్క అవుట్‌బౌండ్ వైపు. విక్రయాలు, సేవ, విశ్లేషణలు మరియు సందేశాల కోసం మీరు ఇప్పటికే విశ్వసిస్తున్న సిస్టమ్‌లలో కస్టమర్ మరియు రివార్డ్ యాక్టివిటీని ప్రతిబింబిస్తాయి.
ప్రతి స్టాంప్, వోచర్, పుట్టినరోజు మరియు నిష్క్రియాత్మకత మీ CRMలోని కస్టమర్ రికార్డ్‌లో ల్యాండ్ అవుతాయి. మీరు 7Stampకి లాగిన్ చేయకుండానే విక్రయాలు, కాల్‌లు మరియు టిక్కెట్‌ల పక్కన పూర్తి లాయల్టీ టైమ్‌లైన్‌ని చూస్తారు.
కస్టమర్ వోచర్‌ను రీడీమ్ చేసినప్పుడు, మీ ప్రస్తుత SMS గేట్‌వే నుండి కృతజ్ఞతలు తెలుపుతూ SMSని పంపండి. కస్టమర్ లక్ష్యాన్ని చేరుకున్నప్పుడు, Slackలో వేడుకను పోస్ట్ చేయండి. ఎవరైనా ఇన్‌యాక్టివ్‌గా మారినప్పుడు, కేసును మీ ఖాతా మేనేజర్‌కి పంపండి.
ఈవెంట్‌లను మీ BI సాధనం, గిడ్డంగి లేదా సయోధ్య పైప్‌లైన్‌లోకి ప్రసారం చేయండి. POS రసీదులతో వోచర్ రిడీమ్‌లను సరిపోల్చండి మరియు మీ స్వంత కొలమానాలలో ROI లాయల్టీని లెక్కించండి.
మీ ఎండ్‌పాయింట్ HTTPS POSTని ఆమోదించాలి, అభ్యర్థన ఆకారాన్ని ధృవీకరించాలి, ఈవెంట్‌ను కొనసాగించాలి లేదా క్యూలో ఉంచాలి, ఆపై విజయవంతమైన 2xx ప్రతిస్పందనను అందించాలి. రసీదుని సురక్షితంగా క్యూలో ఉంచగలిగితే దానికి ముందు నెమ్మదిగా CRM లేదా మెసేజింగ్ కాల్ చేయవద్దు.
ప్రతి సంబంధిత ఈవెంట్ External ID మరియు కార్డ్‌ని సృష్టించేటప్పుడు లేదా స్కాన్ చేస్తున్నప్పుడు మీరు ఉపయోగించిన ఐచ్ఛిక External Sourceని కలిగి ఉంటుంది. పేరు లేదా ఇమెయిల్ నుండి ఊహించకుండా మీ స్వంత CRM, POS లేదా ఆర్డర్ రికార్డ్‌ని నవీకరించడానికి ఈ జతని ఉపయోగించండి.
దుష్ప్రభావాలను ట్రిగ్గర్ చేయడానికి ముందు మన్నికైన ప్రాసెసింగ్ కీ లేదా ఈవెంట్ వేలిముద్రను నిల్వ చేయండి. మీ రిసీవర్ మళ్లీ అదే డెలివరీని చూసినట్లయితే, అది నకిలీ 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
}
}
}మీ బ్యాకెండ్, CRM ఇంటిగ్రేషన్ లేయర్, CRM ఇంటిగ్రేషన్ లేయర్, HTTPS ఎండ్ పాయింట్‌ని సృష్టించండి Catch Hook. Make దాని URLని కాపీ చేయడానికి ముందు మీరు గమ్యాన్ని నియంత్రిస్తారని ఖచ్చితంగా చెప్పండి.
7Stamp Adminలో, Stamp Cards → API & Integrations → Webhooksని తెరవండి.
ఎండ్‌పాయింట్ URLని జోడించండి. వెబ్‌హుక్ ప్రొఫైల్‌లోని ప్రతి కార్డ్ ఈవెంట్‌ను అందుకుంటుంది, కాబట్టి మీ రిసీవర్‌లో data.event_type ఆధారంగా ఫిల్టర్ చేయండి.
ప్రొఫైల్ సెట్టింగ్‌లను సేవ్ చేయండి, ఆపై ఈవెంట్‌ను రూపొందించడానికి డిస్పోజబుల్ టెస్ట్ స్కాన్ లేదా కార్డ్ చర్యను ప్రారంభించండి.
అందుకున్న పేలోడ్‌ని తనిఖీ చేయండి. External ID మరియు External Sourceలను ఊహించిన రికార్డ్‌కు సరిపోల్చండి మరియు రిసీవర్ విజయవంతమైన ప్రతిస్పందనను అందించినట్లు నిర్ధారించండి.
మీరు రీప్లే-సురక్షిత నిర్వహణ మరియు వైఫల్యాల కోసం పర్యవేక్షించిన తర్వాత మాత్రమే CRM, వోచర్ లేదా సందేశ దుష్ప్రభావాలను ప్రారంభించండి.
Makeలో, స్వీకరించే URLని రూపొందించడానికి Webhooks → Custom webhookని ఉపయోగించండి మరియు దానిని 7Stamp ప్రొఫైల్‌లో అతికించండి. 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లో లేదా Catch Hookలో Zapierని సృష్టించండి, ఉత్పత్తి చేయబడిన URLని కాపీ చేసి, ఆపై దానిని 7Stamp ప్రొఫైల్ యొక్క వెబ్‌హుక్ సెట్టింగ్‌లలో అతికించి, పరీక్ష ఈవెంట్‌ను పంపండి.
data.external_id ను, అందుబాటులో ఉంటే data.external_source ను ఉపయోగించండి: మీ స్వంత IDతో API ద్వారా మీరు జారీ చేసిన కార్డ్‌ల ప్రతి వెబ్‌హుక్‌లో ఇవి తిరిగి వస్తాయి. కార్డ్‌ను స్వయంగా తీసుకున్న కస్టమర్‌కు External ID ఉండదు, కాబట్టి వారిని data.user.email ద్వారా సరిపోల్చండి. Apple “Hide My Email” చిరునామా ఒక రిలే చిరునామా, మీ CRMలో ఉన్నది కాదు.
X-Webhook-Signature హెడర్‌ను t మరియు s గా విభజించండి, 7Stamp Admin నుండి పొందిన వెబ్‌హుక్ సీక్రెట్‌తో t మరియు రా రిక్వెస్ట్ బాడీని కలిపి HMAC-SHA256ను లెక్కించి, దాన్ని hexగా ఎన్‌కోడ్ చేసి, s తో పోల్చండి. t ను పంపిన విధంగానే ఖచ్చితంగా, బాడీని అందుకున్న రా బైట్‌లుగా, ఏ JSON పార్సింగ్‌కైనా ముందే తీసుకోండి. మీరు ఇప్పటికే ప్రాసెస్ చేసిన X-Webhook-Event-Id ఉన్న డెలివరీని వదిలేయండి: రీట్రైకి కొత్త t తో మళ్లీ సంతకం చేయబడుతుంది.
సంబంధిత పేజీలు
తదుపరి దశ
రిసీవర్‌ని సృష్టించండి, దాని HTTPS URLని ప్రొఫైల్‌లో అతికించండి, డిస్పోజబుల్ స్కాన్‌ను అమలు చేయండి మరియు డౌన్‌స్ట్రీమ్ ఆటోమేషన్‌ను ప్రారంభించే ముందు సరిపోలే External IDని ధృవీకరించండి.