API والتكاملات

الإعدادات → API والتكاملات تحتوي على ثلاث علامات تبويب: مفاتيح API، و Webhooks، والتكاملات.
مفاتيح API و API مجانية في كل خطة، بما في ذلك Free Forever؛ لا يوجد إضافة API. الأختام الممنوحة عبر API هي Card Operations مثل أي ختم آخر، لذا تتوقف عند نفاد Card Operations في الخطة. الويب هوكس هي الجزء المدفوع، انظر أدناه.
هل تكلفة API إضافية؟
لا. مفاتيح API و API مجانية في كل خطة، بما في ذلك Free Forever. الأختام الممنوحة من خلالها هي Card Operations مثل أي أخرى.
هل يمكنني استخدام API على Free Forever؟
نعم. عندما تنفد خطة Card Operations، تتوقف الأختام عبر API مثل أي شيء آخر.
أين إعدادات API؟
في الإعدادات → API والتكاملات، مع ثلاث علامات تبويب — مفاتيح API، الويب هوكس والتكاملات.
مفاتيح API

يتم إنشاء مفتاح API تحت مفاتيح API → أضف مفتاح API لتسجيل دخول موظف واحد. يمكن لتسجيل دخول الموظف أن يحتوي على مفتاح API واحد على الأكثر، ولا يمكن اختيار تسجيل دخول موظف متوقف. عند عدم وجود تسجيل دخول موظف للاختيار، تعرض نافذة إنشاء مفتاح API إنشاء واحد مباشرة؛ يحتاج تسجيل دخول موظف جديد إلى Staff Seat مجاني، وعند وجود خطة ممتلئة تعرض النافذة إضافة مقعد أو اختيار خطة بدلاً من ذلك.
كل مكالمة تتم باستخدام مفتاح API تعمل كأنها تسجيل دخول للموظف: تصل فقط إلى أعمال تسجيل دخول الموظف هذا، وتطبع البطاقة المختارة للختم تحت الختم التلقائي، وتُحسب أختامها كأنها Card Operations الخاصة بتسجيل دخول هذا الموظف.
يمكن عرض المفتاح ونسخه مرة أخرى في أي وقت من قائمة مفاتيح API. يمكن أيضًا عرضه كرمز QR، لمسحه ضوئيًا في محطة عمل، وطباعته باسم تسجيل دخول الموظف.
كيف أقوم بإنشاء مفتاح API؟
في الإعدادات → مفاتيح API والتكاملات → API، اختر إضافة مفتاح API وحدد تسجيل دخول الموظف. كل تسجيل دخول موظف لديه في الغالب مفتاح API واحد على الأكثر.
لقد فقدت مفتاحي API. هل أحتاج إلى مفتاح جديد؟
لا. يمكن عرض المفتاح ونسخه مرة أخرى في أي وقت من قائمة مفاتيح API، أو عرضه كرمز QR.
أي بطاقة أختام يطلق API عليها ختم؟
الشخص المختار لتسجيل دخول الموظف للمفتاح تحت الختم التلقائي. تُحتسب أختامها كـ Card Operations لتسجيل دخول ذلك الموظف.
لماذا لا أستطيع اختيار تسجيل دخول الموظف لمفتاح جديد؟
لا يمكن اختيار تسجيل دخول الموظف الذي تم إيقافه، ولا يمكن لتسجيل دخول الموظف الذي يمتلك مفتاحًا بالفعل الحصول على مفتاح ثانٍ. وعند عدم وجود أي خيار للاختيار، يعرض النافذة إنشاء تسجيل دخول للموظف.
عندما يتوقف مفتاح API عن العمل
مفتاح API لا تنتهي صلاحيته. يتوقف عن العمل فقط عندما يتم إعادة توليده أو حذفه، أو عندما يتم إيقاف تشغيل تسجيل دخول الموظف أو حذفه. كلمة المرور الجديدة أو تسجيل الدخول الجديد لتسجيل دخول الموظف لا يؤثر عليه.
- يعطي Regenerate تسجيل دخول الموظف مفتاح API جديد؛ يتوقف القديم عن العمل فورًا.
- يحذف يوقف المفتاح على الفور. تسجيل دخول الموظفين نفسه يستمر بالعمل في 7Stamp Scanner ويمكنه الحصول على مفتاح جديد لاحقًا.
- إيقاف تسجيل دخول الموظف يحتفظ بمفتاحه: عندما يتم إعادة تشغيل تسجيل دخول الموظف، يعمل نفس المفتاح مرة أخرى.
هل تنتهي صلاحية مفتاح API؟
لا. يتوقف عن العمل فقط عندما يُعاد إنشاؤه أو حذفه، أو عندما يتم إيقاف تشغيل تسجيل دخول الموظف الخاص به أو حذفه.
لقد غيّرت كلمة مرور تسجيل دخول الموظفين. هل أحتاج إلى مفتاح API جديد؟
لا. كلمة المرور أو تسجيل الدخول الجديدة لا تؤثر على مفتاح API.
لقد قمت بإعادة تشغيل تسجيل دخول الموظف. هل يعمل مفتاحه القديم API؟
نعم. إيقاف تسجيل الدخول للموظف يحافظ على مفتاحه، والمفتاح نفسه يعمل مرة أخرى بمجرد إعادة تفعيله.
ماذا يفعل API
من خلال API يمكن للنظام:
- سلم بطاقة ختم كرابط أو QR;
- أضف الأختام;
- اقرأ بطاقة بأختامها وأهدافها وقسائمها؛
- إصدار قسيمة مباشرة إلى بطاقة
- استرداد قسيمة باستخدام رمز القسيمة الخاص بها؛
- إرسال رسالة إلى عميل.
يجد API بطاقة العميل عن طريق معرف العمل الخاص به، مثل معرف CRM أو الهاتف أو البريد الإلكتروني المرسل كـ external_id. يتم تخزين المعرف على البطاقة ويعود في كل Webhook عنها. لا يحتوي API على أي استدعاء يسرد عملاء العمل: يتم استخراج قاعدة العملاء بالكامل فقط من خلال تصدير المسؤول.
بدلاً من مفتاح API، يمكن للتطبيق تسجيل الدخول باستخدام تسجيل دخول و كلمة مرور موظف — لجهاز يقوم الصراف بتسجيل الدخول عليه. مفتاح API مناسب لجهاز يعمل بدون مراقبة. يتم إضافة Webhooks فقط في الإدارة؛ مفتاح API ليس لديه أي استدعاء للاشتراك في الأحداث أو لقائمتها.
لا يحدد API أي حد لمعدل الطلبات: لا يتم تقييد المكالمات بالعدد أو التكرار، ويمكن مسح البطاقة نفسها مرة أخرى على الفور. ما يحد من الأختام من خلالها هو Card Operations الخاص بالخطة.
هل يمكننا إضافة أختام من CRM أو POS الخاص بنا؟
نعم، من خلال API. يقوم بتوزيع بطاقات الأختام، إضافة الأختام، قراءة البطاقات واسترداد القسائم. لجعل نظامك يعرف عن الأحداث، أضف Webhook — هذا يتطلب إضافة Webhooks & Events.
هل يمكننا تصدير البيانات؟
من خلال API يمكنك قراءة البطاقات بواسطة معرفك الخاص، وتقوم Webhooks بإرسال الأحداث فور حدوثها. لا يحتوي API على قائمة بجميع العملاء — يتم استخراج قاعدة العملاء بأكملها من خلال تصدير المسؤول.
كيف يجد API بطاقة العميل؟
بمعرفك الخاص — وهو معرف CRM، أو الهاتف، أو البريد الإلكتروني — المرسل كـ external_id. يتم تخزينه على البطاقة ويعود في كل Webhook يتعلق بها.
هل يمكنني الاشتراك في Webhooks من خلال API؟
لا. يتم إضافة الويب هوكس فقط في لوحة الإدارة.
هل لدى API حد للسرعة؟
لا. المكالمات لا تُحد بالعدد أو التكرار، ويمكن مسح نفس البطاقة مرة أخرى على الفور. التوقيع محدود فقط بخطة Card Operations.
مرجع API
المرجع API عام ولا يحتاج إلى تسجيل دخول: Swagger في https://api.7loc.com/cards-api/docs, مع ملف OpenAPI في https://api.7loc.com/cards-api/openapi.json. المكالمات تذهب إلى https://api.7loc.com/cards-api وتحتاج إلى مفتاح API أو تسجيل دخول للموظف.
لا ترى شركة White Label أي رابط إلى المرجع API في القسم الإداري. تعمل مفاتيح API و Webhooks بنفس الطريقة.
أين هي وثائق API؟
Swagger في https://api.7loc.com/cards-api/docs, عام، دون الحاجة لتسجيل الدخول. ملف OpenAPI موجود في https://api.7loc.com/cards-api/openapi.json.
ما هو العنوان الأساسي لاستدعاءات API؟
تحتاج المكالمات https://api.7loc.com/cards-api. إلى مفتاح API أو تسجيل دخول للموظفين.
مسؤولنا White Label لا يملك رابط مستندات API. هل يعمل API معنا؟
نعم. لا ترى شركة White Label أي صلة بالمرجع، لكن مفاتيح API و Webhooks الخاصة بها تعمل بنفس الطريقة.
ويب هوكس

يتم إضافة Webhook تحت API و integrations → Webhooks → Add webhook، مع URL الذي يستقبل الأحداث. في 7Stamp يتم إنشاء Webhook لأحداث بطاقة الأختام. يمكن للأعمال إضافة عدة Webhooks، كل منها مع URL الخاص بها.
تحتاج Webhooks إلى إضافة Webhooks & Events، $19 في الشهر، متاحة فقط في الخطط المدفوعة. يوفر إضافة أول Webhook فرصة لشرائها؛ بدونها لا يمكن إنشاء Webhook أو إعادة تشغيله. كل إضافة تُبقي Webhook واحدًا مفعلًا: يمكن إضافة المزيد، ولكن كل تحديث للفوترة في الاشتراك يقوم بإيقاف جميع Webhooks باستثناء الأقدم.
ترسل الـ Webhooks الأحداث في الوقت الذي تحدث فيه من لحظة إضافة الـ Webhook. الأحداث السابقة لا تُرسل.
هل الويب هوكس مجانية؟
لا. هم بحاجة إلى الملحق Webhooks & Events، $19 في الشهر، والمتاح فقط في الخطط المدفوعة. أما API فهو مجاني.
لقد أضفت Webhook ثانية وكانت مغلقة. لماذا؟
إضافة واحدة من Webhooks & Events تُبقي Webhook واحدة مفعلة. كل تحديث للفوترة في الاشتراك يقوم بإيقاف تشغيل كل الإضافات باستثناء الأقدم.
هل سيرسل Webhook جديد الأحداث السابقة؟
لا. يتم إرسال الأحداث منذ اللحظة التي يتم فيها إضافة الـ Webhook.
أحداث الويب هوك
يحصل Webhook على خمسة عشر حدث بطاقة ختم، مسماة في event_type: SCAN، DELIVERY_INSERT، RECEIPT_SCAN، CARD_JOINED، REWARD_EARNED، VOUCHER_ISSUED، VOUCHER_PACK، ADMIN_VOUCHER_ISSUE، VOUCHER_REDEEMED، LOTTERY_WIN، CARD_CAMPAIGN، BIRTHDAY_GREETING، AUTO_MESSAGE_VOUCHER، CARD_ADDED_TO_WALLET و CARD_REMOVED_FROM_WALLET. يأتي آخر اثنين عند إضافة التمريرة إلى المحفظة أو إزالتها منها، مع المحفظة، Apple أو Google.
المسح الذي لا يضيف أي ختم، مثل الشراء أقل من سعر الختم، لا يزال يرسل SCAN مع صفر أختام مضافة. يتم الإعلان عن الجائزة المربوحة في عجلة بواسطة LOTTERY_WIN عند دوران العجلة، وليس بواسطة REWARD_EARNED أو VOUCHER_ISSUED؛ العجلة التي تنتظر الدوران لا ترسل شيئًا بعد.
مراجعات العملاء ليست أحداث بطاقة الأختام. كل مراجعة جديدة ترسل حدثًا بالكيان review والإجراء created إلى الويب هوكس التي تم اختيار المراجعات ضمن كائناتها في صفحة الويب هوك. يتم إعداد أي ويب هوك يُضاف هنا لأحداث بطاقة الأختام فقط، لذلك يحصل على المراجعات بمجرد اختيار المراجعات.
هل يتم إرسال Webhook عندما لا يضيف الفحص أي ختم؟
نعم. الفحص الذي لا يضيف أي ختم، مثل عملية شراء أقل من سعر الختم، لا يزال يرسل SCAN مع إضافة صفر ختم.
ما الحدث الذي يخبرني بأن العميل فاز على العجلة؟
LOTTERY_WIN، يُرسل مرة واحدة عند دوران العجلة. العجلة التي تنتظر الدوران لا ترسل شيئًا بعد.
هل يمكنني معرفة متى يزيل العميل البطاقة من محفظته؟
نعم. إضافة البطاقة إلى المحفظة وإزالتها ترسل CARD_ADDED_TO_WALLET و CARD_REMOVED_FROM_WALLET، مع المحفظة، آبل أو جوجل.
كيف أحصل على تقييمات العملاء الجديدة من خلال Webhook؟
افتح صفحة الـ Webhook واختر المراجعات من بين كائناته. كل مراجعة جديدة تصل بعد ذلك مع كائن المراجعة والإجراء المنشأ؛ يضيف Webhook تحت API والتكاملات أحداث بطاقة الأختام فقط حتى ذلك الحين.
عندما يتم إرسال كل حدث
| حدث | أرسل عند |
|---|---|
SCAN | يقوم تسجيل دخول الموظف بمسح البطاقة: في 7Stamp Scanner، من خلال API أو من POS مثل Toast. الأختام التي تمت إزالتها في 7Stamp Scanner هي SCAN مع stamps_added سلبي |
DELIVERY_INSERT | يفتح العميل رمز ختم يعطي الأختام — QR، رابط، الرمز نفسه أو دعوة تم إنشاؤها عبر API |
RECEIPT_SCAN | يقوم العميل بمسح إيصال ضريبي في روبوت الدردشة الخاص بالشركة ويتم ختمه؛ amount هو مجموع الإيصال |
CARD_JOINED | يحصل العميل على بطاقة أختام جديدة، بأي طريقة، باستخدام external_id الذي مررت به |
REWARD_EARNED | يصل المسح إلى هدف Award |
VOUCHER_ISSUED | يصل المسح إلى هدف القسيمة |
LOTTERY_WIN | يتم تدوير عجلة Lottery وتمنح جائزة |
VOUCHER_PACK | تحصل بطاقة جديدة على حزمة قسائم بطاقة الأختام، جميع قسائمها في حدث واحد |
ADMIN_VOUCHER_ISSUE | يتم إصدار القسيمة مباشرة إلى بطاقة، في الإدارة أو من خلال API |
VOUCHER_REDEEMED | يتم استرداد القسيمة على بطاقة: في 7Stamp Scanner، من خلال API، في Toast POS أو بواسطة العميل |
CARD_CAMPAIGN | تصل الحملة إلى البطاقة، مرة واحدة لكل بطاقة، باستخدام قسيمة الحملة إذا كانت موجودة |
BIRTHDAY_GREETING | تذهب تحية عيد الميلاد إلى البطاقة، مع قسيمة عيد الميلاد إذا تم إصدار واحدة |
AUTO_MESSAGE_VOUCHER | يقوم مشغل الرسائل التلقائية بوضع قسيمة على البطاقة، سواء وصل القناة إلى العميل أم لا |
CARD_ADDED_TO_WALLET | يتم إضافة المرور إلى Apple Wallet أو Google Wallet |
CARD_REMOVED_FROM_WALLET | يتم إزالة البطاقة من المحفظة |
كل هدف يصل إليه المسح يرسل حدثه الخاص بعد حدث المسح، والهدف الذي يتم الوصول إليه مرتين بواسطة مسح واحد، على جولتين من البطاقة، يرسل حدثين. بطاقة كاملة تبدأ جولة جديدة هي نفس البطاقة ولا ترسل CARD_JOINED؛ البطاقة التي تصدر مرة أخرى بعد أن حذف المسؤول القديمة تفعل ذلك. عندما يجلب الانضمام حزمة قسائم وختمات، يأتي CARD_JOINED أولاً، ثم VOUCHER_PACK، ثم DELIVERY_INSERT.
رمز الختم الذي لا يحتوي على أختام لا يرسل أي DELIVERY_INSERT، والقسيمة التي تم إنشاؤها في الإدارة بدون بطاقة لا ترسل أي ADMIN_VOUCHER_ISSUE، والاستدعاء المتكرر لـ API لقسيمة تم استردادها بالفعل لا يرسل أي VOUCHER_REDEEMED ثانية.
أي حدث يخبرني أن العميل وصل إلى هدف؟
REWARD_EARNED لهدف Award، وVOUCHER_ISSUED لهدف القسيمة، وLOTTERY_WIN لهدف Lottery، كل ذلك يتم إرساله بعد حدث المسح الخاص به.
هل يتم إرسال Webhook عند إزالة الأختام؟
نعم. الأختام التي تم إزالتها في 7Stamp Scanner تصل كـ SCAN مع stamps_added سالبة.
ما الفرق بين VOUCHER_ISSUED و ADMIN_VOUCHER_ISSUE؟
يصدر VOUCHER_ISSUED عندما يصل الفحص إلى هدف القسيمة. يأتي ADMIN_VOUCHER_ISSUE عندما يتم إصدار قسيمة مباشرة لبطاقة، يدويًا في الإدارة أو من خلال API.
هل العميل الذي ينضم باستخدام رمز الختم يرسل حدثًا واحدًا أم عدة أحداث؟
عدة. CARD_JOINED يأتي أولاً، ثم VOUCHER_PACK إذا كانت بطاقة الأختام تحتوي على حزمة قسائم، ثم DELIVERY_INSERT مع الأختام.
هل أحصل على حدث لكل رسالة حملة؟
يُرسل CARD_CAMPAIGN مرة واحدة لكل بطاقة تصل إليها الحملة، مع قسيمة الحملة عندما تكون موجودة.
ما يستقبله الويب هوك
كل حدث له نفس الجسم JSON: معرف الحدث، العمل، والحدث مع نوعه، بطاقة الأختام، الأختام قبل وبعد، مبلغ الشراء، معرف الطلب و external_id الإرسال المدمج، تسجيل دخول الموظف الذي خدمه، القسائم والمكافآت التي قدمها، واسم العميل، البريد الإلكتروني، Telegram، WhatsApp الهاتف وتاريخ الميلاد.
amount هو مبلغ الشراء بالوحدات الفرعية (السنتات): المبلغ 12.50 المرسل مع المسح يصل كـ 1250. يكون فارغًا عندما لا يكون للحدث أي مبلغ.
معرّف الحدث موجود في الجسم وأيضًا في رأس X-Webhook-Event-Id. إعادة محاولة نفس الحدث تحتفظ بمعرّفها، لذا يمكن للمستقبل تجاهل التكرارات. بالنسبة لـ Make أو Zapier URL، يقع الحدث تحت مفتاح card_event بدلاً من data.
ما البيانات التي يحملها الويب هوك عن العميل؟
الاسم، البريد الإلكتروني، Telegram، WhatsApp الهاتف وتاريخ الميلاد، مع بطاقة الأختام، الأختام قبل وبعد، والقسائم والمكافآت المعطاة.
ما هي وحدة الكمية؟
بوحدات فرعية (سنت). مبلغ 12.50 المُرسل مع المسح يصل كـ 1250؛ يكون فارغًا عندما لا يكون هناك مبلغ في الحدث.
كيف أتجنب معالجة نفس الحدث مرتين؟
استخدم معرف الحدث في الجسم وفي رأس X-Webhook-Event-Id. إعادة المحاولة تحتفظ بنفس المعرف.
لماذا الحدث تحت card_event في Make؟
بالنسبة لـ Make أو Zapier URL، يقع الحدث تحت مفتاح card_event بدلاً من data، لذا يمكن لتطبيقاتهم تمييزه.
توقيع
يتم توقيع كل تسليم. رأس X-Webhook-Signature يحتوي على ختم زمني وHMAC-SHA256 لذلك الختم الزمني والجسم الخام، باستخدام مفتاح سر Webhook. يتم عرض المفتاح السري وتوليده مرة أخرى على صفحة Webhook. يمكن أيضًا إضافة تسجيل دخول ومفتاح مرور أساسي.
كيف يمكنني التحقق من أن الويب هوك يأتي حقًا من 7Stamp؟
احسب HMAC-SHA256 للختم الزمني والجسم الخام باستخدام مفتاح السر الخاص بواجهة الويب وقارنه مع ترويسة X-Webhook-Signature.
أين أجد المفتاح السري للويب هوك؟
في صفحة الويب هوك، حيث يمكن أيضًا إعادة توليده.
هل يمكنني حماية نقطة النهاية بكلمة مرور؟
نعم. يمكن إضافة تسجيل دخول وكلمة مرور أساسية إلى الـ Webhook، بالإضافة إلى التوقيع.
التسليمات الفاشلة
يتم إعادة محاولة التسليم الذي لا يحصل على إجابة 2xx خلال ثلاثين ثانية حتى عشر مرات، مع زيادة كل فترة انتظار بأربع ثوانٍ عن السابقة، بحيث تنتهي محاولات الإعادة خلال حوالي أربع دقائق. يتم إعادة محاولة الإجابة 429 مع Retry-After بعد ذلك الوقت. أول فشل لحدث يضع إشعارًا في لوحة الإدارة.
بعد مئة عملية توصيل فاشلة على التوالي، يتم حظر الـ Webhook بواسطة النظام ولا يحصل على المزيد من الأحداث. الصفحة الخاصة به تحذر قبل ذلك وتحتوي على زر لإلغاء الحظر؛ توصيل واحد ناجح يعيد تعيين العد.
كل صفحة Webhook تحتوي على سجل لتسليماتها، مع الطلب المرسل والرد المستلم. إعادة الإرسال ترسل نفس الحدث مرة أخرى، إلى هذا Webhook فقط.
كان خادمي متوقفًا. هل فقدت الأحداث؟
يتم إعادة محاولة كل عملية تسليم ما يصل إلى عشر مرات خلال حوالي أربع دقائق. بعد ذلك، افتح سجل الـ Webhook واستخدم إعادة الإرسال للأحداث التي تحتاجها.
لماذا توقف Webhook الخاص بي عن استقبال الأحداث؟
بعد مئة محاولة تسليم فاشلة متتالية، يتم حظره بواسطة النظام. قم بإصلاح نقطة النهاية واضغط على إلغاء الحظر في صفحة Webhook.
هل يمكنني رؤية ما تم إرساله إلى Webhook الخاص بي؟
نعم. تحتوي صفحة كل Webhook على سجل للتسليمات مع الطلب المرسل والإجابة المستلمة.
علامة تبويب التكاملات

تبويب التكاملات يسرد الطرق الجاهزة حسب المجموعة:
- الختم عند نقطة الدفع — Poster أو Toast أو POS الخاص بك أو CRM، و«ألا ترى POS الخاص بك؟»؛
- الإيصالات المالية — SmartKasa;
- الأتمتة — Make، Zapier والعامة Swagger.
كل بطاقة تشير إلى ما إذا كانت تحتاج إلى مفتاح API. توفر التبويبة نفس البطاقات في كل بلد؛ فقط الإيصالات المالية محدودة حسب البلد.

لا ترى شركة White Label أي بطاقة Make أو Zapier أو عامة Swagger، ولا يُعرض عليها Poster أو أدلة الإعداد على 7stamp.com.
أي أنظمة POS جاهزة للاتصال؟
Poster، و Toast بمجرد تشغيله للمنصة — حتى ذلك الحين يظهر قادم قريباً. الأنظمة الأخرى تتصل من خلال API، مع POS أو CRM الخاص بك.
هل التكاملات محدودة حسب البلد؟
لا. البطاقة تقدم نفس البطاقات في كل دولة. الإيصالات المالية فقط هي المحدودة حسب الدولة.
لماذا لا أرى Make و Zapier؟
لا يتم عرضها على عمل White Label. مفاتيح API و Webhooks تعمل بنفس الطريقة.
Poster
Poster هو تطبيقنا في سوق Poster. التثبيت في Poster يفتح قائمته، ويتم إعداد التطبيق بمفتاح API لتسجيل دخول الموظف. وتُحتسب الأختام الخاصة به كـ Card Operations لتسجيل دخول ذلك الموظف.
كيف أقوم بتوصيل Poster؟
افتح التكاملات → Poster واختر التثبيت في Poster. تم إعداد التطبيق باستخدام مفتاح API لتسجيل دخول الموظف.
لمن Card Operations تستخدم أختام Poster؟
أولئك من تسجيل دخول الموظفين الذين يستخدم التطبيق مفتاح API الخاص بهم.
هل أحتاج إلى مفتاح API من أجل Poster؟
نعم، مفتاح API لتسجيل دخول الموظف.
Toast
يظهر Toast عبارة “قريبا” لكل الأعمال حتى يتم إعداد وصول Toast على المنصة. إنه مفتاح واحد للمنصة بأكملها، وليس إعدادًا للعمل؛ بمجرد تشغيله، يحمل بطاقة Toast الإعداد نفسه.
كل موقع Toast متصل بواسطة معرفه GUID بتسجيل دخول موظف واحد، بدون مفتاح API: قد ينطبق عمل هذا الموظف وبطاقة الأختام وخطته على كل طلب Toast من الموقع. يمكن ربط الموقع بتسجيل دخول موظف واحد فقط، ويحتوي تسجيل دخول الموظف على موقع واحد. تُرفض الطلبات من الموقع بمجرد أن يتم فصله، أو بينما يكون تسجيل دخول الموظف الخاص به متوقفًا أو محذوفًا.
يمكن إعطاء كل قسيمة منتج قائمة Toast: عند Toast POS تصبح بعد ذلك خصمًا على هذا المنتج. القسيمة التي لا تحتوي على واحدة تُطبق كخصم صفر على الفاتورة، ويقوم الصراف بتسليم الهدية باليد. يتم استرداد القسائم في Toast POS، وتُدار عجلة يتم الوصول إليها بواسطة فاتورة مدفوعة على الفور. عندما يقوم Toast بإلغاء عملية، يتم استرجاع أختامها أو إعادة القسائم التي تم استردادها.
يمكن للضيف الانضمام عند كشك Toast أو الشاشة المخصصة للضيوف باستخدام رقم هاتف أو بريد إلكتروني. يتم إصدار بطاقة الأختام فورًا؛ لا يحصل الضيف على أي شيء من 7Stamp حتى يفتحها بنفس الهاتف أو البريد الإلكتروني.
لماذا يقول Toast قادم قريبًا؟
وصول Toast هو مفتاح واحد للمنصة بأكملها، وليس إعداداً لنشاطك التجاري. حتى يتم تشغيله، لا يوجد شيء للاتصال به.
كيف يتم توصيل موقع Toast؟
بواسطة معرفه الموجّه إلى تسجيل دخول موظف واحد، دون مفتاح API. تنطبق بطاقة ختم ذلك التسجيل وخطته على كل طلب من الموقع.
ماذا يحدث للأختام عندما يقوم Toast بإلغاء شيك؟
عندما يقوم Toast بإلغاء معاملة، يتم استرجاع أختامه أو استعادة القسائم التي تم صرفها.
SmartKasa

SmartKasa لا يحتاج إلى مفتاح API. إنه مصدر إيصال في مسح الإيصالات، يتم إضافته بواسطة معرف المتجر SmartKasa أو بواسطة رمز الشركة لتغطية كل متجر. يقوم العملاء بمسح إيصال SmartKasa في شات بوت الأعمال، وتذهب الأختام إلى تسجيل دخول الموظف لذلك المصدر الإيصال.
SmartKasa أوكراني، والإيصالات المالية تعمل فقط في أوكرانيا وسلوفاكيا وكازاخستان وأوزبكستان.
هل أحتاج إلى مفتاح API من أجل SmartKasa؟
لا. SmartKasa هو مصدر الإيصال في مسح الإيصالات، يضاف بواسطة معرف المتجر أو بواسطة رمز الشركة.
أين يقوم العملاء بمسح إيصال SmartKasa ضوئيًا؟
في روبوت الدردشة الخاص بنشاطك التجاري. تذهب الأختام إلى تسجيل دخول الموظف لمصدر الإيصال ذلك.
في أي الدول تعمل الإيصالات المالية؟
في أوكرانيا وسلوفاكيا وكازاخستان وأوزبكستان.
Make و Zapier

تطبيق 7Stamp لـ Make موجود في مكتبة تطبيقات Make العامة: ابحث عن 7Stamp في أي سيناريو في Make، أو استخدم فتح في Make على علامة تبويب التكاملات. أما تطبيقنا لـ Zapier فغير موجود في دليل Zapier العام: فتح في Zapier هو دعوة تضيف التطبيق إلى حساب Zapier الخاص بالشركة. يعمل كلا التطبيقين بمفتاح API لتسجيل دخول الموظف.
يتم بدء سيناريوهات Make وZaps بواسطة Webhooks الخاص بـ 7Stamp، لذلك تحتاج المحفزات إلى الإضافة Webhooks & Events. تتطلب الإجراءات مثل إضافة الأختام أو إصدار قسيمة مجرد مفتاح API. لا يتم تقديم Make وZapier إلى White Label Business.
أين أجد تطبيق 7Stamp في Make وZapier؟
في Make، ابحث عن 7Stamp في أي سيناريو — التطبيق موجود في مكتبة تطبيقات Make العامة. أما في Zapier فهو غير متاح للعموم بعد، لذا استخدم فتح في Zapier على علامة تبويب التكاملات — الدعوة تضيف التطبيق إلى حسابك الخاص.
هل يحتاج كل من Make و Zapier إلى الملحق Webhooks & Events؟
المُحفّزات تعمل، لأن السيناريوهات و Zaps يتم تشغيلها بواسطة Webhooks من 7Stamp. الإجراءات مثل إضافة الأختام أو إصدار قسيمة تحتاج فقط إلى مفتاح API.
هل أحتاج إلى مفتاح API من أجل Make أم Zapier؟
نعم. التطبيقات تعمل باستخدام مفتاح API لتسجيل دخول الموظف.