డెవలపర్ ఇంటిగ్రేషన్

7stamp వెబ్‌హూక్స్

అందుబాటులో ఉంది

7stamp నుండి ప్రతి లాయల్టీ ఈవెంట్‌ను నిజ సమయంలో మీ స్వంత సిస్టమ్‌లకు పుష్ చేయండి. పోలింగ్ మరియు షెడ్యూల్ చేయబడిన API కాల్‌లు లేవు. ఈవెంట్‌లు జరిగిన కొన్ని సెకన్లలో HTTPS POST అభ్యర్థనల వలె అందుతాయి.

మీ CRM, ERP లేదా అనుకూల బ్యాకెండ్‌ని లాయల్టీ వైపు జరిగే వాటితో సమకాలీకరించడానికి వెబ్‌హూక్‌లను ఉపయోగించండి: ఎవరు చేరారు, ఎవరు స్టాంప్ పొందారు, ఎవరు వోచర్‌ను రీడీమ్ చేసారు, పుట్టినరోజు బహుమతిని ట్రిగ్గర్ చేసినవారు మరియు నిష్క్రియంగా మారిన వారు. ఆ డేటాతో ఏమి చేయాలో మీ సిస్టమ్‌లు నిర్ణయిస్తాయి.

వెబ్‌హుక్స్‌తో మీరు ఏమి చేయవచ్చు

Webhookలు ఇంటిగ్రేషన్ స్టాక్ యొక్క అవుట్‌బౌండ్ వైపు. విక్రయాలు, సేవ, విశ్లేషణలు మరియు సందేశాల కోసం మీరు ఇప్పటికే విశ్వసిస్తున్న సిస్టమ్‌లలో కస్టమర్ మరియు రివార్డ్ యాక్టివిటీని ప్రతిబింబిస్తాయి.

లాయల్టీ హిస్టరీని మీ CRMకి ప్రతిబింబించండి

ప్రతి స్టాంప్, వోచర్, పుట్టినరోజు మరియు నిష్క్రియాత్మకత మీ CRMలోని కస్టమర్ రికార్డ్‌లో ల్యాండ్ అవుతాయి. మీరు 7stampకి లాగిన్ చేయకుండానే విక్రయాలు, కాల్‌లు మరియు టిక్కెట్‌ల పక్కన పూర్తి లాయల్టీ టైమ్‌లైన్‌ని చూస్తారు.

మీ స్వంత మెసేజింగ్ స్టాక్‌ను ట్రిగ్గర్ చేయండి

కస్టమర్ వోచర్‌ను రీడీమ్ చేసినప్పుడు, మీ ప్రస్తుత 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
{
  "event_type": "SCAN",
  "scanned_at": "2026-07-23T12:34:56Z",
  "user_card_id": 123,
  "card_template_id": 42,
  "card_template_name": "Coffee Loyalty",
  "stamps_added": 1,
  "stamps_before": 4,
  "stamps_after": 5,
  "amount": 24.5,
  "external_order_id": "order_2048",
  "external_id": "crm_contact_8821",
  "external_source": "hubspot"
}

వెబ్‌హూక్‌ని కాన్ఫిగర్ చేసి పరీక్షించండి

01

మీ బ్యాకెండ్, CRM ఇంటిగ్రేషన్ లేయర్, CRM ఇంటిగ్రేషన్ లేయర్, HTTPS ఎండ్ పాయింట్‌ని సృష్టించండి Catch Hook. Make దాని URLని కాపీ చేయడానికి ముందు మీరు గమ్యాన్ని నియంత్రిస్తారని ఖచ్చితంగా చెప్పండి.

02

7stamp Adminలో, Stamp Cards → API & Integrations → Webhooksని తెరవండి.

03

ఎండ్‌పాయింట్ URLని జోడించి, స్వీకరించే వర్క్‌ఫ్లో వాస్తవానికి అవసరమైన ఈవెంట్ రకాలను మాత్రమే ఎంచుకోండి.

04

ప్రొఫైల్ సెట్టింగ్‌లను సేవ్ చేయండి, ఆపై ఈవెంట్‌ను రూపొందించడానికి డిస్పోజబుల్ టెస్ట్ స్కాన్ లేదా కార్డ్ చర్యను ప్రారంభించండి.

05

అందుకున్న పేలోడ్‌ని తనిఖీ చేయండి. External ID మరియు External Sourceలను ఊహించిన రికార్డ్‌కు సరిపోల్చండి మరియు రిసీవర్ విజయవంతమైన ప్రతిస్పందనను అందించినట్లు నిర్ధారించండి.

06

మీరు రీప్లే-సురక్షిత నిర్వహణ మరియు వైఫల్యాల కోసం పర్యవేక్షించిన తర్వాత మాత్రమే CRM, వోచర్ లేదా సందేశ దుష్ప్రభావాలను ప్రారంభించండి.

నో-కోడ్ ఎంపికలు: Make మరియు Zapier

Makeలో, స్వీకరించే URLని రూపొందించడానికి Webhooks → Custom webhookని ఉపయోగించండి మరియు దానిని 7stamp ప్రొఫైల్‌లో అతికించండి. Zapierలో, అదే ప్రయోజనం కోసం Webhooks by Zapier → Catch Hookని ఉపయోగించండి. 7stamp ప్రొఫైల్ సభ్యత్వాన్ని కలిగి ఉంది ఎందుకంటే ప్రస్తుత API ఆటోమేటిక్ వెబ్‌హుక్ నమోదు ముగింపు పాయింట్‌లను బహిర్గతం చేయదు.

భద్రత మరియు డెలివరీ ఒప్పందం

ప్రస్తుత పేలోడ్ స్కీమా మరియు ఫీల్డ్ అర్థానికి మూలంగా పబ్లిక్ OpenAPI సూచన యొక్క Webhooks విభాగాన్ని ఉపయోగించండి. HTTPS అవసరం, రిసీవర్ URLని పబ్లిక్ లాగ్‌ల నుండి దూరంగా ఉంచండి మరియు ప్రాసెసింగ్ ఐడెంపోటెంట్‌గా చేయండి. నిర్దిష్ట హెడర్ పేరును అమలు చేయడానికి లేదా ఉత్పత్తిలో విధానాన్ని మళ్లీ ప్రయత్నించడానికి ముందు ఆన్‌బోర్డింగ్ సమయంలో మీ 7stamp ప్రొఫైల్ కోసం అభ్యర్థన-ప్రామాణీకరణ/signature విధానాన్ని నిర్ధారించండి.

తరచుగా అడిగే ప్రశ్నలు

నేను నిర్దిష్ట వెబ్‌హుక్ ఈవెంట్‌లను మాత్రమే ఎంచుకోవచ్చా?

అవును. 7stamp ప్రొఫైల్ వెబ్‌హూక్ సెట్టింగ్‌లలో ఈవెంట్ రకాలను ఎంచుకోండి, తద్వారా రిసీవర్ తన వర్క్‌ఫ్లోకి సంబంధించిన ఈవెంట్‌లను మాత్రమే పొందుతుంది.

నేను వెబ్‌హూక్‌లను Make లేదా Zapierకి ఎలా కనెక్ట్ చేయాలి?

స్వీకరించే వెబ్‌హూక్‌ను Makeలో లేదా Catch Hookలో Zapierని సృష్టించండి, ఉత్పత్తి చేయబడిన URLని కాపీ చేసి, ఆపై దానిని 7stamp ప్రొఫైల్ యొక్క వెబ్‌హుక్ సెట్టింగ్‌లలో అతికించి, పరీక్ష ఈవెంట్‌ను పంపండి.

నేను ఈవెంట్‌ని నా CRM పరిచయానికి ఎలా సరిపోల్చాలి?

External IDని మరియు ఉన్నప్పుడు, External Sourceని ఉపయోగించండి. కార్డ్‌ని సృష్టించినప్పుడు లేదా స్కాన్ చేసినప్పుడు ఇవి మీ ఇంటిగ్రేషన్ అందించిన ఐడెంటిఫైయర్‌లు.

నేను సంతకం హెడర్‌ని ఊహించాలా లేదా టైమింగ్‌ని మళ్లీ ప్రయత్నించాలా?

నం. ప్రస్తుత OpenAPI/profile డెలివరీ ఒప్పందాన్ని ఉపయోగించండి మరియు హెడర్‌ను హార్డ్-కోడింగ్ చేసే ముందు లేదా ఊహను మళ్లీ ప్రయత్నించే ముందు ఆన్‌బోర్డింగ్ సమయంలో మీ ప్రొఫైల్ కోసం ప్రమాణీకరణ విధానాన్ని నిర్ధారించండి.

తదుపరి దశ

Ready to send the first card event?

రిసీవర్‌ని సృష్టించండి, దాని HTTPS URLని ప్రొఫైల్‌లో అతికించండి, డిస్పోజబుల్ స్కాన్‌ను అమలు చేయండి మరియు డౌన్‌స్ట్రీమ్ ఆటోమేషన్‌ను ప్రారంభించే ముందు సరిపోలే External IDని ధృవీకరించండి.