تخطي إلى المحتوى
دليل

أتمتة شغل متجرك بـ n8n

بقلم فايز الشامينُشر: حُدّث: قراءة لمدة 10 دقائق
الخلاصة

ابدأ بثلاث لحظات: طلب جديد، فاتورة مرقّمة، إشعار تيليغرام. يرسل المتجر webhook إلى n8n بعد حفظ الطلب؛ تحفظ الفاتورة ثم ترسل الرسالة. تأكيد المحفظة يبقى في البوابة، وn8n يبلّغ عند حالة «مدفوع» فقط.

متجر ألبسة بحلب كانت الطلبات توصله من الموقع ومن رسائل إنستغرام مع بعض. كل طلب جديد يعني رسالة على واتساب، وفاتورة تتكتب يدويًا، وصاحب المحل يفتح تيليغرام ليسأل المحاسب إذا شاف الطلب. يوم فيه بضعة طلبات يمشي الحال. يوم مزدحم، الرسالة تضيع، والفاتورة تتأخر، وزبون يدفع وما أحد يخبر المستودع أن الشحنة جاهزة. أتمتة شغل متجرك بـ n8n تعالج هذا المسار تحديدًا: طلب يدخل النظام، فاتورة تُرقم وتُحفظ، وإشعار يصل على تيليغرام من غير ما ينسخ أحد البيانات من شاشة إلى شاشة.

n8n أداة لأتمتة سير العمل. تربط خدمة بخدمة عبر خطوات: يصل طلب عبر webhook، يتحول إلى فاتورة، ثم تُرسل رسالة. يمكنك تشغيلها على سيرفرك أو على سحابة n8n. أنا أفضل تشغيلها على VPS بجانب المتجر، لأن بيانات الطلبات تبقى عندك، وربط الدفع بعد ذلك يصير على الشبكة نفسها.

متى تستحق الأتمتة

إذا كان صاحب المتجر يفتح التطبيق بعد كل طلب ليكتب الفاتورة ويرسل رسالة، الأتمتة تفيد حتى قبل أن تصل الطلبات إلى عشرات في اليوم. التعب ليس من الطلب الواحد، التعب من تكرار الخطوات نفسها ومن الخطأ الذي يحدث عندما تتداخل طلبات متشابهة المبلغ.

مطعم بدمشق يستقبل طلبات التوصيل من موقعه ويقع في المشكلة نفسها: الطلب يظهر في اللوحة، والطاهي لا يعلم إلا إذا صرخ أحد في المطبخ أو أرسل رسالة متأخرة. إشعار تيليغرام لمجموعة المطبخ، فور إنشاء الطلب، يختصر هذه الحلقة. كتبت عن مسار الطلب من الموقع نفسه في طلب المطاعم أونلاين مقابل تطبيقات التوصيل.

لا تبدأ بأتمتة كل شيء دفعة واحدة. ابدأ بثلاث لحظات تتكرر كل يوم: طلب جديد، فاتورة، وإشعار. تأكيد الدفع مسار مستقل، وله قواعد مطابقة لا يجوز أن تُترك لتخمين المبلغ داخل n8n. إذا كان التأكيد عندك ما زال بلقطة شاشة، اقرأ أولًا كيف تؤتمت تأكيد الدفع للمحافظ السورية، ثم اربط نتيجة التأكيد كخطوة لاحقة في نفس سير العمل.

ما الذي تحتاجه قبل أن تفتح n8n

تحتاج مصدرًا للطلب يقدر يرسل webhook عند الإنشاء. في ووكومرس هذا جاهز من الإعدادات. في موقع مخصص تضيف طلب HTTP بعد حفظ الطلب في قاعدة البيانات. من غير هذا المصدر، n8n لن يعلم أن طلبًا وُلد.

وتحتاج بوت تيليغرام. تفتح BotFather، تنشئ بوتًا، وتأخذ التوكن. ثم ترسل للبوت أي رسالة من الحساب الذي تريد أن تصله الإشعارات (أو تضيف البوت لمجموعة المطبخ/المحاسبة). بعد الرسالة، تجلب معرّف المحادثة:

``bash # استبدل BOT_TOKEN بتوكن البوت، بعد أن ترسل له رسالة واحدة على الأقل curl -sS "https://api.telegram.org/bot${BOT_TOKEN}/getUpdates" ``

في الرد ابحث عن chat: { "id": ... }. هذا الرقم هو CHAT_ID. للمجموعة يكون غالبًا سالبًا. احفظ التوكن ومعرّف المحادثة خارج ملف سير العمل، في أوراق اعتماد n8n، لا داخل العقد كنص ظاهر.

وأخيرًا تحتاج نسخة n8n تعمل على عنوان يصل إليه متجرك. إذا كان المتجر على استضافة مشتركة وn8n على VPS، يجب أن يكون عنوان webhook علنيًا وHTTPS. كتبت خطوات النشر بـ Docker وNginx وSSL في نشر مشروع Node.js على VPS. المسار نفسه يصلح لتشغيل n8n بحاوية Docker.

لا تضع في المسار الأول توليد فواتير ضريبية معقدة أو ربط محاسبة كامل. رقم فاتورة ثابت، ومبلغ، واسم الزبون، ورابط الطلب في اللوحة: هذا يكفي ليبدأ المحاسب يومه من تيليغرام لا من تفقد اللوحة كل عشر دقائق.

تدفق العمل من الطلب حتى الإشعار

الزبون يتمم الطلب في المتجر. النظام يحفظ رقم الطلب والمبلغ والحالة (بانتظار الدفع مثلًا) ثم يستدعي عنوان webhook في n8n. العقدة الأولى تستقبل الجسم كما هو. عقدة كود تشتق رقم الفاتورة ونص الرسالة. تُحفظ الفاتورة (في جدول عندك، أو في Google Sheet إذا كان هذا ما يستخدمه المحاسب اليوم). بعدها تُرسل رسالة تيليغرام إلى صاحب المتجر أو إلى مجموعة العمل.

ترتيب الحفظ قبل الإرسال مقصود. إذا أُرسلت الرسالة وفشل حفظ الفاتورة، يصلك إشعار لا يقابله سجل. إذا حُفظت الفاتورة وفشل تيليغرام، تعيد n8n محاولة الإرسال، والفاتورة لا تُنشأ مرتين إذا جعلت رقمها مرتبطًا برقم الطلب بقيد فريد.

في متجر الألبسة المثال يكون النص تقريبًا هكذا: فاتورة INV-20261110-01240، مبلغ 85,000 ل.س، الحالة بانتظار الدفع، واسم الزبون كما جاء في الطلب. لا حاجة لتنسيق مبهر. الحاجة أن تصل الرسالة مرة واحدة، وأن يفتح الرابط الطلب الصحيح.

أتمتة شغل متجرك بـ n8n خطوة بخطوة

ثبّت n8n وأنشئ سير عمل جديدًا. العقدة الأولى Webhook، طريقة POST، ومسار واضح مثل new-order. بعد حفظ السير وتفعيله، يعطيك n8n عنوانًا عامًا. هذا العنوان هو ما تسجّله في المتجر.

في ووكومرس: الإعدادات، ثم Advanced، ثم Webhooks. أنشئ webhook على حدث Order created، واضبط السر إن أردت التحقق من التوقيع لاحقًا، والصق عنوان n8n. أرسل طلبًا تجريبيًا وتأكد أن عقدة Webhook استقبلت الحقول: id، وtotal، وstatus، وbilling، وline_items. أسماء هذه الحقول هي ما يرسله ووكومرس فعلًا في جسم الطلب. إذا ضبطت سرًا في ووكومرس، تحقق منه في n8n (عقدة أو فحص للرأس) قبل توليد الفاتورة، حتى لا يستقبل المسار طلبات من عنوان عرفه أحد من خارج المتجر.

إذا كان المتجر مخصصًا، أرسل جسمًا مشابهًا من السيرفر بعد إنشاء الطلب:

```javascript // يُستدعى بعد حفظ الطلب في قاعدة بياناتك، لا قبلها export async function notifyN8nNewOrder(order) { const url = process.env.N8N_NEW_ORDER_WEBHOOK_URL; const secret = process.env.N8N_WEBHOOK_SECRET;

const body = JSON.stringify({ id: order.id, total: order.amount, status: order.status, customerName: order.customerName, currency: "SYP", createdAt: order.createdAt, });

const response = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json", "X-Webhook-Secret": secret, }, body, });

if (!response.ok) { throw new Error(n8n webhook failed: ${response.status}); } } ```

في n8n، أضف عقدة Code بعد Webhook. هذا الكود يشتق رقم فاتورة حتميًا من التاريخ ورقم الطلب، حتى لو أُعيد إرسال الـwebhook لا يتولد رقم جديد مختلف:

```javascript // عقدة Code في n8n (وضع "Run Once for All Items"). // جسم ووكومرس يصل عادة في جذر العنصر. بعض إعدادات Webhook تضعه في body. const order = $input.first().json.body ?? $input.first().json; const orderId = order.id; if (!orderId) { throw new Error("missing order id"); }

const total = Number(order.total ?? order.amount); if (!Number.isFinite(total)) { throw new Error("missing amount"); }

const day = new Date().toISOString().slice(0, 10).replaceAll("-", ""); const invoiceNumber = INV-${day}-${String(orderId).padStart(5, "0")}; const customerName = order.billing?.first_name ? ${order.billing.first_name} ${order.billing.last_name || ""}.trim() : (order.customerName || "زبون");

const telegramText = [ طلب جديد ${invoiceNumber}, رقم الطلب: ${orderId}, المبلغ: ${total} ل.س, الزبون: ${customerName}, الحالة: ${order.status || "بانتظار الدفع"}, ].join("\n");

return [{ json: { orderId, invoiceNumber, amount: total, customerName, telegramText, }, }]; ```

بعدها أضف خطوة حفظ. إن كان عندك جدول فواتير، استدعِ واجهتك بـ HTTP Request واجعل invoiceNumber أو orderId قيدًا فريدًا. إن كان المحاسب يعمل اليوم على جدول، عقدة Google Sheets تكفي للبداية، بشرط أن تمنع صفًا ثانيًا لنفس رقم الطلب.

الخطوة الأخيرة عقدة Telegram برسالة telegramText. جرب السير بطلب حقيقي من متجر تجريبي، لا ببيانات تُلصق في العقدة مرة واحدة ثم تُنسى. راقب إن وصلت رسالة واحدة فقط عند إعادة حفظ الطلب نفسه.

إذا أردت تجربة إرسال تيليغرام خارج n8n، للتأكد من التوكن والمحادثة قبل ربط العقدة:

``bash curl -sS -X POST "https://api.telegram.org/bot${BOT_TOKEN}/sendMessage" \ -H "Content-Type: application/json" \ --data-binary @- <<'JSON' { "chat_id": "YOUR_CHAT_ID", "text": "طلب جديد INV-20261110-01240\nالمبلغ: 85000 ل.س\nالحالة: بانتظار الدفع" } JSON ``

استبدل YOUR_CHAT_ID بالرقم الذي أخذته من getUpdates. إذا عاد ok: true فالبوابة تصل، والمشكلة بعد ذلك تكون في ربط العقدة لا في التوكن.

إذا كان الدفع بسيريتل كاش أو شام كاش

الإشعار بطلب جديد لا يعني أن المال وصل. في المتاجر السورية الزبون يحوّل من المحفظة بعد إنشاء الطلب، ثم يدخل رقم العملية في الموقع أو يرسله في محادثة. المطابقة تتم برقم العملية ثم التحقق من المبلغ، لا بتخمين طلب مفتوح له نفس المجموع. كتبت التدفق كاملًا في كيف تربط سيريتل كاش بمتجرك الإلكتروني. إذا كان متجرك على ووكومرس، المقارنة بين التأكيد اليدوي والتلقائي في سيريتل كاش على ووكومرس: يدوي أم تلقائي؟.

ما يفعله n8n هنا خطوة لاحقة، لا بديل عن البوابة. بعد أن يعلّم نظامك الطلب مدفوعًا، يرسل webhook ثانيًا إلى سير عمل اسمه مثل order-paid. هذا السير يحدّث سجل الفاتورة إلى «مدفوعة»، ويرسل إشعار تيليغرام مختلفًا: «دُفع الطلب 1240، الفاتورة INV-20261110-01240، 85,000 ل.س». المستودع يتحرك بناء على رسالة الدفع، لا على رسالة الإنشاء.

لا تجعل n8n يختار طلبًا مفتوحًا بالمبلغ إذا وصلته حركة محفظة بلا رقم عملية. هذه طريقة تصيب طلبًا غلطًا يوم يكون عندك طلبان بنفس القيمة. رقم العملية يُستهلك مرة واحدة، والدفع الناقص يبقى للمراجعة. إذا كان البيع أصلًا داخل تيليغرام لا على موقع، التأكيد يدخل في البوت نفسه؛ هذا مسار مختلف شرحته في بوت تيليغرام يستقبل دفعات سيريتل كاش.

أخطاء توقّف السير في أول أسبوع

أكثر خطأ أراه: webhook يُستدعى مرتين (إعادة حفظ في ووكومرس، أو مهلة شبكة ثم إعادة إرسال). إذا كان توليد الفاتورة بلا قيد فريد، تظهر فاتورتان وإشعاران لنفس الطلب. اجعل رقم الطلب مفتاحًا، وأعد الإرسال إن فشل تيليغرام فقط.

الخطأ الثاني إهمال HTTPS أو تغيير عنوان n8n بعد أن سجّلته في ووكومرس. المتجر يستمر في الإرسال إلى عنوان قديم، وأنت تظن أن السير صامت لأن الطلبات قليلة. بعد أي إعادة نشر، أرسل طلبًا تجريبيًا وتأكد من سجل التنفيذ في n8n.

الخطأ الثالث وضع التوكن في حقل نص ظاهر داخل العقدة، ثم تصدير سير العمل ومشاركته. استخدم أوراق اعتماد n8n، واحجب الأسرار من سجلات التنفيذ إذا كان عندك بيانات زبائن.

ويحدث أن تصل رسالة تيليغرام بينما الطلب لم يُحفظ بسبب ترتيب معاكس للعقد. احفظ أولًا، ثم أرسل، ثم أرجع للـwebhook ردًا ناجحًا بعد الحفظ. إذا فشلت الرسالة، ليرجع السير خطأً حتى يعيد المحاولة، من غير أن ينشئ فاتورة ثانية.

قائمة تحقق قبل الاعتماد على الإشعارات

  • مصدر الطلب يرسل webhook بعد الحفظ، وجسم الطلب يحتوي رقمًا ومبلغًا وحالة.
  • عنوان n8n يعمل على HTTPS، ومسجّل في ووكومرس أو في كود المتجر المخصص.
  • توكن تيليغرام ومعرّف المحادثة محفوظان في أوراق اعتماد، ورسالة تجريبية وصلت للمجموعة الصحيحة.
  • رقم الفاتورة حتمي ويرتبط برقم الطلب بقيد فريد.
  • إعادة إرسال الـwebhook نفسها لا تولّد فاتورة ثانية ولا رسالتين.
  • فشل تيليغرام يعيد المحاولة ولا يكسر سجل الفاتورة المحفوظ.
  • سير منفصل (أو فرع واضح) لإشعار «مدفوع» بعد تأكيد البوابة، لا بعد إنشاء الطلب.
  • طلب تجريبي واحد على الأقل ببيانات غير إنتاجية مرّ على المسار كاملًا، وظهر في سجل n8n بالنجاح.

إذا نقص بند، أُبقي الإشعار اليدوي موازيًا أيامًا قليلة. أتمتة ناقصة أسوأ من موظف يرسل عشر رسائل في اليوم، لأنها تعطي إحساسًا أن الكل يعلم، بينما المطبخ لم يصله شيء.

أسئلة تتكرر

هل أحتاج ووكومرس حتى أستخدم n8n؟

لا. ووكومرس يسهّل الـwebhook، لكن أي متجر أو بوت يقدر يرسل HTTP بعد حفظ الطلب يعمل. المهم أن يُولد الطلب في نظامك قبل الإشعار.

هل تغني أتمتة n8n عن بوابة الدفع؟

لا. n8n ينقل الحدث بعد حدوثه. تأكيد سيريتل كاش أو شام كاش يحتاج مطابقة برقم العملية ومنع إعادة استخدامه. البوابة تقوم بهذا، وn8n يبلّغ بعدها.

أين أتشغيل n8n؟ على سحابتهم أم على سيرفري؟

إذا كانت بيانات الزبائن حساسة عندك أو تريد أن يبقى كل شيء بجانب المتجر، شغّله على VPS. خدمة إعداد VPS عندي تبدأ من 40 دولارًا مرة واحدة. السحابة الرسمية تناسب تجربة سريعة، بشرط أن تراجع أين تُحفظ بيانات الطلب.

ماذا لو كان البيع من بوت واتساب أو تيليغرام لا من موقع؟

الإشعار الداخلي يبقى مفيدًا (للمحاسب أو للمطبخ). أما أخذ الطلب من الزبون داخل المحادثة فمساره مختلف: بوت واتساب للطلبات والدفع بشام كاش أو بوت تيليغرام للدفع. n8n يمكن أن يُستدعى من البوت بعد حفظ الطلب، لا أن يحل محل المحادثة.

هل أقدر أربط لاحقًا بوت خدمة عملاء؟

نعم. الإشعار شيء، وجواب الزبون شيء آخر. إذا كثرت الأسئلة المتكررة بعد الأتمتة، مسار بوت خدمة عملاء بالعربي يكمل الشغل، ولا يُخلط مع إشعارات المطبخ.

بعد أن يشتغل أول سير

اشتغل أسبوعًا على طلبات حقيقية بسير واحد: إنشاء، فاتورة، إشعار. بعدها تضيف فرع الدفع، أو نسخة من الرسالة لمجموعة المستودع فقط عندما تصبح الحالة «مدفوع». لا توسّع إلى محاسبة كاملة قبل أن يثبّت هذا المسار القصير.

إذا كان متجرك ما زال يُدار يدويًا وتفكر في منصة أوضح، المقارنة بين المتجر المستضاف والمملوك في متجر مستضاف أم مملوك تفيد قبل أن تبني فوق أداة غير مناسبة.

إذا بدك أركّب لك هذا المسار، راسلني من صفحة الموقع أو على fayezalshami.dev@gmail.com. اذكر نوع المتجر (ووكومرس أو موقع مخصص أو بوت)، وأين تريد الإشعار، وهل الدفع بسيريتل كاش أو شام كاش. خدمة البوتات والأتمتة تبدأ من 60 دولارًا مرة واحدة لبوت تيليغرام أو واتساب، وبوت الدفع من 120 دولارًا. أقدر أيضًا أن أربط n8n بمتجرك الحالي من غير أن أنقل البيع إلى بوت.

أدلّة ومقارنات

تحتاج إلى بناء هذا أو ربطه لعملك؟

استعرض الخدمات