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

بوت واتساب للطلبات والدفع بشام كاش

بقلم فايز الشامينُشر: قراءة لمدة 11 دقائق
الخلاصة

بوت واتساب يجمع الطلب ويثبت المبلغ، ثم يطلب رقم عملية شام كاش ويتحقق عبر البوابة بدل لقطة الشاشة.

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

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

ماذا يفعل البوت، وما الذي لا يفعله

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

ما لا أفعله: لا أفتح الحساب لدى شام كاش نيابة عنك، ولا أشغّل بوت إنتاج على رقم واتساب شخصي عبر أدوات غير رسمية لقراءة الواتساب ويب. هذا ينكسر عند أول تحقق أمني، ويعرّض الرقم للحظر. المسار الذي أعتمده هو WhatsApp Business Platform (Cloud API) على رقم تجاري، مع webhook يستقبل الرسائل ويرد عليها.

باقة بوت الدفع تبدأ من 120 دولارًا مرة واحدة، وتتصل بشام كاش أو سيريتل كاش حسب السوق. بوت تيليغرام أو واتساب بلا تأكيد دفع يبدأ من 60 دولارًا مرة واحدة. API شام كاش خمسة دولارات للحساب في الشهر. الإعداد يتم في اليوم نفسه. البوابة مستضافة، من دون تسليم كود مصدري. فاتورة ميتا لاستخدام Cloud API منفصلة، وتُحسب حسب أسعارهم الحالية؛ أذكرها عند الاتفاق ولا أثبت رقمًا لها هنا لأنه يتغيّر.

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

ما يجب أن يكون جاهزًا

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

وعلى جهة واتساب تحتاج حساب أعمال في ميتا، وتطبيقًا، ورقم هاتف مخصّصًا للمنصة، ورمز وصول، ومعرّف رقم الهاتف (phone_number_id). الرسائل القادمة تصل إلى webhook عندك. الرد خلال نافذة 24 ساعة من رسالة الزبون يتم برسالة عادية. إذا أردت أن تبدأ المحادثة أنت بعد انتهاء النافذة، تحتاج قالبًا موافقًا عليه. هذا القيد من ميتا، لا من البوابة.

ونظام طلبات يحتفظ بما يلي قبل أن تطلب الدفع: بنود الطلب، المبلغ بالليرة، رقمًا داخليًا، رقم واتساب الزبون، حالة، مهلة، حقلًا لرقم العملية، وحقلًا لرقم المرسل. لا تبدأ من رسالة حرّة «دفعت» ثم تحاول تخمين لأي حديث كان التحويل.

أبقِ في اللوحة زر تأكيد وزر رفض. الزبون قد يرسل صورة، أو يدفع من حساب أهله، أو يكتب الرقم وسط جملة. البوت يجب أن يطلب نص الرقم في هذه الحالات، وأن يترك لك مسارًا يدويًا.

يمكن طلب تجربة قبل الحساب الحي. الواجهة تعمل من خارج سوريا من دون وسيط سوري ومن دون VPN.

تدفق طلب غداء واحد مع دفع شام كاش

الزبون يراسل الرقم: «مرحبا، قائمة اليوم». البوت يرد بالقائمة المختصرة أو بأزرار أصناف. يختار منسفًا لشخصين وتوصيلًا داخل دمشق. المجموع 62,500 ل.س. هنا ينشئ النظام الطلب، ويثبّت المبلغ، ويعرض تعليمات التحويل على حساب شام كاش، ويوضح أن المبلغ يُحوَّل كما هو خلال المهلة، ثم يُرسل رقم العملية في هذه المحادثة.

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

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

طلبان بنفس سعر وجبة اليوم لا يتعارضان، لأن المطابقة تبدأ من رقم العملية. المبلغ شرط بعد إيجاد التحويل.

المهلة تقررها أنت. في المطعم أميل إلى ساعة في أوقات الذروة، مع تذكير قبل انتهائها إذا لم يصل الرقم. القاعدة تُكتب في النظام وفي رسالة التعليمات.

كيف يستقبل السيرفر رسالة واتساب ويؤكد الدفع

المثال التالي خادم Node يستقبل webhook رسميًا من Cloud API، ويحفظ الطلب، ويطلب من البوابة التحقق. هو نمط لحديث نظامك مع البوابة الجاهزة، لا مسارًا رسميًا لحساب شام كاش. استبدل YOUR_GATEWAY_URL وYOUR_API_KEY وأسماء الحقول بما يصلك عند الإعداد. مسارات ميتا أدناه هي المسارات الموثّقة لمنصتهم؛ ثبت رقم إصدار الواجهة الذي تستخدمه أنت عند الربط. في الإنتاج استخدم قاعدة بيانات بقيد فريد على رقم العملية، وشغّل البحث ثم الكتابة داخل معاملة.

```javascript import express from "express"; import { DatabaseSync } from "node:sqlite";

const app = express(); app.use(express.json());

const db = new DatabaseSync("orders.db"); db.exec( CREATE TABLE IF NOT EXISTS orders ( id INTEGER PRIMARY KEY AUTOINCREMENT, wa_from TEXT NOT NULL, amount INTEGER NOT NULL, status TEXT NOT NULL, transaction_id TEXT UNIQUE, sender_number TEXT, created_at TEXT DEFAULT CURRENT_TIMESTAMP ); );

const GATEWAY_URL = process.env.GATEWAY_URL; // YOUR_GATEWAY_URL حتى يصلك العنوان const GATEWAY_KEY = process.env.GATEWAY_API_KEY; const META_TOKEN = process.env.WHATSAPP_TOKEN; const PHONE_NUMBER_ID = process.env.WHATSAPP_PHONE_NUMBER_ID; const VERIFY_TOKEN = process.env.WHATSAPP_VERIFY_TOKEN; const SHAM_CASH_ACCOUNT = process.env.SHAM_CASH_ACCOUNT; const GRAPH = https://graph.facebook.com/v21.0/${PHONE_NUMBER_ID}/messages;

function toIntAmount(value) { return Math.round(Number(value)); }

async function sendText(to, body) { await fetch(GRAPH, { method: "POST", headers: { Authorization: Bearer ${META_TOKEN}, "Content-Type": "application/json", }, body: JSON.stringify({ messaging_product: "whatsapp", to, type: "text", text: { body }, }), }); }

async function lookupTransfer(transactionId) { const response = await fetch(GATEWAY_URL, { method: "POST", headers: { Authorization: Bearer ${GATEWAY_KEY}, "Content-Type": "application/json", }, body: JSON.stringify({ transactionId }), }); if (!response.ok) { throw new Error(gateway_http_${response.status}); } return response.json(); // حقول تقريبية: found, amount, receivedAt, senderNumber }

function createOrder(waFrom, amount) { const insert = db.prepare( "INSERT INTO orders (wa_from, amount, status) VALUES (?, ?, ?)" ); const result = insert.run(waFrom, amount, "awaiting_payment"); return Number(result.lastInsertRowid); }

function openOrderFor(waFrom) { return db .prepare( "SELECT id, amount, status FROM orders WHERE wa_from = ? AND status = ? ORDER BY id DESC LIMIT 1" ) .get(waFrom, "awaiting_payment"); }

async function confirmByTransactionId(order, transactionId) { const id = String(transactionId || "").trim(); if (!id) return { status: "bad_payload" };

const used = db .prepare("SELECT id FROM orders WHERE transaction_id = ?") .get(id); if (used) { return { status: "already_used" }; }

const payload = await lookupTransfer(id); if (!payload || !payload.found) { return { status: "not_found" }; }

const paid = toIntAmount(payload.amount); const expected = toIntAmount(order.amount); const sender = payload.senderNumber ?? null;

if (paid !== expected) { db.prepare( "UPDATE orders SET status = ?, transaction_id = ?, sender_number = ? WHERE id = ? AND transaction_id IS NULL" ).run("needs_review", id, sender, order.id); return { status: "wrong_amount", paid, senderNumber: sender }; }

try { db.prepare( "UPDATE orders SET status = ?, transaction_id = ?, sender_number = ? WHERE id = ? AND transaction_id IS NULL" ).run("paid", id, sender, order.id); } catch (err) { if (String(err.message).includes("UNIQUE")) { return { status: "already_used" }; } throw err; }

return { status: "paid", senderNumber: sender, paidAt: payload.receivedAt, }; }

app.get("/webhook", (req, res) => { const mode = req.query["hub.mode"]; const token = req.query["hub.verify_token"]; const challenge = req.query["hub.challenge"]; if (mode === "subscribe" && token === VERIFY_TOKEN) { return res.status(200).send(challenge); } return res.sendStatus(403); });

app.post("/webhook", async (req, res) => { res.sendStatus(200);

const messages = req.body?.entry?.[0]?.changes?.[0]?.value?.messages || []; for (const message of messages) { if (message.type !== "text") { const from = message.from; const open = openOrderFor(from); if (open) { await sendText( from, "أرسل رقم العملية كنص، منسوخًا من تفاصيل التحويل في شام كاش. الصورة وحدها لا تكفي." ); } continue; }

const from = message.from; const text = (message.text?.body || "").trim();

if (/^(قائمة|منيو|مرحبا|السلام عليكم)$/i.test(text) || text === "طلب") { const amount = 62500; const orderId = createOrder(from, amount); await sendText( from, طلب رقم ${orderId}. المجموع ${amount} ل.س.\n + حوّل المبلغ إلى حساب شام كاش ${SHAM_CASH_ACCOUNT}.\n + "التحويل لا يحتاج ملاحظة. بعد نجاحه أرسل رقم العملية في هذه المحادثة." ); continue; }

const open = openOrderFor(from); if (!open) { await sendText(from, "ما عندك طلب بانتظار الدفع. اكتب «طلب» لنبدأ."); continue; }

const txId = text.replace(/\s+/g, ""); if (!/^\d{6,}$/.test(txId)) { await sendText( from, "أرسل رقم العملية فقط، من دون كلام إضافي. إذا كنت لسا ما حولت، حوّل أولًا ثم ألصق الرقم." ); continue; }

let result; try { result = await confirmByTransactionId(open, txId); } catch (err) { await sendText(from, "التأكيد تأخر لحظة. أعد إرسال رقم العملية بعد قليل."); continue; }

if (result.status === "paid") { await sendText(from, وصل المبلغ. طلبك رقم ${open.id} دخل التجهيز.); continue; } if (result.status === "not_found") { await sendText( from, "ما ظهرت العملية بعد. راجع الرقم، انتظر دقيقة إذا كان التحويل للتو، ثم أعد الإرسال." ); continue; } if (result.status === "wrong_amount") { await sendText( from, "وصل تحويل مرتبط بهذا الطلب والمبلغ مختلف. رح نراجعه ونرجع لك." ); continue; } if (result.status === "already_used") { await sendText( from, "هذا الرقم مستخدم من قبل على طلب آخر. أرسل رقم عملية التحويل الجديد." ); } } });

app.listen(process.env.PORT || 3000); ```

المثال يستخدم node:sqlite المدمج ابتداءً من Node 22. إذا كان إصدارك أقدم، استبدل المخزن بـ better-sqlite3 أو Postgres مع الإبقاء على القيد الفريد.

انتبه لتفصيلين في هذا الخادم. أولاً، الرد على ميتا يتم فورًا برمز 200، ثم تُعالج الرسالة. إذا تأخر رد الـwebhook تعامل ميتا الإرسال كفاشل وتعيد المحاولة، وقد يصل رقم العملية مرتين؛ القيد الفريد يحمي الحالة، والرسالة للزبون يجب أن تحتمل التكرار. ثانيًا، الشرط ^\d{6,}$ حد أدنى لشكل الرقم حتى لا تُرسل كلمة «تمام» إلى البوابة. طول رقم العملية الحقيقي تثبته أنت من عيّنات حسابك بعد التجربة، ولا تعتمد على رقم اخترعته من هذا المثال.

الإشعار للمطبخ أو لصاحب المحل يأتي بعد حفظ «مدفوع». إذا فشل الإرسال، تعيد المحاولة من دون إعادة تعليم الطلب.

حالات واتساب التي تكسر التأكيد

الصورة أول ما يصل بعد التحويل. كثير من الزبائن متعودون أن الإثبات صورة. إذا وصلت صورة أثناء انتظار الدفع، اطلب لصق الرقم كنص. لا أبني الإصدار الأول على قراءة الرقم من الصورة.

الزبون يكتب الرقم داخل جملة: «رقم العملية 123456789 تم». في الإنتاج أُخرِج المتتالية الرقمية من الرسالة بعد أن أتأكد أنها واحدة وواضحة. إذا وُجد أكثر من رقم، أسأل أيهما رقم العملية بدل التخمين.

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

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

إعادة استخدام الرقم تُرفض دائمًا. ابحث في اللوحة برقم العملية قبل أي تأكيد يدوي.

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

قائمة تحقق قبل استقبال طلبات حقيقية

  • حساب شام كاش الحي متصل بالبوابة.
  • رقم واتساب تجاري على Cloud API، والـwebhook يتحقق من الطلبات التجريبية ويرد داخل نافذة الجلسة.
  • الطلب يُنشأ بمبلغ ومهلة وحالة قبل تعليمات التحويل.
  • الرسالة تقول إن التحويل لا يحتاج ملاحظة، وتطلب رقم العملية بعد الدفع.
  • رقم العملية يُحفظ بقيد فريد، ويُرفض إن أُعيد استخدامه.
  • رقم غير موجود بعد لا يُستهلك.
  • المبلغ يُقارن كعدد، والمبلغ المختلف يدخل المراجعة مع ربط الرقم.
  • رقم المرسل يُحفظ ولا يُشترط تطابقه مع رقم واتساب.
  • صورة أو رسالة صوتية لا تُعامل كرقم عملية.
  • زر تأكيد ورفض في اللوحة، مع أثر مكتوب.
  • إشعار المطبخ أو التاجر بعد حفظ الحالة، مع إعادة محاولة.
  • جرّبت النجاح، والتكرار، والمبلغ المختلف، والرقم غير الظاهر بعد، وإرسال صورة.

أسئلة تتكرر

هل أقدر أشغّل البوت على واتساب الشخصي؟

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

هل يكتب الزبون ملاحظة في تحويل شام كاش؟

لا. ما فيه حقل ملاحظة. المطابقة برقم العملية الذي يرسله في واتساب بعد الدفع.

ماذا لو طلب الزبون من رقم ودفع ابنه من رقم آخر؟

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

هل أقدر أقبل سيريتل كاش من نفس البوت؟

نعم. كل محفظة اشتراك منفصل. الطلب ينتظر محفظة واحدة في اللحظة، والتحقق يتم على تلك المحفظة. سيريتل كاش دولاران للرقم شهريًا، وشام كاش خمسة دولارات للحساب.

كم يستغرق الإعداد، وهل فيه تجربة؟

الإعداد يتم في اليوم نفسه بعد جاهزية الرقم التجاري وحساب شام كاش. يمكن طلب تجربة على البوابة قبل الحساب الحي.

هل السيرفر لازم يكون داخل سوريا؟

لا. البوابة تعمل من خارج سوريا من دون وسيط سوري ومن دون VPN.

أول أسبوع بعد الإطلاق

ابدأ بصنف واحد أو قائمة قصيرة، ومهلة مكتوبة، ومراجعة يدوية للحالات الشاذة. راقب يومين من الرسائل الحقيقية: كيف يكتب الناس الرقم، ومتى يرسلون صورة، ومتى يدفعون بعد أن يظن النظام أن الطلب انتهى. بعدها توسّع في القائمة أو تضيف سيريتل كاش.

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

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

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

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