سفارش ثبت شد؛ شما هنوز خبر ندارید!

بیشتر فروشگاه‌های ووکامرسی روی ایمیل حساب باز کرده‌اند. اما ایمیل ووکامرس یا در پوشه اسپم گم می‌شود، یا روی هاست اشتراکی اصلاً ارسال نمی‌شود، یا وقتی به دستتان می‌رسد که چند ساعت از سفارش گذشته است. نتیجه‌اش را همه می‌دانیم: مشتری منتظر می‌ماند، تماس می‌گیرد، و گاهی سفارشش را لغو می‌کند.

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

چرا جارچی؟

۱. راه‌اندازی در دو دقیقه، بدون یک خط کد

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

هیچ فایلی را نباید ویرایش کنید. هیچ چیزی را نباید در functions.php بچسبانید.

۲. شما تصمیم می‌گیرید چه خبری برسد

همه فروشگاه‌ها مثل هم نیستند. در زبانه «رویدادها» خودتان انتخاب می‌کنید کدام اتفاق برایتان پیام بفرستد:

• سفارش جدید — همان لحظه ثبت، حتی پیش از پرداخت

• تغییر وضعیت سفارش — با انتخاب دقیق وضعیت‌ها؛ فقط «در حال انجام»؟ فقط «تکمیل‌شده»؟ هر ترکیبی که بخواهید، از جمله وضعیت‌های سفارشی که خودتان یا افزونه‌های دیگر ساخته‌اید

• لغو و مرجوعی — تا هیچ برگشت وجهی از چشمتان دور نماند

• ثبت‌نام کاربر جدید — برای فروشگاه‌هایی که روی رشد عضویت حساب می‌کنند

گزینه‌ای هم هست که بگویید «برای هر سفارش فقط یک پیام»، تا با چند بار تغییر وضعیت، تلگرامتان شلوغ نشود.

۳. متن پیام کاملاً در اختیار شماست

قالب پیام یک ویرایشگر واقعی است، نه یک متن ثابت. بیش از ۳۰ شورت‌کد آماده دارید — از {order_id} و {customer_name} و {billing_phone} گرفته تا {order_total} و {payment_method} و {shipping_address} و {order_edit_url} — و با یک کلیک در محل نشانگر درج می‌شوند.

قالب سه بخش دارد: پیام سفارش، خط تکرارشونده محصولات، و پیام کاربر جدید. اگر یک فیلد خالی باشد (مثلاً مشتری توضیحی ننوشته)، جارچی خود آن خط را حذف می‌کند تا پیام تمیز بماند. می‌توانید از HTML سبک تلگرام هم استفاده کنید تا شماره سفارش پررنگ و شماره تماس قابل کپی باشد.

۴. روی سرعت سایت اثری ندارد!

این جایی است که بیشتر افزونه‌های مشابه لنگ می‌زنند: پیام را وسط درخواست پرداخت مشتری به تلگرام می‌فرستند و اگر شبکه کند باشد، مشتری چند ثانیه پشت صفحه سفید می‌ماند.

جارچی این کار را نمی‌کند. هنگام ثبت سفارش فقط یک شناسه در صف قرار می‌گیرد؛ ساخت متن و ارسال به تلگرام بعداً در پس‌زمینه انجام می‌شود (روی Action Scheduler ووکامرس، و اگر نبود روی کرون وردپرس). صفحه تسویه‌حساب دقیقاً به همان سرعتی می‌ماند که بدون افزونه بود. فایل‌های CSS و JS هم فقط در همان یک صفحه تنظیمات بارگذاری می‌شوند؛ روی سایت عمومی شما حتی یک بایت اضافه لود نمی‌شود.

۵. پیام گم نمی‌شود

اگر اینترنت سرور قطع باشد یا تلگرام موقتاً پاسخ ندهد، جارچی تسلیم نمی‌شود: با تأخیر تصاعدی دوباره تلاش می‌کند. اگر تلگرام محدودیت نرخ اعمال کند، به زمانی که خودش اعلام می‌کند احترام می‌گذارد. و اگر خطا دائمی باشد (توکن اشتباه یا ربات بلاک‌شده)، بی‌خود تلاش نمی‌کند و آن را در گزارش ثبت می‌کند تا بدانید مشکل از کجاست.

سفارش‌های پرآیتم هم مشکلی ندارند: پیام‌های بلندتر از سقف ۴۰۹۶ کاراکتری تلگرام به‌صورت هوشمند و روی مرز خطوط تکه می‌شوند، نه اینکه ارسال نشوند.

۶. گزارش ارسال، برای وقتی که پیام نرسید

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

۷. سازگار با ووکامرس امروز

جارچی رسماً سازگاری خود را با HPOS (جدول‌های سفارش پرسرعت ووکامرس) و بلوک‌های سبد خرید و تسویه‌حساب اعلام می‌کند. روی مالتی‌سایت هم به‌درستی نصب، اجرا و حذف می‌شود. اگر ووکامرس غیرفعال باشد هیچ خطایی نمی‌دهد و فقط اعلان سفارش را موقتاً متوقف می‌کند.

۸. دوزبانه و کاملاً فارسی

تمام رابط کاربری با استاندارد i18n وردپرس نوشته شده و فایل ترجمه فارسی کامل همراه افزونه است. پنل تنظیمات راست‌چین و مرتب است و اگر سایتتان انگلیسی باشد، افزونه هم انگلیسی می‌شود.

برای چه کسانی ساخته شده؟

• فروشگاه‌های تک‌نفره که مدیر باید همان لحظه از سفارش باخبر شود و بسته را آماده کند.

• تیم‌های چندنفره که یک گروه تلگرامی مشترک دارند؛ کافی است ربات را به گروه اضافه کنید تا همه هم‌زمان خبردار شوند.

• فروشگاه‌های پرترافیک که نمی‌خواهند سرعت صفحه پرداختشان قربانی اعلان شود.

• توسعه‌دهندگان که با فیلترهای داخلی افزونه (jarchi_should_notify، jarchi_order_message، jarchi_order_placeholders و…) رفتار پیام را برای مشتری خود شخصی‌سازی می‌کنند.

امکانات در یک نگاه

راه‌اندازی در سه گام

گام اول — ساخت ربات. در تلگرام به @BotFather پیام بدهید، دستور /newbot را بفرستید و یک نام و شناسه برای ربات انتخاب کنید. در پایان یک توکن به شما می‌دهد.

گام دوم — اتصال. توکن را در زبانه «اتصال» جارچی بگذارید و «تست اتصال» را بزنید. سپس در تلگرام به ربات خودتان یک پیام بفرستید (یا اگر گروه دارید، ربات را به گروه اضافه کنید) و در پنل «تشخیص خودکار» را بزنید تا شناسه چت پیدا و اضافه شود.

گام سوم — انتخاب رویدادها. در زبانه «رویدادها» مشخص کنید چه اتفاق‌هایی برایتان پیام بفرستد. تمام. اگر خواستید متن پیام را هم در زبانه «قالب پیام» به سلیقه خودتان تغییر بدهید.

راهنمای کامل همراه با رفع مشکلات رایج، داخل خود افزونه در زبانه «راهنما» موجود است.

سوالات متداول شما درباره افزونه جارچی

آیا برای استفاده به سرور خارج یا فیلترشکن نیاز دارم؟

سرور شما باید بتواند به api.telegram.org درخواست بزند. بیشتر هاست‌های ایرانی این دسترسی را باز دارند؛ اگر باز نبود، تست اتصال دقیقاً همین را به شما اطلاع می‌دهد تا با پشتیبانی هاست هماهنگ کنید.

می‌توانم پیام‌ها را به کانال بفرستم؟

بله. ربات را به کانال اضافه کنید و به آن دسترسی ارسال پیام بدهید، سپس شناسه کانال یا آدرس @channelname را در فهرست گیرنده‌ها وارد کنید.

چند نفر می‌توانند پیام بگیرند؟

محدودیتی ندارد. هر تعداد شناسه چت را می‌توانید در فهرست وارد کنید؛ هر پیام برای همه ارسال می‌شود.

اگر یک بار پیام ارسال نشود چه می‌شود؟

جارچی خودکار دوباره تلاش می‌کند (تعداد تلاش‌ها را خودتان تنظیم می‌کنید) و نتیجه هر تلاش در گزارش ارسال ثبت می‌شود.

آیا روی سرعت سایت اثر می‌گذارد؟

خیر. هیچ کاری داخل درخواست مشتری انجام نمی‌شود و هیچ اسکریپتی روی صفحات عمومی سایت بارگذاری نمی‌گردد.

با قالب و افزونه‌های دیگر تداخل دارد؟

جارچی از هوک‌های رسمی ووکامرس استفاده می‌کند و هیچ خروجی‌ای در فرانت‌اند تولید نمی‌کند، بنابراین احتمال تداخل بسیار پایین است.

بعد از حذف افزونه، داده‌ها می‌مانند؟

خیر. هنگام حذف، تمام تنظیمات، جدول گزارش و متادیتای سفارش‌ها به‌طور کامل پاک می‌شوند و دیتابیس شما تمیز می‌ماند.

مشخصات فنی

• حداقل نسخه وردپرس: ۵.۶

• حداقل نسخه PHP: ۷.۲

• حداقل نسخه ووکامرس: ۵.۰ (برای اعلان سفارش)

• سازگاری: HPOS، بلوک‌های سبد و تسویه‌حساب، مالتی‌سایت، راست‌چین

• زبان‌ها: فارسی، انگلیسی (فایل .pot برای ترجمه به زبان‌های دیگر همراه است)

• نسخه فعلی: ۱.۰.۰

• توسعه‌دهنده: تیم جریان

تغییرات نسخه‌ها

نسخه ۱.۰.۰ — انتشار اولیه پنل تنظیمات شش‌زبانه، انتخاب رویدادها، قالب پیام با شورت‌کد، صف ارسال پس‌زمینه با تلاش مجدد، گزارش ارسال، تشخیص خودکار شناسه چت، پشتیبانی HPOS و مالتی‌سایت، ترجمه کامل فارسی.

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

جارچی، طراحی و توسعه توسط تیم جریان دیجیتال.