مرجع عملیات

API، وب‌هوک‌ها و یکپارچه‌سازی‌ها

کلیدهای API برای ورودهای کارکنان، API چه کاری انجام می‌دهد، وبهوک‌ها و رویدادهای آنها، داده‌های ارسالی، امضا و تلاش‌های مجدد، و ادغام‌های آماده: Poster، Toast، SmartKasa، Make و Zapier.

خواندن سریع

به‌روزرسانی شده: ۲۸ آبان ۱۴۰۵

API و یکپارچه‌سازی‌ها

کلیدهای API در API و یکپارچه‌سازی‌ها

تنظیمات → API و یکپارچه‌سازی‌ها سه زبانه دارند: کلیدهای API، وبهوک‌ها و یکپارچه‌سازی‌ها.

کلیدهای 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 دارد، و یک ورود کارمند خاموش نمی‌تواند انتخاب شود. زمانی که هیچ ورود کارمند برای انتخاب وجود ندارد، پنجره تولید کلید API پیشنهاد می‌دهد که یکی همان‌جا ایجاد شود؛ یک ورود کارمند جدید به یک Staff Seat آزاد نیاز دارد، و در طرح پر، پنجره پیشنهاد می‌دهد که یک صندلی اضافه کنید یا به جای آن یک طرح انتخاب کنید.

هر تماس انجام شده با یک کلید API مانند ورود کارمند آن عمل می‌کند: فقط به کسب‌وکار ورود کارمند مربوطه می‌رسد، مهرها کارت مهرها انتخاب شده برای آن تحت مهر خودکار، و مهرها آن به عنوان ورود کارمند Card Operations محسوب می‌شود.

کلید را می‌توان در هر زمان دوباره از فهرست کلیدهای API مشاهده و کپی کرد. همچنین می‌توان آن را به صورت کد QR نمایش داد تا در یک ترمینال اسکن شود، و با نام ورود کارمند چاپ کرد.

چگونه یک کلید API ایجاد کنم؟

در تنظیمات → API و یکپارچه‌سازی‌ها → کلیدهای API، گزینه افزودن کلید API را انتخاب کرده و یک ورود کارمند را برگزینید. هر ورود کارمند حداکثر یک کلید API دارد.

من کلید API خود را گم کرده‌ام. آیا به یک کلید جدید نیاز دارم؟

خیر. کلید می‌تواند در هر زمان از فهرست کلیدهای API مشاهده و دوباره کپی شود، یا به‌صورت یک کد QR نمایش داده شود.

کدام کارت مهرها توسط API، مهر را صدا می‌زند؟

کسی که برای کلید ورود کارمند تحت مهر خودکار انتخاب شده است. شمار مهرها آن به عنوان ورود کارمند آن Card Operations محسوب می‌شود.

چرا نمی‌توانم یک ورود کارمند برای کلید جدید انتخاب کنم؟

یک ورود کارمند خاموش قابل انتخاب نیست، و یک ورود کارمند که قبلاً کلیدی دارد، نمی‌تواند کلید دوم دریافت کند. با نبود چیزی برای انتخاب، پنجره پیشنهاد می‌کند یک ورود کارمند ایجاد شود.

وقتی یک کلید API کار نمی‌کند

کلید API منقضی نمی‌شود. این کلید فقط زمانی کار نمی‌کند که دوباره تولید شود یا حذف گردد، یا زمانی که ورود کارمند آن خاموش یا حذف شود. رمز عبور یا ورود جدید برای ورود کارمند تأثیری بر آن ندارد.

  • Regenerate به ورود کارمند یک کلید API جدید می‌دهد؛ کلید قدیمی بلافاصله از کار می‌افتد.
  • Delete بلافاصله کلید را متوقف می‌کند. خود ورود کارمند در 7Stamp Scanner همچنان کار می‌کند و می‌تواند بعداً کلید جدیدی دریافت کند.
  • خاموش کردن ورود کارمند کلید آن را نگه می‌دارد: وقتی ورود کارمند دوباره روشن شود، همان کلید دوباره کار می‌کند.

آیا کلید API منقضی می‌شود؟

نه. این تنها زمانی از کار می‌افتد که بازتولید یا حذف شود، یا وقتی ورود کارمند آن خاموش یا حذف شود.

من رمز عبور ورود کارمند را تغییر دادم. آیا به یک کلید جدید API نیاز دارم؟

خیر. یک رمز عبور یا ورود جدید بر کلید API تأثیری ندارد.

من یک ورود کارمند را دوباره روشن کردم. آیا کلید قدیمی API آن کار می‌کند؟

بله. خاموش کردن یک ورود کارمند کلید آن را حفظ می‌کند، و همان کلید دوباره زمانی که دوباره روشن شود کار می‌کند.

API چه کار می‌کند

از طریق API یک سیستم می‌تواند:

  • یک کارت مهرها به صورت لینک یا QR ارائه دهید؛
  • افزودن مهرها؛
  • خواندن یک کارت با مهرها آن، اهداف و کوپنهای آن؛
  • صدور کوپن مستقیماً به یک کارت؛
  • استفاده کردن از یک کوپن با کد کوپن آن؛
  • پیامی به مشتری.

API کارت یک مشتری را با شناسه خود کسب‌وکار، مثل شناسه CRM، تلفن یا ایمیل پیدا می‌کند که به صورت external_id ارسال شده است. این شناسه روی کارت ذخیره می‌شود و در هر Webhook مربوط به آن بازمی‌گردد. API هیچ فراخوانی که کسب‌وکار را با مشتریان فهرست کند ندارد: کل پایگاه مشتری تنها از طریق خروجی مدیریت گرفته می‌شود.

به جای کلید API، یک برنامه می‌تواند با ورود و رمز عبور ورود کارمند وارد شود — برای دستگاهی که یک صندوقدار به آن وارد می‌شود. کلید API مناسب دستگاهی است که بدون نظارت عمل می‌کند. وبهوک‌ها فقط در بخش مدیریت اضافه می‌شوند؛ کلید API هیچ فراخوانی برای اشتراک در رویدادها یا لیست آن‌ها ندارد.

کد API هیچ محدودیت نرخ درخواست تعیین نمی‌کند: تماس‌ها بر اساس تعداد یا فراوانی محدود نمی‌شوند و همان کارت می‌تواند بلافاصله دوباره اسکن شود. آنچه مهر کردن از طریق آن را محدود می‌کند، Card Operations طرح است.

آیا می‌توانیم مهرها را از CRM یا POS خودمان اضافه کنیم؟

بله، از طریق API. این کارت‌های مهرها را توزیع می‌کند، مهرها را اضافه می‌کند، کارت‌ها را می‌خواند و کوپنها را بازخرید می‌کند. برای اینکه سیستم شما از رویدادها مطلع شود، یک وبهوک اضافه کنید — که نیاز به افزونه Webhooks & Events دارد.

آیا می‌توانیم داده‌ها را صادر کنیم؟

از طریق API شما کارت‌ها را با شناسه خودتان می‌خوانید، و وبهوک‌ها رویدادها را همانطور که اتفاق می‌افتند ارسال می‌کنند. API هیچ فهرستی از تمام مشتریان ندارد — کل پایگاه مشتری از طریق خروجی مدیر استخراج می‌شود.

چگونه API کارت مشتری را پیدا می‌کند؟

با شناسه خودتان — یک شناسه CRM، شماره تلفن یا ایمیل — که به عنوان external_id ارسال شده است. این شناسه روی کارت ذخیره می‌شود و در هر Webhook مربوط به آن باز می‌گردد.

می‌توانم از طریق API در وبهوک‌ها اشتراک‌گذاری کنم؟

نه. وبهوک‌ها فقط در بخش مدیریت اضافه می‌شوند.

آیا API محدودیت نرخ دارد؟

خیر. تماس‌ها بر اساس تعداد یا فرکانس محدود نمی‌شوند و همان کارت می‌تواند بلافاصله دوباره اسکن شود. مهرing تنها توسط 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 آن به همان صورت کار می‌کنند.

مستندات 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 آن و وبهوک‌ها همان‌طور کار می‌کنند.

وب‌‌هوک‌ها

وبهوک‌ها در API و یکپارچه‌سازی‌ها

یک وب هوک تحت API اضافه می‌شود و از مسیر integrations → Webhooks → Add webhook استفاده می‌شود، با URL که رویدادها را دریافت می‌کند. در 7Stamp یک وب هوک برای رویدادهای کارت مهرها ایجاد می‌شود. یک کسب‌وکار می‌تواند چندین وب هوک اضافه کند، هر کدام با URL خود.

وب‌هوک‌ها نیاز به افزودنی Webhooks & Events، $19 در ماه دارند، که فقط در طرح‌های پرداخت‌شده ارائه می‌شود. افزودن اولین وب‌هوک پیشنهاد خرید آن را می‌دهد؛ بدون آن، نمی‌توان وب‌هوکی ایجاد یا دوباره فعال کرد. هر افزودنی یک وب‌هوک را روشن نگه می‌دارد: می‌توان تعداد بیشتری اضافه کرد، اما هر بروزرسانی صورتحساب اشتراک همه وب‌هوک‌ها را غیرفعال می‌کند به جز قدیمی‌ترین آن‌ها.

وب‌هاک‌ها رویدادها را همزمان با وقوع آن‌ها از لحظه‌ای که وب‌هاک اضافه می‌شود ارسال می‌کنند. رویدادهای قبلی ارسال نمی‌شوند.

آیا وبهوک‌ها رایگان هستند؟

نه. آنها به افزونه Webhooks & Events، $19 در ماه نیاز دارند که فقط در طرح‌های پولی ارائه می‌شود. خود API رایگان است.

من یک وبهوک دوم اضافه کردم و خاموش بود. چرا؟

یک افزونه Webhooks & Events باعث می‌شود یک وب‌هوک روشن بماند. هر به‌روزرسانی صورتحساب اشتراک، همه وب‌هوک‌ها به جز قدیمی‌ترین آن را خاموش می‌کند.

آیا یک وبهوک جدید رویدادهای گذشته را ارسال می‌کند؟

خیر. رویدادها از لحظه‌ای که وبهوک اضافه می‌شود ارسال می‌شوند.

رویدادهای وب‌هوک

یک وبهوک پانزده رویداد کارت مهرها دریافت می‌کند، که در 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. دو مورد آخر زمانی رخ می‌دهند که گذرنامه به یک کیف پول اضافه یا از آن حذف می‌شود، با کیف پول، اپل یا گوگل.

اسکن‌ای که مهر اضافه نمی‌کند، مانند خریدی کمتر از قیمت مهر، هنوز SCAN را با صفر مهرها ارسال می‌کند. جایزه‌ای که روی یک چرخ برده می‌شود، هنگام چرخاندن چرخ توسط یک LOTTERY_WIN اعلام می‌شود، نه توسط REWARD_EARNED یا VOUCHER_ISSUED؛ چرخ در حال انتظار برای چرخاندن هنوز هیچ چیزی ارسال نمی‌کند.

نظرات مشتری، رویدادهای کارت مهرها نیستند. هر نظر جدید یک رویداد با موجودیت review و عمل created ارسال می‌کند، به وبهوک‌هایی که گزینه نظرات در میان اشیاء آن‌ها در صفحه وبهوک انتخاب شده است. یک وبهوک که اینجا اضافه می‌شود تنها برای رویدادهای کارت مهرها تنظیم می‌شود، بنابراین وقتی نظرات انتخاب می‌شود، آن را دریافت می‌کند.

آیا وقتی اسکن هیچ مهر اضافه نمی‌کند، یک وب‌هوک ارسال می‌شود؟

بله. اسکنری که هیچ مهر اضافه نمی‌کند، مانند خریدی زیر قیمت مهر، همچنان SCAN را با صفر مهرها اضافه شده ارسال می‌کند.

کدام رویداد به من می‌گوید که مشتری روی چرخ برنده شده است؟

LOTTERY_WIN، یک بار ارسال می‌شود زمانی که چرخ چرخانده می‌شود. چرخ منتظر برای چرخانده شدن هنوز چیزی ارسال نمی‌کند.

می‌توانم بفهمم وقتی یک مشتری کارت را از کیف پول خود بیرون می‌آورد؟

بله. افزودن گذرنامه به کیف پول و حذف آن، CARD_ADDED_TO_WALLET و CARD_REMOVED_FROM_WALLET را همراه با کیف پول، اپل یا گوگل ارسال می‌کند.

چگونه می‌توانم بازبینی‌های جدید مشتری را از طریق وبهوک دریافت کنم؟

صفحه وبهوک را باز کنید و بررسی‌ها را در میان اشیاء آن علامت بزنید. هر بررسی جدید سپس با موجودیت بررسی و اقدام ایجاد شده می‌آید؛ یک وبهوک که زیر 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 ارسال نمی‌کند؛ کارتی که پس از حذف شدن کارت قدیمی توسط مدیر دوباره صادر شود، ارسال می‌کند. زمانی که một پیوستن یک بسته کوپن و مهرها بیاورد، ابتدا CARD_JOINED، سپس VOUCHER_PACK و سپس DELIVERY_INSERT می‌آید.

یک کد مهر بدون مهرها هیچ DELIVERY_INSERT نمی‌فرستد، یک کوپن که در مدیریت بدون کارت ایجاد شده است هیچ ADMIN_VOUCHER_ISSUE نمی‌فرستد، و یک تماس تکراری API برای یک کوپن که قبلاً آن را استفاده کرده است، هیچ VOUCHER_REDEEMED دومی ارسال نمی‌کند.

کدام رویداد به من می‌گوید که مشتری به هدف خود رسیده است؟

REWARD_EARNED برای یک هدف Award، VOUCHER_ISSUED برای یک هدف کوپن و LOTTERY_WIN برای Lottery، هر کدام پس از رویداد خود اسکن ارسال شد.

آیا وقتی مهرها حذف می‌شود، یک وبهوک ارسال می‌شود؟

بله. مهرs که در 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 شامل یک timeمهر و یک HMAC-SHA256 از آن timeمهر و بدنه خام است که با کلید مخفی وبهوک کلیدگذاری شده است. کلید مخفی در صفحه وبهوک نشان داده شده و دوباره تولید می‌شود. همچنین می‌توان یک ورود و رمز عبور Basic auth اضافه کرد.

چطور بررسی کنم که یک وب‌هوک واقعاً از 7Stamp آمده است؟

HMAC-SHA256 از timeمهر و محتوای خام را با کلید مخفی وبهوک محاسبه کرده و آن را با سربرگ X-Webhook-Signature مقایسه کنید.

کلید مخفی وبهوک را از کجا پیدا کنم؟

در صفحه وبهوک، جایی که همچنین می‌توان آن را بازتولید کرد.

آیا می‌توانم نقطه پایانی خود را با یک رمز عبور محافظت کنم؟

بله. یک نام کاربری و رمز عبور Basic auth می‌تواند به وبهوک اضافه شود، علاوه بر امضا.

تحویل‌های ناموفق

تحویلی که در عرض سی ثانیه پاسخی با کد 2xx دریافت نکند، تا ده بار مجدداً امتحان می‌شود و هر بار چهار ثانیه بیشتر از بار قبلی منتظر می‌ماند، به طوری که تلاش‌های مجدد در حدود چهار دقیقه به پایان می‌رسد. پاسخ 429 با Retry-After بعد از آن زمان مجدداً امتحان می‌شود. اولین شکست یک رویداد یک اعلان در پنل مدیریت قرار می‌دهد.

پس از صد تحویل ناموفق متوالی، وبهوک توسط سیستم مسدود می‌شود و دیگر رویدادی دریافت نمی‌کند. صفحه آن قبل از این موضوع هشدار می‌دهد و یک دکمه رفع مسدودسازی دارد؛ یک تحویل موفق، شمارش را بازنشانی می‌کند.

هر صفحه‌ی وبهوک یک دفترچه از تحویل‌های آن دارد، با درخواست ارسالی و پاسخ دریافت شده. ارسال مجدد همان رویداد را دوباره می‌فرستد، فقط به این وبهوک.

سرور من از کار افتاده بود. آیا رویدادها از دست رفته‌اند؟

هر تحویل تا ده بار در حدود چهار دقیقه دوباره امتحان می‌شود. بعد از آن، دفترچه وبهوک را باز کرده و از گزینه دوباره ارسال برای رویدادهایی که نیاز دارید استفاده کنید.

چرا وبهوک من دریافت رویدادها را متوقف کرد؟

پس از صد تحویل ناموفق متوالی، توسط سیستم مسدود شده است. نقطه پایانی را اصلاح کرده و در صفحه وبهوک روی باز کردن مسدود کردن کلیک کنید.

می‌توانم ببینم به وبهوکم چه چیزی ارسال شده است؟

بله. هر صفحه وب‌هوک دارای یک دفترچه تحویل است که درخواست ارسال شده و پاسخ دریافت شده را نشان می‌دهد.

زبانهٔ یکپارچه‌سازی‌ها

زبانه‌ی ادغام‌ها

زبانهٔ یکپارچه‌سازی‌ها، روش‌های آماده را بر اساس گروه فهرست می‌کند:

  • مهر هنگام تسویه حساب شما — Poster، Toast، POS یا CRM خودتان و POS خود را نمی‌بینید؟;
  • رسیدهای مالی — SmartKasa;
  • Automation — Make، Zapier و عمومی Swagger.

هر کارت می‌گوید آیا به کلید API نیاز دارد یا نه. زبانه همان کارت‌ها را در هر کشور ارائه می‌دهد؛ تنها رسیدهای مالیاتی توسط کشور محدود شده‌اند.

POS یا CRM خودتان

یک White Label کسب‌وکار هیچ کارت Make، Zapier یا Public Swagger را نمی‌بیند و Poster یا راهنمای نصب روی 7stamp.com به آن ارائه نمی‌شود.

کدام سیستم‌های POS آماده اتصال هستند؟

Poster و Toast پس از روشن شدن آن برای پلتفرم — تا آن زمان، نمایش می‌دهد به زودی می‌آید. سایر سیستم‌ها از طریق API متصل می‌شوند، با POS یا CRM خودتان.

آیا ادغام‌ها محدود به کشور هستند؟

خیر. تب همان کارت‌ها را در هر کشور ارائه می‌دهد. تنها رسیدهای مالیاتی محدود به کشور هستند.

چرا Make و Zapier را نمی‌بینم؟

آنها به White Label کسب‌وکار نشان داده نمی‌شوند. کلیدها و وبهوک‌های API به همان صورت کار می‌کنند.

Poster

Poster برنامه ما در بازار Poster است. نصب در Poster فهرست آن را باز می‌کند، و برنامه با کلید API یک ورود کارمند راه‌اندازی شده است. شمارش مهرها آن به عنوان ورود کارمند از Card Operations است.

چطور Poster را وصل کنم؟

باز کردن ادغام‌ها → Poster و انتخاب نصب در Poster. برنامه با کلید API یک ورود کارمند تنظیم شده است.

Poster و مهرها از Card Operations چه کسی استفاده می‌کنند؟

آن‌هایی از ورود کارمند که برنامه از کلید API آن‌ها استفاده می‌کند.

آیا برای Poster به کلید API نیاز دارم؟

بله، کلید API از یک ورود کارمند.

Toast

Toast برای هر کسب‌وکار تا زمانی که دسترسی Toast روی پلتفرم تنظیم شود، عنوان «به زودی» را نشان می‌دهد. این یک سوئیچ برای کل پلتفرم است، نه یک تنظیم مربوط به کسب‌وکار؛ پس از فعال شدن، کارت Toast خود تنظیمات را نگه می‌دارد.

هر مکان Toast با GUID خود به یک ورود کارمند متصل است، بدون کلید API: ورود کارمند آن، کسب‌وکار، کارت مهرها و طرح برای هر درخواست Toast از آن مکان اعمال می‌شود. یک مکان می‌تواند فقط به یک ورود کارمند متصل شود، و یک ورود کارمند یک مکان را در خود نگه می‌دارد. درخواست‌ها از یک مکان زمانی رد می‌شوند که مکان قطع شود، یا در حالی که ورود کارمند آن خاموش یا حذف شده باشد.

هر کوپن می‌تواند یک محصول منوی Toast دریافت کند: در Toast POS سپس به یک تخفیف بر روی آن محصول تبدیل می‌شود. یک کوپن بدون آن به عنوان تخفیف صفر روی چک اعمال می‌شود و صندوقدار هدیه را به صورت دستی تحویل می‌دهد. کوپنها در Toast POS بازخرید می‌شوند و چرخ به دست آمده توسط یک چک پرداخت شده فوراً چرخانده می‌شود. وقتی Toast یک تراکنش را برمی‌گرداند، مهرهاهای آن بازپس گرفته می‌شوند یا کوپنهای بازخرید شده آن بازگردانده می‌شوند.

یک مهمان می‌تواند با شماره تلفن یا ایمیل در یک کیوسک Toast یا صفحه مواجهه با مهمان بپیوندد. کارت مهرها فوراً صادر می‌شود؛ مهمان چیزی از 7Stamp دریافت نمی‌کند تا زمانی که آن را با همان تلفن یا ایمیل باز کند.

چرا Toast می‌گوید به زودی می‌آید؟

دسترسی Toast یک سوئیچ برای کل پلتفرم است، نه تنظیمی برای کسب‌وکار شما. تا زمانی که روشن نباشد، چیزی برای اتصال وجود ندارد.

یک مکان Toast چگونه متصل است؟

با GUID آن به یک ورود کارمند، بدون کلید API. آن ورود کارمند و کارت مهرها و برنامه مرتبط با آن برای هر درخواستی از آن مکان اعمال می‌شود.

چه اتفاقی برای مهرها می‌افتد وقتی Toast یک چک را باطل می‌کند؟

وقتی Toast یک تراکنش را لغو می‌کند، مهرها آن بازپس گرفته می‌شوند یا کوپن‌های بازخرید شده آن بازیابی می‌شوند.

SmartKasa

SmartKasa در تب ادغام‌ها

SmartKasa به کلید API نیاز ندارد. این یک منبع رسید در اسکن رسید است که توسط شناسه فروشگاه SmartKasa یا توسط کد شرکت برای پوشش دادن هر فروشگاه اضافه شده است. مشتریان رسید SmartKasa را در چت‌بات کسب‌وکار اسکن می‌کند، و مهرها به ورود کارمند آن منبع رسید می‌رود.

SmartKasa اوکراینی است، و رسیدهای مالی فقط در اوکراین، اسلواکی، قزاقستان و ازبکستان کار می‌کنند.

آیا برای SmartKasa به کلید API نیاز دارم؟

خیر. SmartKasa یک منبع رسید در اسکن رسید است که توسط یک شناسه فروشگاه یا کد شرکت اضافه شده است.

مشتریان کجا رسید SmartKasa را اسکن می‌کند؟

در چت‌بات کسب‌وکار شما. مهرها به ورود کارمند آن منبع رسید می‌رود.

در کدام کشورها رسیدهای مالیاتی کار می‌کنند؟

در اوکراین، اسلواکی، قزاقستان و ازبکستان.

Make و Zapier

Make در تب ادغام‌ها

برنامه 7Stamp برای Make در کتابخانه عمومی برنامه‌های Make است: در هر سناریوی Make عبارت 7Stamp را جست‌وجو کنید، یا از Open in Make در تب Integrations استفاده کنید. برنامه Zapier ما در دایرکتوری عمومی Zapier نیست: Open in Zapier دعوتی است که برنامه را به حساب Zapier خود کسب‌وکار اضافه می‌کند. هر دو برنامه با کلید API یک ورود کارمند کار می‌کنند.

سناریوهای Make و Zaps توسط وب‌هاک‌های 7Stamp شروع می‌شوند، بنابراین تریگرها به افزونه Webhooks & Events نیاز دارند. اقداماتی مانند افزودن مهرها یا صدور کوپن تنها به یک کلید API نیاز دارند. Make و Zapier به White Label کسب‌وکار ارائه نمی‌شوند.

برنامه 7Stamp را در Make و Zapier کجا پیدا کنم؟

در Make، در هر سناریویی 7Stamp را جست‌وجو کنید — این برنامه در کتابخانه عمومی برنامه‌های Make است. در Zapier هنوز عمومی نیست، پس از گزینه Open in Zapier در تب Integrations استفاده کنید — دعوتنامه برنامه را به حساب خودتان اضافه می‌کند.

آیا Make و Zapier به افزونه Webhooks & Events نیاز دارند؟

تریگرها کار می‌کنند، زیرا سناریوها و زَپ‌ها توسط وبهوک‌های 7Stamp شروع می‌شوند. اقداماتی مانند افزودن مهرها یا صدور کوپن فقط نیاز به یک کلید API دارند.

آیا برای Make به یک کلید API یا Zapier نیاز دارم؟

بله. برنامه‌ها با کلید API از یک ورود کارمند کار می‌کنند.

مرجع
عملیات ۶ آبان ۱۴۰۵

پلن‌ها و صورتحساب

سه طرح، یک Card Operation چیست، چه چیزی شمرده می‌شود و چه چیزی رایگان است، افزونه‌ها، Packages از یک Access Code و چه اتفاقی می‌افتد وقتی یک پرداخت ناموفق است.

به‌روزرسانی شده: ۶ آبان ۱۴۰۵

باز کردن مقاله
مرجع
عملیات ۶ آبان ۱۴۰۵

دسترسی کارکنان

یک ورود کارمند چیست، چگونه ایجاد، تغییر، خاموش و حذف می‌شود، کارکنان چگونه به 7Stamp Scanner وارد می‌شوند، چه کاری می‌توانند آنجا انجام دهند، و چه کسی از پنل مدیریت استفاده می‌کند.

به‌روزرسانی شده: ۶ آبان ۱۴۰۵

باز کردن مقاله
مرجع
عملیات ۶ آبان ۱۴۰۵

مشتریان و تاریخچه

فهرست مشتریان' کارت‌های مهرها، صفحه کارت یک مشتری، حذف یک کارت، گزارش رویداد، آنچه 7Stamp درباره یک مشتری نگه می‌دارد و چگونه داده‌های یک مشتری پاک می‌شوند.

به‌روزرسانی شده: ۶ آبان ۱۴۰۵

باز کردن مقاله