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 માં કાર્ય બનાવો”.

---