API & Integrations

14. API & Integrations

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లో టాస్క్ సృష్టించండి”.

---