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

ليه الرد السياقي مهم؟

• وضوح للعميل: بدل رد عام “تمام ✅”، العميل يشوف رسالته الأصلية مقتبسة فوق ردك — خصوصاً في محادثات الدعم اللي فيها طلبات متعددة.
• تجربة أفضل مع البوتات: لما الشات بوت يرد على رسالة العميل تحديداً، بيقل الالتباس وبيزيد الإحساس إن المحادثة “حقيقية” ومنظمة.
• تحسين جودة المحادثات: بيخلي الردود السياقية أوضح للعملاء في حالات الدعم الفني والمبيعات.

إزاي تشغّله تقنياً؟

ببساطة بتضيف حقل context جوه جسم الطلب (POST) لـ Cloud API — ومعاه message_id بتاع الرسالة اللي عايز ترد عليها (بيوصلك الـ wamid من الويب هوك لما العميل يبعت رسالته):

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<رقم العميل>",
  "context": {
    "message_id": "wamid.HBgLMTY0NjcwNDM1OTUV..."
  },
  "type": "text",
  "text": { "body": "تمام، تم تأكيد حجزك ✅" }
}

دي موثقة رسمياً في توثيق Contextual Replies من Meta.

حدود مهمة لازم تعرفها

• الردود بالتفاعلات (Reactions) مش بتشتغل كرد سياقي.
• الفقاعة المقتبسة مش هتظهر لو الرسالة الأصلية اتمسحت أو اتشالت من التخزين (Meta بتخزن الرسائل ~30 يوم إلا لو فعّلت التخزين المحلي).
• على أجهزة KaiOS، الرد السياقي بالصوت/الصورة/الفيديو مش بيظهر.
• الرد برسالة قالب (Template) مش بيبقى رد سياقي — القوالب ليها منطقها الخاص.

إمتى تستخدمه في البوتات؟

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

مثال ثانٍ: رد سياقي برسالة تفاعلية

الرد السياقي لا يقتصر على النص — يمكنك اقتباس رسالة العميل بينما ترسل أزراراً تفاعلية تسهّل عليه الاختيار:

{
  "messaging_product": "whatsapp",
  "to": "<رقم العميل>",
  "context": { "message_id": "wamid.HBgLMTY0NjcwNDM1OTUV..." },
  "type": "interactive",
  "interactive": {
    "type": "button",
    "body": { "text": "تمام! نأكد لك حجز الساعة 5؟" },
    "action": {
      "buttons": [
        { "type": "reply", "reply": { "id": "confirm_5pm", "title": "أؤكد ✅" } },
        { "type": "reply", "reply": { "id": "change_time", "title": "أغيّر الوقت" } }
      ]
    }
  }
}

لاحظ أن context يعمل بنفس الشكل مهما كان نوع الرسالة: نص، صورة، أزرار، أو قوائم.

أخطاء شائعة عند المطورين

• استخدام wamid من محادثة مختلفة: الـ message_id يجب أن يكون لرسالة وصلت من نفس العميل نفسه — وإلا يظهر الرد كرسالة عادية بلا اقتباس.
• الرد على رسالة أقدم من ٣٠ يوماً: إذا لم تكن مشغّلاً للتخزين الاحتياطي (Backup)، Meta تكون حذفت الرسالة من تخزينها والفقاعة لن تظهر.
• عدم التعامل مع فشل الطلب: لو الـ API أعاد خطأ بسبب message_id غير صالح، أرسل الرسالة بدون context بدلاً من فقدان الرد كلياً — منطق fallback بسيط ينقذ التجربة.
• الاعتماد على الرد السياقي في القوالب: رسائل القالب (Template) تُرسل بمسار مستقل ولا تُعتبر رداً سياقياً — لا تحاول دمجهما.

أثر الرد السياقي على تجربة العميل

في سيناريو الدعم الفني حيث تتداخل ٣-٤ طلبات في محادثة واحدة، الفرق عملي وليس شكلياً:

• بدون سياق: العميل يرسل “والفاتورة؟” فيرد البوت “تم ✅” — العميل لا يعرف أي طلب تم بالضبط، فيعيد السؤال ويتضاعف الحمل على الفريق.
• مع السياق: رد البوت يقتبس رسالة الفاتورة تحديداً، فيعرف العميل فوراً أن طلبه انحل ويكمل باقي الأسئلة بسلاسة.

والنتيجة القابلة للقياس: رسائل أقل لكل محادثة، زمن حل أقصر، ونسبة رضا أعلى — خصوصاً في البوتات التي تدير أكثر من موضوع في نفس الوقت.

أسئلة شائعة

المصادر الرسمية

• Contextual Replies (Meta)
• Send Messages API (Meta)

وتُعد الرد السياقي في واتساب API من أهم التحسينات التي حسّنت تجربة المحادثات التجارية داخل واتساب.

مصادر رسمية حول الرد السياقي في واتساب API

للاستزادة، راجع الدليل الرسمي المتخصص: developers.facebook.com/documentation/business-messaging/whatsapp/messages/contextual-replies. نراجع مصادرنا دورياً لضمان دقة معلومات الرد السياقي في واتساب API.