API & Integrations

14. API & Integrations

يحتوي قسم API & Integrations على أدوات لربط 7stamp برمجيًا مع أنظمتك الخارجية مثل CRM و POS و ERP وأدوات التحليلات وروبوتات المراسلة.

API Keys

الصفحة الرئيسية في هذا القسم هي قائمة مفاتيح API. الأعمدة هي:

• Name — اسم المفتاح (وغالبًا يطابق اسم Staff المرتبط به).
• Login — حساب Staff Login المرتبط بالمفتاح.
• API Key — المفتاح نفسه (يبدأ بـ 7loc_sc_...، ومخفي افتراضيًا، ويمكن نسخه بنقرة واحدة).
• Status — Active.
• 🔄 — إعادة إنشاء المفتاح.
• 🗑️ — حذف المفتاح.

إنشاء مفتاح API

اضغط + ADD API KEY — وستفتح نافذة Generate API Key:

• Scanner — قائمة منسدلة لاختيار Staff Login الذي سيرتبط به المفتاح (يمكن لكل Staff أن يملك مفتاحًا واحدًا).
• Buttons CANCEL / GENERATE.

بعد الضغط على GENERATE يتم إنشاء المفتاح ويظهر في القائمة. انسخه فورًا، لأن المفتاح الكامل قد لا يُعرض لك مرة أخرى.

ما الذي يمكنك تنفيذه عبر API

• إصدار Card لعميل عبر البريد الإلكتروني أو الهاتف.
• إضافة Stamp لعميل محدد.
• إصدار Voucher (قالب جاهز أو مخصص، مع Redeem Code).
• Redeem a Voucher (إذا كنت تعمل عبر POS الخاص بك).
• قراءة حالة البطاقة والتقدم والسجل.
• الاشتراك في Webhooks لتلقي الأحداث في الوقت الحقيقي.

Webhooks

ترسل Webhooks أحداث البطاقة إلى نظام خارجي. والأحداث المدعومة هي (راجع event glossary):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (مع النتيجة).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Webhook payload example

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Ready-made POS integrations

• Poster — تكامل جاهز، ويمكن ربطه خلال بضع نقرات.
• Serve — تكامل جاهز.
• Other tills — تُنفّذ عند الطلب. وهي مجانية إذا كانت ممكنة تقنيًا (أي إذا كان نظام الكاشير لديك يوفّر API مفتوحًا أو Webhooks).

Messenger broadcasts via 7loc.com

لبث الرسائل عبر WhatsApp و Telegram و Viber، يتم استخدام تكامل 7loc.com. وبعد تفعيله، تظهر قناة “messengers” داخل Campaigns إلى جانب PUSH و Email.

سيناريوهات بلا كود: Zapier وMake

تعمل 7stamp API + Webhooks مع Zapier و Make (Integromat)، ما يتيح لك بناء workflows من دون كتابة كود:

• “When voucher_redeemed — add a tag in Mailchimp”.
• “When goal_reached — send a notification to Slack”.
• “When birthday_reached — create a task in CRM”.

---