الردود السريعة

الرد السريع

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

المصادقة والنطاقات

لم يُستحدث تصريح خاص بالردود السريعة، بل تعيد استخدام ثلاثة تصاريح قائمة. ولذلك يستطيع دور agent قراءتها واستخدامها ولا يستطيع إدارتها.

نقاط النهاية

curl -X POST https://whats.azzamkh.sa/api/v1/quick-replies \
  -H "Authorization: Bearer $WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shortcut": "hours",
    "title": "Opening hours",
    "body_en": "We reply Sunday to Thursday, 9am to 5pm.",
    "body_ar": "نرد من الأحد إلى الخميس، 9 صباحًا حتى 5 مساءً."
  }'

# 201 Created
# {
#   "id": "qr_...",
#   "shortcut": "hours",
#   "title": "Opening hours",
#   "body_en": "...",
#   "body_ar": "...",
#   "sort_order": 30,
#   "use_count": 0,
#   "last_used_at": null,
#   ...
# }

# Search is a PREFIX match on the shortcut, not a search over titles:
curl "https://whats.azzamkh.sa/api/v1/quick-replies?q=hou" \
  -H "Authorization: Bearer $WA_API_KEY"

# Clearing ONE language is an explicit null. Omitting the field leaves it.
curl -X PATCH https://whats.azzamkh.sa/api/v1/quick-replies/qr_... \
  -H "Authorization: Bearer $WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "body_en": null }'

سلوك يستحق المعرفة

• المعامل ?q= مطابقة بادئة على الاختصار، لا بحث تقريبي في العناوين. والمطابقة بالبادئة هي ما يجعل الكتابة حتمية.
• تعود القائمة بترتيب المشغّل، مُرقَّمة على (sort_order, public_id). اعرضها كما وردت ولا ترتّبها في العميل. ويأخذ PATCH /v1/quick-replies/order معرّفات مرتّبة لا مواضع، تحديدًا كي لا يحسب أي عميل ترتيبه الخاص.
• في PATCH تمسح null لغة واحدة، ويترك غياب الحقل قيمته كما هي. والسلسلة الفارغة ليست نصًا مقبولًا، فإفراغ حقل يجب أن يُرسل كـ null وإلا أُسقط التعديل بصمت.
• المسار POST …/use للمحاسبة فقط — لا يرسل شيئًا. أرسل الرسالة عبر المحادثة كالمعتاد ثم سجّل الاستخدام.
• الإنشاء والاستخدام محدودان لكل مساحة عمل: 120 إنشاءً في الدقيقة، و600 استخدام في الدقيقة، و60 إعادة ترتيب في الدقيقة.

الأخطاء المهمة هنا

كل رمز وحالته في صفحة الأخطاء.