اتصال اینستاگرام به وردپرس؛ آموزش وب‌هوک و API

بیشتر فروشنده‌های اینستاگرامی که سایت هم دارند، عملاً دو دفتر جدا نگه می‌دارند: سفارش‌ها در دایرکت ثبت می‌شود و بعد کسی باید همان‌ها را دستی در سایت یا حسابداری وارد کند. موجودی هم برعکس: در سایت چیزی فروش می‌رود و پیج همچنان «موجوده» جواب می‌دهد. این مقاله آموزش کامل حل هر دو مشکل است — با دو ابزاری که در بخش «اتصال‌ها و API» پنل دایرکت‌فا در اختیار دارید و برای استفاده از آن‌ها لازم نیست برنامه‌نویس باشید.

وب‌هوک چیست؟ به زبان ساده

وب‌هوک یعنی «خبرم کن». به‌جای اینکه سایت شما هر چند دقیقه بپرسد «سفارش جدیدی هست؟»، یک آدرس از سایتتان به پنل می‌دهید و پنل هر بار اتفاق مهمی بیفتد، همان لحظه یک پیام به آن آدرس می‌فرستد. پیام یک متن ساختاریافته (JSON) است که همهٔ جزئیات را دارد: چه کسی، چه چیزی، چه مبلغی.

جهت حرکت مهم است: در وب‌هوک، پنل به سایت شما خبر می‌دهد. برعکسش — اینکه سایت شما از پنل چیزی بخواهد یا چیزی را تغییر دهد — کار «کلید API» است که پایین‌تر می‌رسیم.

چه خبرهایی می‌رسد؟

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

مخاطب جدید — وقتی مشتری جدیدی ثبت می‌شود؛ با کلمهٔ کلیدی، فرم، نوبت یا ثبت دستی. سفارش جدید — از گفتگو، دستیار هوشمند یا بیعانهٔ نوبت. به‌روزرسانی سفارش — تغییر وضعیت، پرداخت یا کد رهگیری. رسید پرداخت جدید — وقتی مشتری رسید کارت‌به‌کارت می‌فرستد. نوبت جدید و لغو نوبت — برای کسب‌وکارهای نوبتی.

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

اتصال به وردپرس، قدم به قدم

قدم ۱ — کد گیرنده را در سایت بگذارید. در پنل، تب «اتصال‌ها و API»، بخش «راهنمای اتصال + نمونه کد وردپرس» یک قطعه کد PHP آماده هست. آن را کپی کنید و در فایل functions.php پوستهٔ سایتتان (ترجیحاً پوستهٔ فرزند) بچسبانید. این کد یک آدرس امن در سایت شما می‌سازد و به‌عنوان نمونه، هر سفارش جدید را برای مدیر سایت ایمیل می‌کند — جای همان یک خط می‌توانید هر منطقی بنویسید: ثبت در ووکامرس، ذخیره در دیتابیس، پیام به انبار.

قدم ۲ — آدرس را در پنل ثبت کنید. بعد از ذخیرهٔ کد، آدرس گیرندهٔ شما به این شکل است: آدرس سایتتان به‌علاوهٔ wp-json/directfa/v1/hook. در پنل «افزودن آدرس وب‌هوک» را بزنید، آدرس را بگذارید و رویدادها را تیک بزنید.

قدم ۳ — کلید امضا را جای‌گذاری کنید. هر آدرس یک «کلید امضا» دارد. آن را از پنل کپی کنید و در کد PHP جای عبارت نمونه بگذارید. این کلید همان چیزی است که تضمین می‌کند پیام واقعاً از دایرکت‌فا آمده، نه از یک مزاحم — کد نمونه امضای هر پیام را با همین کلید می‌سنجد و پیام بی‌امضا را دور می‌ریزد.

قدم ۴ — ارسال تست بزنید. کنار هر آدرس یک دکمهٔ «ارسال تست» هست و نتیجه همان لحظه جلوی چشمتان می‌آید: رسید یا نرسید، با کد پاسخ. تا وقتی تست سبز نشده سراغ مرحلهٔ بعد نروید.

قدم ۵ — یک سفارش واقعی امتحان کنید. از یک اکانت دیگر برای پیج سفارش ثبت کنید و ببینید در سایت چه می‌رسد. بخش «گزارش تحویل‌ها» در همان تب، سی ارسال آخر را با جزئیات کامل نشان می‌دهد: دقیقاً چه فرستادیم و سایت شما چه جواب داد. عیب‌یابی یعنی همین صفحه.

اگر سایتتان وردپرسی نیست

وب‌هوک به زبان و سیستم خاصی وابسته نیست. هر آدرسی که بتواند یک درخواست POST با بدنهٔ JSON بگیرد، گیرندهٔ معتبری است: سایت اختصاصی، اسکریپت گوگل‌شیت، سرویس‌های واسطه، یا حتی یک ربات داخلی که سفارش را به گروه انبار می‌فرستد. هر پیام سه سربرگ مهم دارد: نام رویداد، شناسهٔ یکتای همان ارسال، و امضای دیجیتال. امضا با الگوریتم HMAC-SHA256 روی متن خام پیام ساخته می‌شود و در هر زبانی چند خط بیشتر نیست.

کلید API؛ جهت برعکس

وب‌هوک خبر می‌دهد، کلید API فرمان می‌گیرد. با یک کلید که فقط یک بار نمایش داده می‌شود، سیستم شما می‌تواند:

کل کاتالوگ را منتقل و همگام کند. با همان مسیر api/v1/products هم می‌شود محصول جدید ساخت — یعنی فروشگاه ووکامرسی می‌تواند همهٔ محصول‌هایش را یک‌جا با نام، قیمت، موجودی و عکس به پنل بفرستد؛ عکس‌ها از آدرس سایت شما برداشته و روی سرور پنل ذخیره می‌شوند تا کارت اینستاگرام هیچ‌وقت عکس شکسته نگیرد، و اگر برای هر محصول یک شناسهٔ sku بفرستید، ارسال تکراری هیچ‌وقت محصول تکراری نمی‌سازد. برای ووکامرس حتی همین را هم لازم نیست خودتان بنویسید: در همان بخش راهنمای پنل یک کد آمادهٔ «انتقال کامل کاتالوگ» هست که در functions.php می‌گذارید و صفحه‌به‌صفحه، همهٔ محصول‌ها را با تنوع‌ها و عکس‌ها منتقل می‌کند. بعد از انتقال، همگام‌سازی ادامه پیدا می‌کند: موجودی هر محصول را از سیستم خودتان آپدیت کنید تا دیگر پیش نیاید سایت فروخته باشد و ربات پیج هنوز «موجوده» بگوید. برای محصول‌های سایزدار و رنگ‌دار، موجودی روی خود تنوع ثبت می‌شود و جمع کل خودکار ساخته می‌شود. اگر هنوز موجودی را دفتری نگه می‌دارید، مدیریت موجودی فروشگاه اینستاگرامی را ببینید.

سفارش‌ها را بخواند و ببندد. مسیر api/v1/orders سفارش‌ها را با فیلتر وضعیت و تاریخ می‌دهد؛ سیستم شما می‌تواند کد رهگیری پست را ثبت کند و وضعیت را «ارسال شد» بزند — حتی با اطلاع خودکار به مشتری. راهنمای کامل خود ارسال در آموزش ارسال سفارش هست.

پیام دایرکت بفرستد. مسیر api/v1/messages به مشتری مشخصی پیام می‌فرستد — البته فقط داخل پنجرهٔ ۲۴ ساعتهٔ اینستاگرام، همان قاعده‌ای که برای پاسخ دستی هم برقرار است. این برای پیام‌های تراکنشی است، نه ارسال انبوه؛ اطلاع‌رسانی گروهی راه خودش را دارد و پیامک هم جای خودش را.

چند نکتهٔ فنی که بعداً وقتتان را نجات می‌دهد

برای هر پیج تا سه آدرس وب‌هوک می‌توانید داشته باشید — مثلاً یکی برای سایت و یکی برای حسابداری. سقف مصرف API صد و بیست درخواست در دقیقه است و برای ارسال پیام بیست عدد در دقیقه؛ برای همگام‌سازی موجودی حتی فروشگاه‌های بزرگ هم بیش از این لازم ندارند. گزارش تحویل‌ها سی روز نگه داشته می‌شود. و دسترسی به کل این بخش به پلن شما بستگی دارد — جزئیات در صفحهٔ تعرفه‌ها آمده است.

یک توصیهٔ صادقانه هم بدهکاریم: اگر سایت ندارید و همهٔ فروشتان در خود اینستاگرام است، به این بخش نیازی ندارید — پنل خودش سفارش، موجودی و فاکتور را کامل مدیریت می‌کند و مقایسهٔ فروشگاه اینستاگرامی و سایت کمکتان می‌کند تصمیم بگیرید اصلاً سایت لازم دارید یا نه. «اتصال‌ها» برای وقتی است که دو سیستم دارید و می‌خواهید یکی رفتار کنند.