به محتوای اصلی

پیگیری سفارش ووکامرس با هوش مصنوعی؛ وضعیت، لغو و مرجوعی

چت باتی که وضعیت سفارش را از REST API ووکامرس می‌خواند و درخواست لغو یا مرجوعی را با تأیید مشتری ثبت می‌کند؛ با چک موبایل خریدار و کد کامل، بی‌افزونه.

عاطفه امیری۱۰ دقیقه مطالعهبه‌روزرسانی
در این مطلب

پیگیری سفارش ووکامرس با هوش مصنوعی یعنی چت باتی روی خود فروشگاه که وقتی مشتری می‌پرسد «سفارشم کجاست؟»، شماره‌ی سفارش و موبایلش را می‌گیرد، وضعیت واقعی را از ووکامرس می‌خواند و جواب می‌دهد. و اگر مشتری گفت «می‌خواهم لغوش کنم» یا «مرجوعش می‌کنم»، همان چت بات بعد از تأیید خود مشتری، درخواستش را برای همکاران شما ثبت می‌کند. در فیکارو این‌ها چهار تکه است: دو تابع کوچک جاوااسکریپت، یک ایجنت که آن‌ها را صدا می‌زند، و ویجت سایت که با یک خط اسکریپت روی فروشگاه می‌نشیند. افزونه‌ی پیگیری سفارش لازم نیست و ووکامرس دست نمی‌خورد. این راهنما هر چهار تکه را با کد کامل نشان می‌دهد.

چت بات پیگیری سفارش ووکامرس دقیقاً چه کار می‌کند؟

مشتری در چت سایت می‌نویسد «سفارشم کجاست؟». ایجنت شماره‌ی سفارش و موبایل را می‌پرسد و تابع order_status را با همین دو مقدار صدا می‌زند. تابع سفارش را از ووکامرس می‌خواند، اگر موبایل با موبایل صورت‌حساب نخواند همان جواب «پیدا نشد» را می‌دهد، و فقط چند فیلد بی‌خطر را برمی‌گرداند: وضعیت، چند روز پیش ثبت شده، اقلام، مبلغ و روش ارسال.

اگر مشتری لغو، مرجوعی یا تغییر نشانی بخواهد، ایجنت تابع دوم، order_request، را آماده می‌کند و کارتی با خلاصه‌ی کار و دو دکمه‌ی «تأیید» و «لغو» جلوی مشتری می‌آید. با «تأیید»، درخواست در جدول پروژه‌ی فیکارو ثبت می‌شود و همکار شما آن را در ووکامرس انجام می‌دهد.

راهوضعیت از کجا می‌آیددرخواست لغو و مرجوعیروی سایت چه نصب می‌شود
افزونه‌ی پیگیری سفارشدیتابیس وردپرسفرم تماس جدایک افزونه
پنل پیامک یا ربات تلگرام دست‌سازهر چه برنامه‌نویس بنویسدبه عهده‌ی کد شماسرور جدا برای ربات
ایجنت فیکارو + دو تابعREST API ووکامرس، زندهاز همان چت، با تأیید مشتری و چک موبایلیک خط اسکریپت ویجت

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

REST API ووکامرس را چطور با کلید فقط‌خواندنی آماده کنیم؟

در پیشخوان وردپرس به ووکامرس ← پیکربندی ← پیشرفته ← REST API بروید و «افزودن کلید» را بزنید. سطح دسترسی را خواندن بگذارید. ووکامرس یک consumer key که با ck_ شروع می‌شود و یک consumer secret که با cs_ شروع می‌شود می‌دهد. secret فقط همین یک بار نشان داده می‌شود.

ووکامرس روی HTTPS احراز هویت پایه (Basic) می‌پذیرد. مقدار سرآیندش را یک بار در ترمینال خودتان بسازید، نه در سایت‌های آنلاین تبدیل:

printf '%s' 'ck_xxxx:cs_xxxx' | base64

خروجی را با پیشوند Basic و یک فاصله، مثلاً Basic Y2tfeHh4eDpjc194eHh4، در فیکارو به‌عنوان secret پروژه با نام WC_AUTH ذخیره کنید. secretها را از دکمه‌ی «secrets» بالای فهرست فانکشن‌ها تعریف می‌کنید. مقدار بعد از ذخیره دیگر نشان داده نمی‌شود و در لاگ هم نمی‌آید.

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

تابع وضعیت سفارش ووکامرس چه شکلی است؟

توابع داخل یک پروژه‌ی فیکارو زندگی می‌کنند. اگر پروژه‌ای ندارید، یک پروژه‌ی خالی بسازید. در صفحه‌ی فانکشن‌ها، فانکشنی با نام order_status بسازید، سطح دسترسی را روی پیش‌فرض «فقط کلید API» بگذارید و این کد را بنویسید. آدرس SHOP را با دامنه‌ی فروشگاه خودتان عوض کنید:

const SHOP = "https://shop.example.ir";

const STATUS = {
  pending: "در انتظار پرداخت",
  processing: "در حال آماده‌سازی",
  "on-hold": "در انتظار بررسی",
  completed: "تکمیل شده",
  cancelled: "لغو شده",
  refunded: "مسترد شده",
  failed: "پرداخت ناموفق",
};

function digits(s) {
  return String(s || "")
    .replace(/[۰-۹]/g, (d) => "۰۱۲۳۴۵۶۷۸۹".indexOf(d))
    .replace(/\D/g, "")
    .slice(-10);
}

const id = Number(ctx.input.order_id);
const phone = digits(ctx.input.phone);
if (!(id > 0) || phone.length !== 10) {
  ctx.respond(400, {
    found: false,
    reason: "شماره سفارش و موبایل لازم است",
  });
}

const url = SHOP + "/wp-json/wc/v3/orders/" + id;
let res = null;
try {
  res = ctx.http.get(url, {
    headers: { Authorization: ctx.secrets.WC_AUTH },
  });
} catch (e) {
  res = null;
}

if (!res || (!res.ok && res.status !== 404)) {
  ctx.respond(502, {
    found: false,
    reason: "فروشگاه الان جواب نمی‌دهد",
  });
}

const order = res.ok ? res.json : null;
const billing = (order && order.billing) || {};
if (!order || digits(billing.phone) !== phone) {
  ctx.respond(404, {
    found: false,
    reason: "سفارشی با این مشخصات پیدا نشد",
  });
}

const created = Date.parse(order.date_created_gmt + "Z");
const ship = (order.shipping_lines || [])[0] || {};

ctx.respond({
  found: true,
  order_id: order.id,
  status: STATUS[order.status] || order.status,
  days_ago: Math.floor((Date.now() - created) / 86400000),
  items: (order.line_items || []).map(
    (i) => i.name + " × " + i.quantity,
  ),
  total: order.total + " " + order.currency,
  shipping: ship.method_title || "",
});

چند تصمیم در این کد عمدی است:

  • موبایل اشتباه و سفارش ناموجود یک جواب دارند. اگر جواب‌ها فرق می‌کرد، هر کسی می‌توانست با حدس زدن شماره‌ها بفهمد کدام سفارش وجود دارد.
  • نشانی، ایمیل و نام خریدار برنمی‌گردد. هر چه تابع برگرداند به مدل می‌رسد، پس فقط چیزی را برگردانید که حاضرید به هر پرسنده‌ای که موبایل درست را دارد نشان بدهید.
  • ارقام فارسی هم پذیرفته می‌شود و فقط ده رقم آخر موبایل مقایسه می‌شود، پس ۰۹۱۲… و +98912… یکی حساب می‌شوند.
  • تاریخ به‌صورت «چند روز پیش» برمی‌گردد، نه تاریخ میلادی، تا ایجنت مجبور نشود تقویم تبدیل کند.

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

اگر ووکامرس با کلید درست هم ۴۰۱ برمی‌گرداند، احتمالاً هاست شما سرآیند Authorization را پیش از رسیدن به وردپرس حذف می‌کند. راه رسمی ووکامرس برای این حالت فرستادن consumer_key و consumer_secret در query string است، فقط روی HTTPS. آن‌وقت دو secret جدا بسازید و آدرس را در کد از روی آن‌ها بسازید.

درخواست لغو و مرجوعی را چطور از همان چت ثبت کنیم؟

ایجنت فیکارو در اجرای تابع هرگز ctx.http.post نمی‌فرستد، پس نمی‌تواند سفارش را در ووکامرس عوض کند. ولی کار واقعی را هم انجام می‌دهد: درخواست مشتری را با شماره سفارش و موبایل تأییدشده در دیتابیس پروژه‌ی خودتان ثبت می‌کند، تا همکارتان به‌جای پیام پراکنده در دایرکت، یک فهرست مرتب داشته باشد.

در همان پروژه جدولی با نام order_request بسازید با چهار فیلد: order_id (عدد، الزامی)، phone (تلفن)، kind (متن) و note (متن). بعد فانکشن دوم را با نام order_request و همان سطح «فقط کلید API» بسازید:

const SHOP = "https://shop.example.ir";
const KINDS = ["لغو", "مرجوعی", "تغییر نشانی"];

function digits(s) {
  return String(s || "")
    .replace(/[۰-۹]/g, (d) => "۰۱۲۳۴۵۶۷۸۹".indexOf(d))
    .replace(/\D/g, "")
    .slice(-10);
}

const id = Number(ctx.input.order_id);
const phone = digits(ctx.input.phone);
const kind = String(ctx.input.kind || "");
const note = String(ctx.input.note || "").trim().slice(0, 300);
if (!(id > 0) || phone.length !== 10 || KINDS.indexOf(kind) < 0) {
  ctx.reject("شماره سفارش، موبایل و نوع درخواست لازم است");
}

let res = null;
try {
  res = ctx.http.get(SHOP + "/wp-json/wc/v3/orders/" + id, {
    headers: { Authorization: ctx.secrets.WC_AUTH },
  });
} catch (e) {
  res = null;
}
if (!res || (!res.ok && res.status !== 404)) {
  ctx.reject("فروشگاه الان جواب نمی‌دهد؛ کمی بعد دوباره بپرسید");
}
const order = res.ok ? res.json : null;
if (!order || digits((order.billing || {}).phone) !== phone) {
  ctx.reject("سفارشی با این شماره و موبایل پیدا نشد");
}

const dup = ctx.db.admin.list("order_request", {
  filter: { order_id: id, kind: kind },
  limit: 1,
});
if (!dup.length) {
  ctx.db.admin.create("order_request", {
    order_id: id,
    phone: "+98" + phone,
    kind: kind,
    note: note,
  });
}

ctx.respond(201, {
  message: "درخواست «" + kind + "» برای سفارش " + id +
    " ثبت شد. همکاران ما با همین موبایل تماس می‌گیرند.",
});

این تابع هم چیزی را باور نمی‌کند: پیش از نوشتن، سفارش را دوباره از ووکامرس می‌خواند و موبایل را می‌سنجد، پس کسی که موبایل خریدار را ندارد برای سفارش دیگران درخواست ثبت نمی‌کند. درخواست تکراری برای همان سفارش و همان نوع ردیف دوم نمی‌سازد. message عمداً یک جمله‌ی کامل است: بعد از «تأیید»، مشتری عین همین جمله را بعد از «انجام شد.» می‌بیند، و متن هر ctx.reject را با پیشوند «انجام نشد:». ctx.db.admin یعنی «از طرف فروشگاه می‌نویسم»، چون پرسنده‌ی ایجنت کاربر پروژه‌ی شما نیست و ctx.user در این اجرا خالی است.

ایجنت را چطور به دو تابع وصل کنیم و روی فروشگاه بگذاریم؟

در تب «هوش مصنوعی (AI)» پنل یک ایجنت بسازید. قالب «پشتیبان فروشگاه» نقطه‌ی شروع خوبی است. در صفحه‌ی «توابع» همان ایجنت، هر دو تابع را از پروژه‌شان انتخاب کنید. ایجنت فقط از روی توضیح هر تابع تصمیم می‌گیرد کی صدایش بزند، و فقط پارامترهایی را می‌فرستد که این‌جا اعلام می‌کنید:

  • order_status: توضیح «وضعیت یک سفارش را با شماره سفارش و موبایل خریدار برمی‌گرداند. وقتی مشتری می‌پرسد سفارشش کجاست صدایش بزن.» پارامتر order_id از نوع عدد و الزامی با توضیح «شماره سفارش»، و phone از نوع متن و الزامی با توضیح «موبایل خریدار». هر دو کلید نوشتن خاموش بمانند.
  • order_request: توضیح «برای سفارشی که مشتری می‌خواهد لغو یا مرجوع کند یا نشانی‌اش را عوض کند، درخواست ثبت می‌کند.» همان دو پارامتر، به‌علاوه‌ی kind از نوع گزینه‌ای با سه گزینه‌ی «لغو»، «مرجوعی» و «تغییر نشانی» و توضیح «نوع درخواست»، و note از نوع متن و اختیاری با توضیح «توضیح مشتری». برای این یکی «اجازه‌ی نوشتن» و «پیش از انجام از کاربر تأیید بگیر» را روشن کنید.

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

حالا ویجت: در صفحه‌ی «ویجت سایت» ایجنت، دامنه‌ی فروشگاه را به دامنه‌های مجاز اضافه کنید، ویجت را روشن کنید و خطی را که «کپی snippet» می‌دهد پیش از </body> بگذارید. در وردپرس معمولاً جایش بخش کد سفارشی فوتر قالب است:

<script
  src="https://api.fikaro.ir/ai/widget/v1.js"
  data-agent="{botId}"
  data-key="apck_wgt_..."
  async
></script>

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

گفت‌وگوی مشتری با چت بات چه شکلی می‌شود؟

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

  • مشتری: سلام، سفارشم کجاست؟
  • چت بات: برای پیدا کردن سفارش، شماره‌ی سفارش و موبایلی را که با آن خرید کرده‌اید بفرستید.
  • مشتری: ۴۸۱۲، موبایلم ۰۹۱۲۳۴۵۶۷۸۹
  • چت بات: سفارش ۴۸۱۲ «در حال آماده‌سازی» است و سه روز پیش ثبت شده. شامل یک کتونی رانینگ است و با پست پیشتاز ارسال می‌شود.
  • مشتری: پشیمون شدم، می‌خوام لغوش کنم.
  • چت بات: برای انجام این کار تأیید شما لازم است: order_request — شماره سفارش: 4812، موبایل خریدار: ۰۹۱۲۳۴۵۶۷۸۹، نوع درخواست: لغو
  • مشتری: دکمه‌ی «تأیید» زیر همین کارت را می‌زند.
  • چت بات: انجام شد. درخواست «لغو» برای سفارش 4812 ثبت شد. همکاران ما با همین موبایل تماس می‌گیرند.

پیام پنجم فقط وقتی در ادامه‌ی قبلی‌ها فهمیده می‌شود که پیام‌های قبلی در فیلد history همراه پرسش برسند؛ ویجت این کار را خودش می‌کند. اگر رابط چت را خودتان با API ساخته‌اید، history را خودتان بفرستید و pendingAction را مثل کارت بالا نشان بدهید. کد آن در راهنمای ساخت چت بات هوش مصنوعی آمده است. در گزارش سؤال‌ها هم برای هر پرسش می‌بینید کدام تابع با چه آرگومانی صدا زده شد و چه برگرداند.

مرزهای امنیتی این چت بات کجاست؟

  • سفارش در ووکامرس هرگز عوض نمی‌شود. در اجرای ایجنت هر ctx.http.post همیشه رد می‌شود، حتی برای تابعی که اجازه‌ی نوشتن دارد، و ctx.http جز get و post متدی ندارد. کلید فقط‌خواندنی ووکامرس لایه‌ی دوم همین مرز است. تابع نوشتنی فقط در دیتابیس پروژه‌ی خودش می‌نویسد.
  • سقف نوشتن برای هر بازدیدکننده. از راه ویجت هر نشست حداکثر ۳ و هر IP حداکثر ۱۰ کار نوشتنی در ساعت دارد، و در هر پرسش حداکثر یک کار نوشتنی انجام می‌شود. توکن تأیید یک‌بارمصرف است و پنج دقیقه عمر دارد.
  • prompt injection با if بسته می‌شود، نه با دستورالعمل. پرسنده می‌تواند ایجنت را وادار کند تابع را با آرگومان دیگری صدا بزند. برای همین چک موبایل داخل کد هر دو تابع است: مدل را می‌شود فریب داد، if را نه.
  • فروشگاه باید از اینترنت در دسترس باشد. آدرس داخلی مثل localhost یا شبکه‌ی خصوصی رد می‌شود. هر درخواست بیرونی ۵ ثانیه و کل تابع ۱۰ ثانیه وقت دارد. اگر فایروال یا ضدبات هاستتان درخواست‌های سروری را می‌بندد، برای مسیر /wp-json/wc/ استثنا بگذارید.

اگر order_status خطا بدهد یا وقتش تمام شود، ایجنت answered: false با یک جمله‌ی ثابت برمی‌گرداند و جزئیات فقط در گزارش اجرای تابع می‌آید.

هزینه‌ی پیگیری سفارش با هوش مصنوعی چقدر است؟

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

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

سوالات متداول

برای پیگیری سفارش ووکامرس با چت بات باید افزونه نصب کنم؟
افزونه‌ی پیگیری سفارش لازم نیست. تابع فیکارو از بیرون، از راه REST API خود ووکامرس، سفارش را می‌خواند. یک کلید REST API با سطح خواندن در تنظیمات پیشرفته‌ی ووکامرس می‌سازید و یک خط اسکریپت ویجت را در فوتر سایت می‌گذارید.
کسی می‌تواند وضعیت سفارش دیگران را از چت بات بپرسد؟
تابع این راهنما فقط وقتی جواب می‌دهد که موبایل پرسنده با موبایل صورت‌حساب همان سفارش بخواند، و نشانی و نام خریدار را اصلاً برنمی‌گرداند. این چک در کد تابع است، پس با فریب دادن ایجنت دور زده نمی‌شود. تابع ثبت درخواست هم همین چک را پیش از نوشتن دوباره انجام می‌دهد.
چت بات می‌تواند سفارش را لغو کند؟
درخواست لغو، مرجوعی یا تغییر نشانی را بعد از تأیید خود مشتری در جدول پروژه‌ی فیکارو ثبت می‌کند، و همکار شما آن را در ووکامرس انجام می‌دهد. خود سفارش از چت عوض نمی‌شود: در تابعی که ایجنت صدا می‌زند هر درخواست POST همیشه رد می‌شود و کلید ووکامرس هم فقط خواندن است.
اگر مشتری بی‌آنکه بخواهد دکمه‌ی تأیید را نزند چه می‌شود؟
هیچ چیز ثبت نمی‌شود. تابع نوشتنی‌ای که تأیید می‌خواهد تا مشتری «تأیید» را نزند اجرا نمی‌شود، و توکن تأیید پنج دقیقه بعد خودش باطل می‌شود. «لغو» هم کارت را می‌بندد و چیزی به سرور نمی‌فرستد.
کلید ووکامرس را کجا بگذارم؟
در secretهای پروژه‌ی فیکارو، که فقط کد تابع آن را می‌بیند و در لاگ ثبت نمی‌شود. هرگز در دستورالعمل یا دانسته‌های ایجنت نگذارید، چون آن متن ممکن است با یک پرسش زیرکانه بیرون کشیده شود.

مطالب مرتبط