டெவலப்பர் ஒருங்கிணைப்பு
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
}
}
}உங்கள் பின்தளத்தில் HTTPS இறுதிப்புள்ளியை உருவாக்கவும், CRM ஒருங்கிணைப்பு அடுக்கு, Make வெப்ஹூக் அல்லது Zapier Catch Hook. 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 ஐ சரிபார்க்கவும்.