اتصال اسنپشاپ به هدهدهاب: سفارش، محصول و اقدام تاییدی
اسنپشاپ برای فروشنده وقتی ارزشمندتر میشود که کنار ووکامرس، دیجیکالا، باسلام، پیامرسانها و کمپینها دیده شود. هدهدهاب اتصال رسمی اسنپشاپ را به یک Channel عملیاتی تبدیل میکند: خواندن سفارش و محصول، گزارش فروش، هشدار سفارش و مسیر تاییدی برای تغییرات حساس.
- اتصال رسمی با accessToken فروشنده، کد User-Agent اسنپ و vendorId اختیاری
- خواندن محصولات و سفارشها پشت FARSIBOT_SNAPPSHOP=on، بدون اسکرپینگ پنل فروشنده
- هشدار سفارش با dedupe و خروجی receipt-safe بدون افشای اطلاعات مشتری
- تغییر قیمت و موجودی فقط dry-run-first، approval-bound و تکمحصولی
چطور راه میافتد
- 1
credential رسمی فروشنده را آماده کن
accessToken فروشنده، کد User-Agent اختصاصی اسنپ و در صورت نیاز vendorId. اتصال بدون اینها برقرار نمیشود، چون مسیر ما فقط API رسمی است و راه جایگزینی برایش نمیسازیم.
- 2
با safe read probe شروع کن
اول فروشندههای مجاز، کاتالوگ و سفارشهای scoped خوانده میشوند. این مرحله چیزی را تغییر نمیدهد و پایهٔ اعتماد به اتصال است.
- 3
order watch را روشن کن
رویدادهای تکراری dedupe میشوند و خروجی برای receipt و task امن است — بدون افشای توکن، شماره مشتری یا شناسههای خصوصی.
- 4
تغییرات را dry-run-first انجام بده
هر تغییر قیمت یا موجودی اول بهصورت dry-run و policy check ساخته میشود و بعد از تایید مالک، یک patch تکمحصولی ارسال میشود.
کجا به کار میآید
فروشندهای که چند کانال دارد
اسنپشاپ کنار ووکامرس، دیجیکالا و باسلام دیده میشود تا قیمت و موجودی بین کانالها ناهماهنگ نماند.
پیگیری سفارش بدون سرکشی دستی
order watch سفارش تازه را به کانال اطلاعرسانی میرساند، بدون اینکه کسی مجبور باشد پنل را مرتب رفرش کند.
تیمی که به audit نیاز دارد
هر تغییر با dry-run، تایید مالک و رسید ثبت میشود؛ برای تیمهای چندنفره این تنها راه پیگیری تغییرات است.
اول read-only، بعد پیشنهاد تاییدی
اتصال اسنپشاپ در هدهدهاب با safe read probe شروع میشود: فروشندههای مجاز، کاتالوگ و سفارشهای scoped. این دادهها وارد گزارش، مدل commerce و پیشنهادهای هدهد میشوند؛ اما هیچ تغییر قیمت یا موجودی بدون dry-run، policy check و تایید مالک اجرا نمیشود.
رسید امن برای هشدار و تغییر
Order watch اسنپشاپ رویدادهای تکراری را dedupe میکند و خروجی آن برای receipt و task امن است: کانال اطلاعرسانی، وضعیت، تعداد رویداد جدید و زمان بررسی ثبت میشود، اما access token، User-Agent، شماره مشتری، chat id و جزئیات حساس در پاسخ عمومی برنمیگردد.
Feature-gated و رسمی
اسنپشاپ پشت feature flag فعال میشود و فقط با credential فروشنده کار میکند. هدهدهاب برای این مسیر از API رسمی اتوماسیون استفاده میکند و راههای پرریسک مثل cookie replay، browser session bridge یا اسکرپینگ پنل خصوصی فروشنده را محصولی نمیکند.
در یک نگاه
- چه چیزی لازم داری
- accessToken رسمی فروشنده، کد User-Agent اسنپ و در صورت نیاز vendorId.
- پیشنیاز محیط
- روشنبودن FARSIBOT_SNAPPSHOP در محیط هدف.
- خواندن
- فروشندههای مجاز، کاتالوگ و سفارشهای scoped.
- نوشتن
- dry-run-first، approval-bound و تکمحصولی.
- حریم داده
- receipt و گزارش redacted؛ توکن و اطلاعات مشتری افشا نمیشود.
بیپرده: چه کاری نمیکند
ترجیح میدهیم قبل از خرید بدانی، نه بعد از آن.
- cookie replay، browser session bridge و اسکرپینگ پنل خصوصی فروشنده را محصولی نمیکنیم.
- تغییر دستهجمعی قیمت یا موجودی نداریم؛ هر patch تکمحصولی است.
- اتصال پشت feature flag است و فعالسازیاش مرحلهای انجام میشود.
- دسترسی به همان چیزی محدود است که credential رسمی فروشنده اجازه میدهد.
سوالات متداول
برای اتصال اسنپشاپ چه چیزهایی لازم است؟+
accessToken رسمی فروشنده، کد User-Agent اختصاصی اسنپ و در صورت نیاز vendorId. همچنین باید FARSIBOT_SNAPPSHOP در محیط هدف روشن باشد.
آیا هدهدهاب موجودی یا قیمت اسنپشاپ را خودکار تغییر میدهد؟+
نه. تغییر قیمت و موجودی approval-bound است؛ ابتدا dry-run و policy check ساخته میشود و فقط پس از تایید مالک یک patch تکمحصولی ارسال میشود.
آیا اطلاعات مشتری یا توکن در گزارشها دیده میشود؟+
نه. گزارش و receipt فقط خلاصهٔ عملیاتی redacted نشان میدهند و access token، User-Agent، شماره مشتری، chat id و شناسههای خصوصی را افشا نمیکنند.
چرا پشت feature flag است؟+
چون اتصال به credential رسمی فروشنده و شرایط دسترسی وابسته است. فعالسازی مرحلهای یعنی هر workspace وقتی روشن میشود که پیشنیازهایش واقعاً فراهم باشد.
تغییر قیمت تکمحصولی یعنی چه؟+
یعنی هر patch فقط یک محصول را تغییر میدهد. این عمدی است: تغییر دستهجمعی، اشتباههای بزرگ میسازد و برگرداندنش سخت است.
مرتبط با این صفحه
آمادهای حرفت رو هُدهُد کنی؟
بیا شروع کنیم. توی چند دقیقه اولین رباتت رو میسازم و قبل از انتشار نشونت میدم.
همین حالا اولین هُدهُدت رو بساز