Vigent Documentation · راهنمای گامبهگام
اتصال ووکامرس
نحوهٔ اتصال فروشگاه ووکامرس/وردپرس به ویجنت؛ نصب افزونه، تنظیم webhook و همگامسازی محصولات و سفارشها.
با اتصال ووکامرس به ویجنت، کاتالوگ محصولات و سفارشهای فروشگاه شما بهصورت خودکار با ویجنت همگام میشود. ایجنت میتواند قیمت، موجودی و مشخصات محصولات را از دادههای واقعی فروشگاه بخواند و وقتی سفارش جدید ثبت میشود، بهصورت خودکار روی پروفایل مخاطب مربوطه ظاهر میگردد.
این اتصال چه میکند؟
- محصولات: ایجاد/ویرایش/حذف هر محصول در ووکامرس، فوراً در کاتالوگ ویجنت منعکس میشود (با re-embedding خودکار برای جستجوی معنایی).
- سفارشها: تغییر وضعیت سفارش (مثلاً به «در حال پردازش» یا «تکمیلشده») یک رکورد StoreOrder میسازد و آن را از روی شماره تماس/ایمیل مشتری به مخاطب مربوطه متصل میکند.
- همگامسازی دستی: هر زمان دکمهٔ «همگامسازی الآن» را بزنید، کل محصولات و سفارشهای اخیر دوباره fetch میشوند.
- همگامسازی خودکار: هر ۱۰ دقیقه یکبار، worker ویجنت فروشگاههای فعال را کشش (poll) میکند تا تغییراتی که از webhook جا ماندهاند را جبران کند.
پیشنیازها
به وردپرس ۵.۶ به بالا، ووکامرس ۶ به بالا، و دسترسی مدیریت وردپرس برای نصب افزونه نیاز دارید. افزونه از REST API ووکامرس ( /wp-json/wc/v3 ) با احراز هویت Basic Auth (consumer key/secret) استفاده میکند.
گام ۱ — ساخت یکپارچهسازی در پنل ویجنت
به «یکپارچهسازیها» در داشبورد بروید، در بخش «فروشگاه آنلاین» روی «افزودن فروشگاه» بزنید، نوع «WooCommerce» را انتخاب کنید و آدرس فروشگاه + کلید consumer key/secret را وارد کنید. پس از ذخیره، ویجنت یک webhook URL و یک کلید امنیتی (webhook secret) به شما میدهد.
https://app.vigent.ir/api/sync/woocommerce?token=WEBHOOK_SECRETگام ۲ — نصب افزونهٔ وردپرس
- 1فایل افزونه را از پنل ویجنت (صفحهٔ اتصالات) یا از آدرس /downloads/vigent-wordpress.zip دانلود کنید.
- 2در وردپرس به «افزونهها ← افزودن ← بارگذاری افزونه» بروید و فایل vigent-woo.zip را آپلود کنید.
- 3افزونه را فعال کنید. یک منوی جدید با نام «ویجنت» در نوار کناری مدیریت ظاهر میشود.
- 4به «ویجنت ← تنظیمات» بروید و آدرس webhook و کلید امنیتی که از پنل ویجنت گرفتید را در فیلدها قرار دهید.
- 5روی «ذخیره» و سپس «تست اتصال» بزنید. افزونه یک پیام نمونه به ویجنت میفرستد تا اتصال را تأیید کند.
گام ۳ — همگامسازی اولیه
پس از تست موفق، روی «همگامسازی کامل» در صفحهٔ تنظیمات افزونه بزنید تا همهٔ محصولات و سفارشهای اخیر یکبار به ویجنت ارسال شوند. این کار ممکن است برای فروشگاههای بزرگ چند دقیقه طول بکشد. پس از آن، هر تغییر محصول/سفارش بهصورت فوری (push) از طریق webhook به ویجنت میرسد.
گام ۴ — تأیید در پنل ویجنت
به بخش «یکپارچهسازیها» برگردید. باید ببینید «آخرین همگامسازی» بهروز شده و در زیر آن لاگهای اخیر (products/orders + تعداد + نتیجه) ظاهر شدهاند. اگر پیامی در ستون «خطا» دیدید، روی آن بزنید تا متن خطا نمایش داده شود.
عیبیابی
- محصولات در ویجنت ظاهر نمیشوند؟ بررسی کنید consumer key/secret دسترسی «Read» به محصولات داشته باشد (در ووکامرس: WooCommerce → Settings → Advanced → REST API).
- سفارشها به مخاطب متصل نمیشوند؟ شماره تلفن/ایمیل سفارش باید با همان فیلدی که در پروفایل مخاطب ویجنت ذخیره شده مطابقت داشته باشد (نرمالسازی 0 و 98+ پشتیبانی میشود).
- webhook خطای 401 میدهد؟ کلید امنیتی (token) را در پنل ویجنت دوباره کپی کنید و در افزونه جایگذاری کنید. هر تغییر در پنل ویجنت، کلید را بازتولید نمیکند مگر اینکه یکپارچهسازی را حذف و دوباره بسازید.
- هیچ لاگی در پنل نیست؟ پس از «تست اتصال» در افزونه، یک ردیف لاگ باید فوراً در پنل ویجنت ظاهر شود. اگر نشد، احتمالاً آدرس webhook اشتباه است یا هاست outgoing را بسته است.