محتوای آموزشی وبلاگ نت‌آرام
سفارش در ووکامرس ثبت شده، اما نرم‌افزار انبار یا حسابداری آن را دریافت نکرده است. در تنظیمات فروشگاه می‌بینید وضعیت وب‌هوک Disabled شده است. وب‌هوک خروجی را می‌توان شبیه یک پیام خودکار دانست: وقتی اتفاقی مثل ایجاد سفارش می‌افتد، فروشگاه اطلاعاتی را به نشانی تعیین‌شده می‌فرستد.
اگر ارسال چند بار شکست بخورد، ووکامرس یا افزونه مرتبط ممکن است وب‌هوک را متوقف کند. روشن‌کردن دوباره آن بدون شناخت علت، ممکن است دوباره به خطا برسد. همچنین ارسال دوباره سفارش‌های واقعی بدون کنترل گیرنده می‌تواند رکورد یا کار انبار را تکرار کند. در این آموزش مسیر خطا را جدا می‌کنیم و سپس با داده آزمایشی نتیجه را می‌سنجیم.
اول جهت پیام را مشخص کنید
این مقاله درباره پیام خروجی از ووکامرس به سرویس دیگر است؛ برای مثال ارسال سفارش از فروشگاه به انبار. پیام نتیجه پرداخت که از درگاه به فروشگاه برمی‌گردد، ممکن است سازوکار و تنظیمات متفاوتی داشته باشد. اگر پرداخت موفق شده اما سفارش در انتظار است، راهنمای پرداخت موفق و سفارش در انتظار را بخوانید.
از مسئول اتصال بپرسید نام سرویس مقصد چیست، چه رویدادی باید ارسال شود و آن سرویس پس از دریافت، کجا سفارش را نمایش می‌دهد. یک سفارش نمونه و زمان تقریبی آن را انتخاب کنید، اما اطلاعات مشتری و نشانی محرمانه مقصد را در پیام عمومی یا تصویر گزارش منتشر نکنید.
وضعیت و مشخصات وب‌هوک را ببینید
در پیشخوان به ووکامرس ← پیکربندی ← پیشرفته ← وب‌هوک‌ها بروید. نام منو در نسخه‌ها و ترجمه‌ها ممکن است کمی متفاوت باشد. وب‌هوک مرتبط با انبار یا حسابداری را باز کنید و بدون تغییر، این موارد را یادداشت کنید:
۱. وضعیت: Active، Paused یا Disabled چه معنایی در همان صفحه دارند؟ Paused می‌تواند توقف عمدی باشد و Disabled ممکن است به شکست‌های تحویل مربوط باشد.
۲. موضوع یا Topic: آیا رویداد موردنیاز، مانند ایجاد یا تغییر سفارش، انتخاب شده است؟ رویداد ایجاد با پرداخت‌شدن سفارش همیشه یکی نیست.
۳. نشانی مقصد یا Delivery URL: آیا متعلق به همان سرویس و محیط درست است؟ نشانی آزمایشی و نشانی اصلی را اشتباه نگیرید.
۴. کاربر و تنظیم محرمانه: در صورت استفاده از کلید یا امضا، آن را با اطلاعات معتبر گیرنده تطبیق دهید، اما مقدار آن را در گزارش عمومی منتشر نکنید.
مستندات WooCommerce توضیح می‌دهد شکست‌های پی‌درپی می‌توانند باعث غیرفعال‌شدن وب‌هوک شوند و تعداد مجاز در بعضی پیکربندی‌ها قابل تغییر است. عدد پیش‌فرض را به‌عنوان تضمین رفتار همه نسخه‌ها و افزونه‌ها در نظر نگیرید. راهنمای رسمی کار با وب‌هوک ووکامرس مسیر تنظیم و ثبت گزارش را شرح می‌دهد.
گزارش ارسال را از کجا بخوانیم؟
به ووکامرس ← وضعیت ← گزارش‌ها بروید و گزارش مربوط به وب‌هوک یا افزونه اتصال را برای زمان سفارش نمونه پیدا کنید. در برخی نسخه‌ها جزئیات تحویل از صفحه خود وب‌هوک یا گزارش افزونه نیز قابل دسترسی است. نام فایل و محل گزارش به نسخه و نوع اتصال بستگی دارد.
به زمان، شناسه رویداد، نشانی گیرنده، مدت درخواست و کد پاسخ توجه کنید. متن درخواست ممکن است نام، نشانی مشتری، اطلاعات سفارش یا کلید داشته باشد؛ فقط بخش لازم و پاک‌سازی‌شده را برای عیب‌یابی به فرد مجاز بدهید.
نتیجه‌های رایج را این‌طور تفسیر کنید:
- 404: مسیر دریافت در مقصد پیدا نشده است. آدرس دقیق و نسخه محیط را با راهنمای سرویس مقصد مقایسه کنید؛ شاید مسیر تغییر کرده باشد.
- 401 یا 403: گیرنده درخواست را از نظر احراز هویت یا مجوز نپذیرفته است. امضا، کلید و مجوز مرتبط را با مدیر مقصد بررسی کنید؛ اعتبارسنجی را برای عبور سریع خاموش نکنید.
- 429: گیرنده درخواست‌های بیش از حد یا محدودیت دیگری را اعلام می‌کند. زمان‌بندی، حجم ارسال و خط‌مشی سرویس را با مسئول مقصد بررسی کنید.
- 5xx یا timeout: گیرنده یا مسیر ارتباطی در آن لحظه پاسخ مناسب نداده است. زمان و شناسه درخواست را با گزارش مقصد مقایسه کنید؛ از شماره خطا نمی‌توان یک علت مشخص را قطعی دانست.
- پاسخ موفق HTTP: نشان می‌دهد درخواست از دید فرستنده پاسخ موفق گرفته است، اما الزاماً ثابت نمی‌کند سفارش در انبار ثبت یا پردازش نهایی شده است.
اگر هیچ تلاش ارسالی در گزارش نیست
اول مطمئن شوید رویداد نمونه واقعاً با Topic وب‌هوک یکی بوده و وضعیت آن در زمان رویداد Active بوده است. سپس در ووکامرس ← وضعیت ← کارهای زمان‌بندی‌شده یا مسیر مشابه نسخه خود، کارهای مرتبط را ببینید. ممکن است تحویل در صف مانده یا کاری شکست خورده باشد.
نام کار، زمان و پیام خطا را ثبت کنید. اجرای دستی همه کارهای معوق، حذف گروهی آن‌ها یا فعال‌سازی چندباره وب‌هوک می‌تواند ارسال‌های ناخواسته و تکراری بسازد. قبل از هر تلاش مجدد، از گیرنده بپرسید آیا رویداد قبلاً دریافت شده و آیا با شناسه سفارش یا شناسه رویداد جلوی پردازش تکراری را می‌گیرد.
اگر صف زمان‌بندی سایت به‌طور کلی عقب مانده است، مسئله باید برای همان محیط جداگانه بررسی شود؛ ممکن است تنها یک وب‌هوک نباشد که تحت تأثیر قرار گرفته است. گزارش‌های دیگر و سلامت زمان‌بندی کمک می‌کنند علت محدودتر شود.
بعد از رفع علت، یک آزمایش کنترل‌شده انجام دهید
در صورت امکان از فروشگاه و سرویس مقصد آزمایشی استفاده کنید و ایمیل، انبار و درگاه واقعی را از داده آزمایشی جدا نگه دارید. نشانی مقصد، Topic و روش تأیید امضا را با مستندات همان اتصال اصلاح کنید. سپس وضعیت وب‌هوک را طبق نیاز فعال و ذخیره کنید. ووکامرس ممکن است هنگام ذخیره اولیه یک پیام آزمایشی یا ping بفرستد؛ این پیام با ثبت و پردازش یک سفارش واقعی یکسان نیست.
یک سفارش آزمایشی مجاز بسازید و شناسه آن را یادداشت کنید. در گزارش فروشگاه ببینید درخواست مربوط ارسال و چه پاسخی دریافت شده است. سپس در سامانه مقصد بررسی کنید همان شناسه یک بار ثبت شده و داده‌های ضروری درست هستند. اگر پاسخ ۲۰۰ گرفته‌اید اما سفارش مقصد دیده نمی‌شود، پردازش پس از پذیرش را در گزارش مقصد دنبال کنید.
با سفارش‌های جاافتاده چه کنیم؟
فهرست سفارش‌های بازه اختلال را با رکوردهای موجود در انبار یا حسابداری تطبیق دهید. برای هر مورد مشخص کنید آیا واقعاً غایب است یا دریافت شده اما نمایش آن با تأخیر انجام می‌شود. فقط پس از تأیید قابلیت جلوگیری از ثبت تکراری و با روش رسمی همان اتصال، سفارش‌های غایب را طبق برنامه بازفرستید یا ثبت کنید.
اگر روش بازفرستادن یا نتیجه قبلی روشن نیست، ابتدا مسئول سامانه مقصد باید وضعیت را مشخص کند. پاک‌کردن سفارش ووکامرس، تغییر تصادفی وضعیت پرداخت یا فرستادن دسته‌ای همه رویدادها راه‌حل امنی نیست. پس از ترمیم، یک سفارش تازه را هم از ابتدا تا ثبت مقصد آزمایش کنید.
برای فروشگاه‌هایی که به منابع متناسب با بازدید نیاز دارند، صفحه هاست پربازدید نت‌آرام را ببینید. تحویل وب‌هوک به تنظیم صحیح فروشگاه، مسیر شبکه و پردازش سرویس مقصد وابسته است.
برچسب‌ها:
اشتراک‌گذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله قبلی وجود ندارد.
مقاله بعدی
دیدگاه‌ها (۰)
دیدگاه‌های تاییدشده و پاسخ‌های تیم نت‌آرام