14. API و ادغام
[اسکرین شات: 0601_Apikey.png]
بخش API و یکپارچهسازی حاوی ابزارهایی برای ادغام برنامهای 7stamp با سیستمهای خارجی شما - CRM، POS، ERP، تجزیه و تحلیل، رباتهای پیامرسان است.
API Keys
صفحه اصلی بخش، لیست کلید API است. ستون ها:
- نام - نام کلید (معمولاً با نام کارکنان مرتبط مطابقت دارد).
- **ورود ** - کلید ورود به سیستم کارکنان به آن گره خورده است.
- API کلید — خود کلید (با «7loc_sc_…» شروع میشود، بهطور پیشفرض پنهان است، با یک کلیک قابل کپی است).
- وضعیت — “فعال”.
- 🔄 — کلید را دوباره تولید کنید.
- 🗑️ — کلید را حذف کنید.
ایجاد یک کلید API
[اسکرین شات: 0602_Apikey.png]
روی + ADD API KEY ضربه بزنید — پنجره Generate API Key باز می شود:
- اسکنر - کشویی برای انتخاب Staff Login که کلید به آن محدود می شود (یک کارمند می تواند یک کلید داشته باشد).
- دکمه ها لغو / تولید.
بعد از GENERATE کلید ایجاد می شود و در لیست ظاهر می شود. فوراً آن را کپی کنید - ممکن است کلید کامل دوباره نشان داده نشود.
کارهایی که می توانید از طریق API انجام دهید
- صدور کارت برای مشتری از طریق ایمیل/تلفن.
- به یک مشتری خاص یک stamp اضافه کنید.
- یک کوپن صادر کنید (الگوی یا سفارشی، با Redeem Code).
- یک کوپن را بازخرید کنید (اگر از طریق POS خودتان کار می کنید).
- ** وضعیت کارت، پیشرفت، تاریخچه را بخوانید.
- برای دریافت رویدادها در زمان واقعی در Webhooks مشترک شوید.
وب هوک ها
وب هوک ها رویدادهای کارت را به یک سیستم خارجی ارسال می کنند. پشتیبانی شده (به واژه نامه رویداد مراجعه کنید):
- “کارت_صادر شده”، “کارت_ذخیره_شده”، “کارت_بازشده”.
- «stamp_added».
- “هدف_رسید”، “پاداش_صدور”.
- «کوپن_صدور»، «کوپن_بازخرید شده»، «کوپن_منقضی شده».
- “لاتاری_بازی شده” (با نتیجه).
- “تولد_رسید”.
- «محرک_عدم فعالیت».
- “کمپین_ارسال شده”.
نمونه بارگذاری وب هوک
“json { “رویداد”: “voucher_redeemed”، “timestamp”: “2026-05-11T12:34:56Z”، “business_id”: “b_123”، “location_id”: “loc_45”، “مشتری”: { “id”: “c_789”، “wallet_pass_id”: “wp_abc”، “زبان”: “en” }, “card”: { “id”: “card_001”, “goal_index”: 2 }, “کوپن”: { “id”: “v_555”، “نوع”: “کوپن”، “redeem_code”: “FREECOFFEE”, “redeem_code_formats”: [“متن”، “qr”، “بارکد”]، “وضعیت”: “بازخرید شده”، “redeemed_via”: “staff_scanner” } }
### ادغام های آماده POS
- **Poster** - یکپارچه سازی آماده، با چند کلیک متصل می شود.
- ** خدمت ** - یکپارچه سازی آماده.
- **سایر تالارها** — در صورت درخواست ساخته شده است. **رایگان اگر از نظر فنی امکان پذیر باشد** (به عنوان مثال، شما یک API باز یا Webhooks را نشان می دهد).
### پیام رسان از طریق 7loc.com پخش می شود
برای پخش WhatsApp، Telegram، Viber، ادغام **7loc.com** متصل است. پس از فعال شدن، کانال «پیامرسان» در کمپینهای کنار PUSH و Email در دسترس قرار میگیرد.
### سناریوهای بدون کد: Zapier و Make
7stamp API \+ Webhooks با **Zapier** و **Make (Integromat)** کار می کند و به شما امکان می دهد سناریوها را بدون کدنویسی بسازید:
- "وقتی "کوپن_بازخرید شد" - یک برچسب در Mailchimp اضافه کنید.
- "وقتی به "هدف_رسید" — یک اعلان به Slack ارسال کنید.
- "When 'birthday_reached" — یک کار در CRM ایجاد کنید.
---راهنمای بصری
از مجموعه صفحههای زیر به عنوان همراه بصری مقاله استفاده کنید. هر تصویر را باز کنید تا در اندازه کامل بررسی کنید.