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 পেলোডের উদাহরণ

{
  "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-এ একটি টাস্ক তৈরি করুন”।

---