ثبت‌نام
یکپارچه‌سازی و API

به سامانه‌هایی که دارید وصل می‌شود، نه اینکه جایشان بنشیند

باشگاه مشتریانی که از فروش جدا بماند، هر روز بخشی از داده را از دست می‌دهد؛ خریدی که ثبت نشده، امتیازی نساخته و در هیچ گزارشی نیست. شکلات با توکن وب‌سرویس و وب‌هوک در هر دو جهت به سامانه‌های موجود شما وصل می‌شود و دامنه‌ی هر اتصال را خودتان می‌بندید.

  • توکن وب‌سرویس با دامنه‌ی محدود به کانال و شعبه
  • وب‌هوک با امضای پیام، تلاش مجدد و تاریخچه‌ی تحویل
  • ساختار چندشعبه‌ای با دسترسی تفکیک‌شده‌ی کاربران
ثبت‌نام همه‌ی قابلیت‌ها
وب‌هوک‌ها مقصد فعال ۳ تحویل امروز ۱٬۲۰۴ از ۱٬۲۰۷ سه پیام ناموفق دوباره ارسال شدند توکن‌های دسترسی هر سامانه توکن خودش را دارد و فقط در دامنه‌ی خودش کار می‌کند توکن تازه فروشگاه اینترنتی سایت کانال: فروشگاه اینترنتی · همه‌ی شعبه‌ها آخرین استفاده ۲ دقیقه پیش فعال ابطال نرم‌افزار حسابداری کانال: حضوری · شعبه مرکزی و غرب آخرین استفاده ۱ ساعت پیش فعال ابطال صندوق‌های شعبه شمال کانال: حضوری · شعبه شمال آخرین استفاده دیروز فعال ابطال آزمایشی تیم فنی بدون دسترسی از ۲۰ مهر آخرین استفاده ۱۲ روز پیش باطل‌شده نمونه‌ی پیام رویداد { "event": "invoice.created", "branch": "central", "amount": 1800000, "points": 360 }
مسئله

هزینه‌ی سامانه‌ای که وصل نیست

ثبت دستی فراموش می‌شود

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

داده در دو جا دو روایت دارد

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

اتصال یعنی دسترسی بی‌مرز

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

واکنش خودکار تأخیر دارد

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

۱ وب‌سرویس

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

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

  • توکن جدا برای هر سامانه، با نام قابل شناسایی
  • محدود کردن دامنه به کانال فروش و شعبه‌های مشخص
  • ابطال فوری توکن، بدون اثر روی بقیه‌ی اتصال‌ها
توکن تازه نام توکن فروشگاه اینترنتی سایت کانال فروش فروشگاه اینترنتی شعبه‌ها همه‌ی شعبه‌ها مجوزها ساخت و ویرایش مشتری ثبت صورت‌حساب مشاهده‌ی موجودی مشتری تغییر دستی اعتبار توکن ساخته شد؛ فقط همین یک بار نمایش داده می‌شود shk_live_8f3a••••••••••••c91d کپی
۲ وب‌هوک

خبر رویداد، همان لحظه که اتفاق می‌افتد

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

  • انتخاب رویدادها و محدود کردن به شعبه یا کانال
  • امضای هر پیام برای راستی‌آزمایی در سمت شما
  • ارسال آزمایشی و تاریخچه‌ی وضعیت تحویل
مقصد وب‌هوک ارسال آزمایشی نشانی مقصد https://erp.example.ir/hooks/shokolat صورت‌حساب ثبت شد اعتبار مشتری تغییر کرد مشتری تازه ساخته شد گروه مشتری عوض شد کلید امضا whsec_••••••••4b2e ساخت دوباره تحویل‌های اخیر ۱۸:۲۴ invoice.created ۲۰۰ · تحویل شد ۱۸:۲۴ credit.changed ۲۰۰ · تحویل شد ۱۸:۰۲ invoice.created ۵۰۰ · تلاش دوباره
۳ کانال و ترمینال

هر مسیر فروش، برچسب خودش را دارد

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

  • تفکیک گزارش و شرط کمپین بر پایه‌ی کانال فروش
  • شعبه‌ی تسویه‌ی مشخص برای هر کانال
  • رمز اتصال قابل تولید دوباره برای هر ترمینال
کانال‌های فروش ۳۰ روز اخیر صورت‌حساب حضوری تسویه در همان شعبه ۲٬۰۴۰ فروشگاه اینترنتی تسویه در شعبه مرکزی ۸۹۲ اپلیکیشن تسویه در شعبه مرکزی ۱۶۰ ۹۴ صورت‌حساب بدون کانال ثبت شده‌اند و در گزارش جدا دیده می‌شوند. ترمینال‌های بانکی صندوق ۱ · شعبه مرکزی رمز اتصال •••••• تولید دوباره صندوق ۲ · شعبه غرب رمز اتصال •••••• تولید دوباره
۴ شعبه و دسترسی

مرز داده میان شعبه‌ها و کارکنان

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

  • دسترسی تفکیک‌شده، جدا از نقش پیش‌فرض
  • محدود کردن کاربر به یک شعبه
  • غیرفعال کردن کاربر با حفظ سابقه‌ی فعالیت
کاربران و دسترسی‌ها ع علی احمدی مدیر فروشگاه · همه‌ی شعبه‌ها م مریم نوری صندوق‌دار · شعبه غرب ح حسین رضوی بازاریاب · همه‌ی شعبه‌ها پ پیمان کاظمی غیرفعال · سابقه حفظ شده دسترسی‌های مریم نوری فقط داده‌ی شعبه غرب صدور صورت‌حساب جست‌وجوی مشتری گزارش همین شعبه تغییر دستی اعتبار ارسال پیامک گروهی مدیریت کمپین
جریان کار

اتصال چطور برقرار می‌شود

گام ۱

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

مرز فروش و تسویه پیش از هر اتصالی مشخص می‌شود.

گام ۲

توکن با دامنه‌ی لازم ساخته می‌شود

هر سامانه توکن خودش را می‌گیرد، نه یک کلید مشترک.

گام ۳

وب‌هوک برای واکنش خودکار تنظیم می‌شود

رویدادهای لازم انتخاب و با ارسال آزمایشی راستی‌آزمایی می‌شوند.

جزئیات

جزئیات فنی که در ارزیابی مهم‌اند

جهت هر اتصال جداست

وب‌سرویس یعنی سامانه‌ی شما درخواست می‌فرستد و پاسخ می‌گیرد؛ وب‌هوک یعنی شکلات خودش خبر می‌دهد. برای واکنش بی‌تأخیر، دومی لازم است.

تلاش مجدد پلکانی

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

توقف خودکار مقصد معیوب

مقصدی که پیاپی خطا بدهد خودکار متوقف می‌شود و دلیلش نوشته می‌شود؛ این از انباشت صف روی یک نشانی خراب جلوگیری می‌کند.

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

کلید به‌صورت رمزنگاری‌شده نگه داشته می‌شود و دیگر خواندنی نیست؛ در صورت گم شدن، کلید تازه ساخته می‌شود و کلید قبلی همان لحظه بی‌اعتبار می‌شود.

نشانی مقصد باید عمومی و امن باشد

نشانی باید با https باشد و به شبکه‌ی داخلی اشاره نکند؛ چنین نشانی‌ای پذیرفته نمی‌شود.

گسترش دامنه‌ی اعتبار برگشت‌ناپذیر است

وقتی اعتبار موجود مشتریان را در شعبه‌ی تازه‌ای قابل خرج می‌کنید، این تصمیم دیگر تنگ نمی‌شود؛ پیش از تأیید، تعداد و مبلغ روی صفحه نشان داده می‌شود.

پرسش‌ها

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

شکلات به سامانه‌ی فروش فعلی ما وصل می‌شود؟

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

دسترسی یک سامانه‌ی متصل را چطور محدود کنیم؟

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

چطور مطمئن شویم پیام وب‌هوک واقعاً از شکلات آمده است؟

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

اگر سامانه‌ی ما موقتاً از دسترس خارج شود چه می‌شود؟

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

داده‌ی هر شعبه از بقیه جدا نگه داشته می‌شود؟

بله. شعبه واحد تفکیک فروش، اعتبار و گزارش است و کاربر محدود به یک شعبه فقط داده‌ی همان شعبه را می‌بیند. دسترسی‌های حساس مثل تغییر دستی اعتبار جداگانه قابل گرفتن است.

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

دامنه‌ی مصرف هر اعتبار مشخص است و می‌توانید اعتبارهای موجود را در شعبه‌ی تازه هم قابل خرج کنید. این کار برگشت‌ناپذیر است، پس پیش از اجرا تعداد و مبلغ اعتبارهای تحت تأثیر نشان داده می‌شود.

قابلیت‌های مرتبط

شکلات را به سامانه‌های فعلی‌تان وصل کنید

ثبت‌نام گفت‌وگو با تیم فروش