API & ஒருங்கிணைப்புகள்

14. API & ஒருங்கிணைப்புகள்

API & Integrations பிரிவில் 7Stamp-ஐ உங்கள் வெளிப்புற அமைப்புகளுடன் — CRM, POS, ERP, பகுப்பாய்வு, மெசஞ்சர் பாட்கள் — நிரல் மூலம் ஒருங்கிணைப்பதற்கான கருவிகள் உள்ளன.

API Keys

இந்தப் பிரிவின் முதன்மைப் பக்கம் API சாவிகளின் பட்டியல். நெடுவரிசைகள்:

• Name — சாவியின் பெயர் (பொதுவாக இணைக்கப்பட்ட பணியாளரின் பெயருடன் பொருந்தும்).
• Login — சாவி இணைக்கப்பட்டுள்ள பணியாளர் உள்நுழைவு.
• API Key — சாவி (7loc_sc_... என்று தொடங்கும், இயல்பாக மறைக்கப்பட்டிருக்கும், ஒரே கிளிக்கில் நகலெடுக்கலாம்).
• Status — Active.
• 🔄 — சாவியை மீண்டும் உருவாக்க.
• 🗑️ — சாவியை நீக்க.

API சாவியை உருவாக்குதல்

+ ADD API KEY-ஐத் தட்டுங்கள் — Generate API Key பாப்அப் திறக்கும்:

• Scanner — சாவி இணைக்கப்படும் பணியாளர் உள்நுழைவைத் தேர்ந்தெடுக்கும் கீழிறங்கு பட்டியல் (ஒரு பணியாளருக்கு ஒரு சாவி மட்டும்).
• CANCEL / GENERATE பொத்தான்கள்.

GENERATE-க்குப் பிறகு சாவி உருவாக்கப்பட்டுப் பட்டியலில் தோன்றும். அதை உடனே நகலெடுங்கள் — முழுச் சாவி மீண்டும் காட்டப்படாமல் போகலாம்.

API மூலம் என்ன செய்யலாம்

• மின்னஞ்சல்/தொலைபேசி மூலம் வாடிக்கையாளருக்கு கார்டு வழங்குதல்.
• குறிப்பிட்ட வாடிக்கையாளருக்கு ஸ்டாம்ப் சேர்த்தல்.
• வவுச்சர் வழங்குதல் (டெம்ப்ளேட் அல்லது தனிப்பயன், Redeem Code உடன்).
• வவுச்சரைப் பயன்படுத்துதல் (உங்கள் சொந்த POS மூலம் செயல்பட்டால்).
• கார்டின் நிலை, முன்னேற்றம், வரலாற்றைப் படித்தல்.
• நிகழ்வுகளை நிகழ்நேரத்தில் பெற Webhooks-க்குச் சந்தா செலுத்துதல்.

Webhooks

Webhooks கார்டு நிகழ்வுகளை வெளிப்புற அமைப்புக்கு அனுப்புகின்றன. ஆதரிக்கப்படும் நிகழ்வுகள் (நிகழ்வுச் சொற்களஞ்சியத்தைப் பாருங்கள்):

• SCAN, DELIVERY_INSERT.
• REWARD_EARNED, LOTTERY_WIN.
• VOUCHER_ISSUED, ADMIN_VOUCHER_ISSUE, VOUCHER_REDEEMED.
• CARD_JOINED, CARD_ADDED_TO_WALLET, CARD_REMOVED_FROM_WALLET.
• CARD_CAMPAIGN, BIRTHDAY_GREETING.

Webhook payload எடுத்துக்காட்டு

{
  "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
    }
  }
}

தயாரான POS ஒருங்கிணைப்புகள்

• Poster — தயாரான ஒருங்கிணைப்பு, சில கிளிக்குகளில் இணைகிறது.
• Serve — தயாரான ஒருங்கிணைப்பு.
• பிற பில்லிங் அமைப்புகள் — கோரிக்கையின் பேரில் உருவாக்கப்படும். தொழில்நுட்ப ரீதியாகச் சாத்தியமானால் இலவசம் (அதாவது உங்கள் அமைப்பு திறந்த API அல்லது Webhooks வழங்கினால்).

7loc.com வழியாக மெசஞ்சர் ஒளிபரப்புகள்

WhatsApp, Telegram, Viber ஒளிபரப்புகளுக்கு 7loc.com ஒருங்கிணைப்பு இணைக்கப்படுகிறது. அது செயல்பாட்டுக்கு வந்ததும், Campaigns-இல் PUSH மற்றும் Email-க்கு அருகில் “மெசஞ்சர்கள்” சேனல் கிடைக்கும்.

நிரலாக்கம் இல்லாத சூழ்நிலைகள்: Zapier மற்றும் Make

7Stamp API + Webhooks Zapier மற்றும் Make (Integromat) உடன் வேலை செய்கின்றன; நிரல் எழுதாமலேயே சூழ்நிலைகளை உருவாக்கலாம்:

• “VOUCHER_REDEEMED நிகழ்ந்தால் — Mailchimp-இல் ஒரு டேக் சேர்க்கவும்”.
• “REWARD_EARNED நிகழ்ந்தால் — Slack-க்கு அறிவிப்பு அனுப்பவும்”.
• “BIRTHDAY_GREETING நிகழ்ந்தால் — CRM-இல் ஒரு பணியை உருவாக்கவும்”.

---