إرسال روابط الدفع عبر WhatsApp تلقائيًا
لإرسال روابط الدفع عبر WhatsApp تلقائيًا، يمكنك الرد على أسئلة الدفع برابط ثابت من مزود الدفع الخاص بك، يُفعَّل عند ورود كلمات مثل «pay» أو «PIX»، أو تمرير الرسالة إلى نظامك الخاص، الذي ينشئ رابطًا لطلب العميل ويعيده كرد. يدفع العميل في صفحة مزود الدفع، ويؤكد نظامك الدفع داخل المحادثة فور اكتماله.
يربط easyCoexistence رقم WhatsApp Business الذي تحتفظ به في التطبيق بـ Cloud API من Meta عبر Coexistence، ويشغّل عليه أتمتة: رد بالكلمة المفتاحية يتضمن رابطك، أو مساعدك الذكي الخاص بمفتاحك، أو webhook يصل إلى النظام الذي ينشئ الروابط لكل طلب.
المدة التي يحتاجها نظامك لإنشاء الرابط وإعادته في حقل الرد.
المدة الافتراضية لـ Stripe Checkout Session، ويمكن ضبطها بين 30 دقيقة و24 ساعة.
تنسخ Stripe البيانات الوصفية لرابط الدفع إلى الجلسات التي ينشئها، فيمكن ربط أي دفعة بالمحادثة.
القوالب التي لا تحتوي أزرارها على متغيرات يمكن إرسالها بخطوة «إرسال قالب» في الأتمتة.
فئة Meta للقوالب التي يرسلها المستخدم بطلبه أو بإجراء منه، ولا تحمل أي نية ترويجية.
ما الطرق التي ترسل بها WhatsApp رابط الدفع تلقائيًا؟
خمسة أنماط، من دون كود إلى الأتمتة الكاملة. ابدأ بالرابط الثابت إذا كان سعر واحد أو صفحة دفع في المتجر يغطي مبيعاتك، وانتقل إلى رابط لكل طلب عندما تختلف المبالغ. وفي كل منها تتم عملية الدفع نفسها في صفحة مزود الدفع أو تطبيقه، فتبقى أرقام البطاقات وتحويلات PIX والإيصالات خارج الأتمتة وسجل تشغيلها:
كيف ترسل رابطًا ثابتًا حسب الكلمة المفتاحية؟
ابدأ من «رد الكلمة المفتاحية» ضمن «ابدأ من مثال». المشغل: «يحتوي على كلمة مفتاحية» مع «يتضمن»، والكلمات التي يستخدمها العملاء عندما يريدون الدفع. الخطوة: «الرد بنص» مع وضع الرابط في سطر مستقل ليسهل النقر عليه أو نسخه، ومع {{first_name}} إن أردت. ويعمل مفتاح PIX أو مرجع التحويل البنكي بالطريقة نفسها. يطابق «يتضمن» الكلمة داخل الكلمات الأخرى، فكلمة «pay» تُفعّل الأتمتة أيضًا عند ورود PayPal أو repay، وهذا مرغوب غالبًا، بينما تُفعّل كلمة «رابط» وحدها كثيرًا من الرسائل غير المتعلقة. ترد الأتمتة بالكلمة المفتاحية قبل مساعدك الذكي، فيصل الرابط دقيقًا ولا يُعاد صياغته أبدًا.
Keywords (Contains): pay, payment, pagar, pagamento, pix, pago, link de pago, checkout
Reply with text:
Hi {{first_name}}! You can pay securely here:
https://buy.stripe.com/test_cN25nr0iZ7bUa7meUY
Prefer PIX? Key: payments@bloomcafe.example
Send the receipt here when you are done and we will confirm.هل يمكن لمساعدك الذكي إرسال الرابط عندما يكون العميل جاهزًا؟
نعم، إذا كان الرابط موجودًا في «التعليمات». تكتب خطوة «الرد بالذكاء الاصطناعي» انطلاقًا من التعليمات والمحادثة، لذا ضع الرابط هناك مع قاعدة توضح متى يُرسل، والترتيب المطلوب بتأكيد الطلب أولًا. تنسخ النماذج عنوان URL كما ورد حرفيًا، والقاعدة المضافة إلى تعليماتك تمنع اختلاق الأسعار، فاذكر المبالغ أو وضّح من أين تُؤخذ.
أضف سطرين للأمان: يجب ألا يطلب النموذج أبدًا أرقام البطاقات أو كلمات المرور، وتُحال أي مسألة تخص الاسترداد أو الدفعات الفاشلة إلى شخص. اختبر الأمرين عبر «جرّب» قبل تفعيل الأتمتة، بما في ذلك سؤال بلغة أخرى.
Payments
- When the customer confirms the order and wants to pay, send this link on its own line:
https://buy.stripe.com/test_cN25nr0iZ7bUa7meUY
- Before sending it, repeat the items and the total from the price list above.
- Never ask for card numbers, PINs, passwords or one-time codes. The customer pays on the link.
- Refunds, double charges or failed payments: say someone from our team will reply here shortly.كيف ينشئ نظامك رابطًا لكل طلب؟
عبر خطوة «Call my webhook»، أي استدعاء خطاف الويب (webhook). تتحقق نقطة النهاية (endpoint) لديك من X-EC-Signature، وتجد الطلب المفتوح للعميل عبر contact.wa_id أو عبر رقم الطلب في message.text، وتطلب من مزود الدفع رابطًا بالمبلغ الدقيق، ثم تعيده في حقل الرد. ضع معرّف الطلب ورقم WhatsApp في البيانات الوصفية (metadata) للرابط، حتى يمكن ربط الدفعة بالطلب لاحقًا.
اجعل الاستجابة أقل من 20 ثانية، فاستدعاء واحد لمزود الدفع يستغرق عادة ثانية أو ثانيتين. أعد استخدام رابط ما زال مفتوحًا إذا طلب العميل الرابط نفسه للطلب نفسه مرتين. في الاختبارات تكون قيمة dry_run مساوية لـ true، فيعيد النظام جملة نموذجية ولا ينشئ شيئًا.
// signed(req) is the X-EC-Signature check from the live-data page, with this automation's secret.
app.post("/whatsapp/pay", express.text({ type: "application/json" }), async (req, res) => {
if (!signed(req)) return res.status(401).end();
const { dry_run, contact } = JSON.parse(req.body);
const order = await openOrderFor(contact.wa_id); // your system: this customer's unpaid order
if (!order) return res.json({ reply: "I could not find an open order for this number. Send the order number and I will check." });
if (dry_run) return res.json({ reply: "Test: the payment link for order " + order.id + " would go here." });
const form = new URLSearchParams({
mode: "payment",
success_url: "https://shop.example/thanks",
"line_items[0][quantity]": "1",
"line_items[0][price_data][currency]": order.currency, // e.g. "usd" or "brl"
"line_items[0][price_data][unit_amount]": String(order.amountCents),
"line_items[0][price_data][product_data][name]": "Order " + order.id,
"metadata[order_id]": order.id,
"metadata[wa_id]": contact.wa_id,
});
const r = await fetch("https://api.stripe.com/v1/checkout/sessions", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.STRIPE_SECRET_KEY },
body: form,
});
const session = await r.json();
if (!session.url) return res.json({ reply: "The payment link is not ready yet. Someone from our team will send it here shortly." });
res.json({ reply: "Order " + order.id + ", total " + order.total + ". Pay here:\n" + session.url + "\nThe link stays open for 24 hours." });
});كيف يحصل العميل على تأكيد بعد الدفع؟
من نظامك، عندما يبلغ مزود الدفع بالدفعة، مثل حدث checkout.session.completed في Stripe مع بياناتك الوصفية. اقرأ رقم WhatsApp ومعرّف الطلب منه، ثم أرسل رسالة عبر Cloud API من Meta، باستخدام endpoint الإرسال ورمز الوصول (token) الذي يعيده get_api_credentials. خلال 24 ساعة من آخر رسالة للعميل، يكفي النص العادي. بعد ذلك لا تقبل Meta إلا قالبًا معتمدًا. وتتبع رسالة تأكيد الدفع عملية شراء قام بها العميل نفسه، وهذا يناسب فئة «المنفعة»، مع أن Meta تقرر ذلك عند المراجعة. وتظهر الرسالة أيضًا في سلسلة المحادثة داخل التطبيق، فيعرف الفريق أن الطلب قد دُفع.
// send_endpoint and access_token come from get_api_credentials for this number.
const insideWindow = Date.now() - lastCustomerMessageAt(waId) < 24 * 3600 * 1000;
await fetch(SEND_ENDPOINT, {
method: "POST",
headers: { Authorization: "Bearer " + ACCESS_TOKEN, "Content-Type": "application/json" },
body: JSON.stringify(insideWindow
? { messaging_product: "whatsapp", to: waId, type: "text",
text: { body: "Payment received for order " + orderId + ". Thank you! We will let you know when it ships." } }
: { messaging_product: "whatsapp", to: waId, type: "template",
template: { name: "payment_received", language: { code: "en" },
components: [{ type: "body", parameters: [{ type: "text", text: orderId }] }] } }),
});هل يمكن أن يحمل القالب زر الدفع؟
نعم، برابط ثابت. تستطيع خطوة «إرسال قالب» إرسال قالب معتمد لا تحتوي أزراره على متغيرات: زر رابط يوجه إلى صفحة الدفع الخاصة بك أو إلى رابط دفع ثابت، أو أزرار رد سريع مثل «ادفع الآن» و«تحدث معنا»، وتصل ضغطاتها كنص يمكن لأتمتة الكلمات المفتاحية أن ترد عليه بالرابط. تُملأ متغيرات النص بحسب موضعها، فيوضع المبلغ أو رقم الطلب في {{1}} و{{2}}.
لا تملأ الأتمتة اليوم زر الرابط الذي يحمل متغيرًا، كما تحتاج الروابط لكل طلب، ولا أزرار نسخ الرمز (copy-code)، ويرسل نظامك هذه القوالب عبر Cloud API. تفرض Meta رسوم قوالب الرسائل على كل رسالة، حسب الفئة والدولة، على حساب WhatsApp Business الخاص بك.
كيفية إعداده
- Create the link at your providerMake a Payment Link or a checkout page for the product, or note your PIX key. Open it once on a phone to check the amount and the page.
- Start a keyword automationIn Automations, click New automation and pick Keyword reply under Start from an example. Choose Contains and enter your payment words, one per line.
- Write the replyIn Reply with text, put a short greeting with {{first_name}} and the link on its own line. Save with the switch Off.
- Test the wordsClick Test and run "how do I pay?", "quero pagar" and an unrelated message with Run test, to see which ones match and what the customer would receive.
- Switch it OnSet the switch to On and save. Write "pay" from another phone and tap the link to check it opens the payment page.
الأخطاء الشائعة
- أن يجمع الذكاء الاصطناعي تفاصيل البطاقة داخل المحادثة. أضف سطرًا في التعليمات يمنع أرقام البطاقات ورموز PIN والرموز الأمنية، وأرسل رابط مزود الدفع بدلًا منها، فرسائل المحادثة تُحفظ في سجلات التشغيل لمدة 30 يومًا.
- إرسال رابط جلسة منتهية الصلاحية. جلسة Stripe Checkout Session تدوم 24 ساعة افتراضيًا، فالعميل الذي يعود في اليوم التالي يضغط على رابط منتهٍ، لذا أنشئ رابطًا جديدًا عند الطلب.
- تأكيد الدفع بنص حر بعد أيام. بعد 24 ساعة من آخر رسالة للعميل ترفض Meta النص الحر، فاحتفظ بقالب منفعة معتمد للتأكيدات.
- إضافة رد ثابت بعد webhook الذي يعيد الرابط. يُرسل الاثنان، فيتلقى العميل الرابط ورسالة ثانية عامة.
ولا يمس الأموال مطلقًا، فيدفع العملاء مباشرة لمزود الدفع، وتحتسب Meta الرسائل على حسابك الخاص دون هامش. من US$ 9 إلى US$ 0.75 لكل رقم شهريًا، ويقل السعر كلما أضفت أرقامًا، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل تعالج easyCoexistence المدفوعات؟
لا. يرسل النص أو القالب الذي يحمل الرابط، ويتم الدفع بين العميل ومزود الدفع، مثل Stripe أو Mercado Pago أو PIX لدى بنكك. تبقى الرسوم والتحويلات والاسترداد والإيصالات في لوحة مزود الدفع الخاصة بك.
هل يمكن للعملاء الدفع دون مغادرة المحادثة؟
ليس عبر الأتمتة، فهي ترسل نصوصًا وقوالب، لذلك يفتح العميل صفحة مزود الدفع. رسائل الدفع الداخلية من Meta متاحة في بعض الأسواق فقط، ويرسلها نظام النشاط عبر Cloud API، لذا راجع وثائق الدفع لدى Meta لبلدك.
كيف يعرف نظامي المحادثة التي تنتمي إليها الدفعة؟
ضع contact.wa_id ومعرّف الطلب في البيانات الوصفية للرابط عند إنشائه. وعندما يبلغ مزود الدفع بالدفعة، اقرأهما لتحديث الطلب وإرسال التأكيد إلى الرقم الصحيح.
هل يمكن إرسال تذكير بالدفع لشخص لم يكتب منذ أيام؟
نعم، كقالب معتمد يرسله نظامك أو مساعدك الذكي عبر send_template، لأن النص الحر يُرفض بعد 24 ساعة من آخر رسالة للعميل. أرسل التذكيرات فقط للعملاء الذين وافقوا على تلقيها، وأبقِ العروض الترويجية خارج قالب المنفعة.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في