שליחת קישורי תשלום ב-WhatsApp אוטומטית
כדי לשלוח קישורי תשלום ב-WhatsApp אוטומטית, מגיבים לשאלות על תשלום בקישור קבוע מספק התשלום שלכם, שמופעל ממילים כמו "pay" או "pix", או מעבירים את ההודעה למערכת שלכם, שיוצרת קישור להזמנה של הלקוח ומחזירה אותו כתגובה. הלקוח משלם בדף של ספק התשלום, והמערכת מאשרת בצ'אט כשהתשלום מאושר.
easyCoexistence מחבר את מספר WhatsApp Business שמור באפליקציה ל-Cloud API של Meta דרך Coexistence, ומריץ עליו אוטומציות: תגובה למילת מפתח עם הקישור שלכם, ה-AI שלכם עם המפתח שלכם, או וובהוק למערכת שיוצרת קישורים לכל הזמנה.
הזמן שהמערכת שלכם צריכה כדי ליצור את הקישור ולהחזיר אותו בשדה reply.
משך החיים שברירת המחדל של Stripe Checkout Session, וניתן להגדיר אותו בין 30 דקות ל-24 שעות.
Stripe מעתיק את metadata של Payment Link אל ה-Checkout Sessions שהוא יוצר, כך שאפשר לשייך תשלום לצ'אט.
תבניות שהכפתורים שלהן לא מכילים משתנה יכולות להישלח על ידי שלב Send a template באוטומציה.
הקטגוריה של Meta לתבניות שמופעלות על ידי פעולה או בקשה של המשתמש, ללא כוונה שיווקית.
באילו דרכים WhatsApp יכול לשלוח קישור תשלום אוטומטית?
חמישה דפוסים, מהדפוס שלא דורש קוד ועד לאוטומציה מלאה. התחילו מקישור קבוע אם מחיר אחד או חנות מכסים את המכירות שלכם, ועברו לקישור לכל הזמנה כשהסכומים משתנים. בכולם התשלום עצמו מתבצע בדף או באפליקציה של ספק התשלום, כך שפרטי כרטיס, העברות PIX וקבלות נשארים מחוץ לאוטומציה ולרישום הריצות שלה:
איך שולחים קישור קבוע לפי מילת מפתח?
מתחילים מ-Keyword reply תחת Start from an example. ב-Trigger בוחרים Has keyword, Contains, עם המילים שהלקוחות משתמשים בהן כשהם רוצים לשלם. בשלב Reply with text כותבים את הקישור בשורה נפרדת, כדי שיהיה אפשר ללחוץ עליו או להעתיק אותו, ואפשר להוסיף {{first_name}} אם רוצים. מפתח PIX או אסמכתא להעברה בנקאית עובדים באותה דרך. Contains מתאים גם בתוך מילים, כך ש-"pay" מופעל גם על PayPal ו-repay, וזה בדרך כלל רצוי, בעוד ש-"link" לבדו מופעל על הודעות רבות שאינן קשורות. אוטומציית מילת המפתח עונה לפני עוזר ה-AI שלכם, כך שהקישור מדויק ולעולם לא מנוסח מחדש.
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.האם ה-AI שלכם יכול לשלוח את הקישור כשהלקוח מוכן?
כן, אם הקישור נמצא בהוראות שלו. שלב Reply with AI כותב לפי ההוראות ולפי הצ'אט, ולכן שימו שם את הקישור, יחד עם כלל לגבי מתי לשלוח אותו והסדר לאשר קודם. מודלים מעתיקים את כתובת ה-URL שנתנו להם כמו שהיא, והכלל שנוסף להוראות שלכם אוסר להמציא מחירים, ולכן פרטו את הסכומים או ציינו מאיפה הם מגיעים.
הוסיפו שתי שורות של בטיחות: המודל לעולם לא יבקש מספרי כרטיס או סיסמאות, וכל מה שנוגע להחזרים או לתשלומים שנכשלו מועבר לאדם. בדקו את שני הדברים עם Try it לפני שמפעילים את האוטומציה, כולל שאלה בשפה אחרת.
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. נקודת הקצה שלכם מאמתת את X-EC-Signature, מוצאת את ההזמנה הפתוחה של הלקוח לפי contact.wa_id או לפי מספר ההזמנה בשדה message.text, מבקשת מספק התשלום קישור עם הסכום המדויק, ומחזירה אותו בשדה reply. שימו את מזהה ההזמנה ואת מספר 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 עם ה-metadata שלכם. קוראים מתוכו את מספר ה-WhatsApp ואת מזהה ההזמנה, ושולחים הודעה דרך Cloud API של Meta, עם נקודת השליחה ואסימון גישה (Access Token) שהכלי get_api_credentials מחזיר. עד 24 שעות מההודעה האחרונה של הלקוח, טקסט רגיל עובד. אחרי כן, Meta מקבלת רק תבנית שאושרה. אישור תשלום בא בעקבות הרכישה של הלקוח עצמו, וזה מתאים לקטגוריית utility, אם כי 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 }] }] } }),
});האם תבנית יכולה לשאת את כפתור התשלום?
כן, עם כתובת קבועה. שלב Send a template יכול לשלוח תבנית שאושרה, שהכפתורים שלה לא מכילים משתנה: כפתור URL לדף התשלום שלכם או ל-Payment Link קבוע, או כפתורי תשובה מהירה כמו Pay now ו-Talk to us, שהלחיצה עליהם מגיעה כטקסט, ואפשר לענות עליו בעזרת אוטומציית מילת מפתח עם הקישור. משתני הגוף מתמלאים לפי מיקום: הסכום נכנס ל-{{1}} ומספר ההזמנה ל-{{2}}.
כפתור URL עם משתנה, כפי שקישור לכל הזמנה היה צריך, וכפתורי העתקת קוד אינם מתמלאים על ידי אוטומציות כיום. המערכת שלכם שולחת תבניות כאלה דרך 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.
טעויות נפוצות
- לאפשר ל-AI לאסוף פרטי כרטיס בצ'אט. הוסיפו בהוראות שורה שאוסרת מספרי כרטיס, קודי PIN וקודים, ושלחו במקום זאת את הקישור של ספק התשלום. הודעות צ'אט נשמרות ברישומי הריצה למשך 30 יום.
- שליחת קישור לתשלום שפג תוקפו. Stripe Checkout Session תקף 24 שעות כברירת מחדל, ולכן לקוח שחוזר למחרת לוחץ על קישור מת. יש ליצור קישור חדש לפי בקשה.
- אישור תשלום בטקסט חופשי ימים אחר כך. מחוץ ל-24 שעות מההודעה האחרונה של הלקוח, Meta דוחה טקסט חופשי, ולכן שמרו תבנית utility מאושרת לאישורים.
- הוספת תגובה קבועה אחרי הוובהוק שמחזיר את הקישור. שתי התגובות נשלחות, כך שהלקוח מקבל את הקישור ועוד הודעה כללית שנייה.
היא לא נוגעת בכסף לעולם: הלקוחות משלמים ישירות לספק התשלום שלכם, ו-Meta מחייבת את ההודעות בחשבון שלכם בלי תוספת. US$ 9 ועד US$ 0.75 למספר בחודש, ויורד ככל שמוסיפים מספרים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם easyCoexistence מעבד את התשלומים?
לא. היא שולחת את הטקסט או התבנית שנושאים את הקישור, והתשלום מתבצע בין הלקוח לספק שלכם, כמו Stripe, Mercado Pago או PIX של הבנק שלכם. עמלות, העברות לחשבון שלכם, החזרים וקבלות נשארים בלוח הבקרה של ספק התשלום.
האם לקוחות יכולים לשלם בלי לצאת מהצ'אט?
לא דרך אוטומציות, שהן שולחות טקסט ותבניות, ולכן הלקוח פותח את דף ספק התשלום. הודעות תשלום מובנות של Meta בתוך הצ'אט קיימות רק בחלק מהשווקים, ושמערכת העסק שולחת אותן דרך Cloud API. בדקו את תיעוד התשלומים של Meta למדינה שלכם.
איך המערכת שלי יודעת לאיזה צ'אט שייך תשלום?
שימו את contact.wa_id ואת מזהה ההזמנה בשדה metadata של הקישור כשיוצרים אותו. כשספק התשלום מדווח על התשלום, קראו אותם בחזרה כדי לעדכן את ההזמנה ולשלוח את האישור למספר הנכון.
האם אפשר לשלוח תזכורת תשלום למי שלא כתב כבר ימים?
כן, כתבנית שאושרה שנשלחת על ידי המערכת שלכם או על ידי ה-AI שלכם עם send_template, כי טקסט חופשי נדחה מחוץ ל-24 שעות מההודעה האחרונה של הלקוח. שלחו תזכורות רק ללקוחות שהסכימו לקבל אותן, והשאירו מבצעים מחוץ לתבנית utility.
המשיכו לקרוא
מוכנים להתחיל?
מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-