الحصول على قائمة Postback للروبوت عبر WhatChimp API

استرجع جميع معرفات postback لتدفقات الروبوت، المطلوبة لربط أزرار Quick Reply بتدفقات الروبوت.

Updated 5 February 2026

استرجع قائمة جميع إجراءات postback للروبوت المهيأة في تدفقات روبوت WhatsApp الخاصة بك. Postbacks هي المحفزات التي تربط الأزرار التفاعلية وقوالب Quick Reply وخيارات القائمة بتدفقات روبوت محددة.

قبل البدء: تأكد من أن لديك مفتاح API الخاص بك ورقم تعريف الهاتف. راجع البدء مع WhatChimp Developer API للحصول على تعليمات الإعداد.

ما هي Postbacks؟

كل تدفق روبوت تنشئه في WhatChimp له معرّف postback: معرّف فريد يطلق هذا التدفق المحدد. يتم استخدام Postbacks عندما:

تربط أزرار Quick Reply في رسائل القالب بتدفقات الروبوت (راجع Send Template Messages with Quick Reply Buttons)
تطلق تدفقات الروبوت برمجياً من نظامك الخاص
تربط أزرار القائمة التفاعلية بردود محددة

Endpoint

GET/POST /api/v1/whatsapp/get/post-back-list

https://app.whatchimp.com/api/v1/whatsapp/get/post-back-list

المعاملات

المعامل	النوع	مطلوب	الوصف
`apiToken`	String	نعم	مفتاح WhatChimp API الخاص بك
`phone_number_id`	String	نعم	رقم تعريف هاتف WhatsApp الخاص بك

أمثلة الطلبات

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/post-back-list?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/post-back-list' \
  -d 'apiToken=API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID'

الاستجابة

{
  "status": "1",
  "message": [
    {
      "id": 671,
      "postback_id": "QUICK_REPLY_LOCATION_REPLY_BOT",
      "bot_name": "Location quick reply",
      "template_name": "Location quick reply",
      "visual_flow_type": "flow",
      "postback_type": "main"
    },
    {
      "id": 672,
      "postback_id": "QUICK_REPLY_ORDER_TRACKING",
      "bot_name": "Track Order Flow",
      "template_name": "Track Order Flow",
      "visual_flow_type": "flow",
      "postback_type": "main"
    }
  ]
}

حقول الاستجابة

الحقل	الوصف
`id`	معرّف داخلي لتدفق الروبوت
`postback_id`	معرّف postback الفريد: هذا ما تمرره في مكالمات API
`bot_name`	اسم العرض لتدفق الروبوت
`template_name`	اسم القالب المرتبط بالتدفق
`visual_flow_type`	نوع التدفق: `"flow"` (منشئ التدفق المرئي) أو أنواع أخرى
`postback_type`	`"main"` للمحفزات الأساسية

استخدام Postbacks مع قوالب Quick Reply

حالة الاستخدام الأكثر شيوعاً لهذا الـ endpoint هي ربط أزرار Quick Reply بتدفقات الروبوت عند إرسال رسائل القالب عبر API.

التدفق:

استدعِ GET /whatsapp/get/post-back-list للحصول على جميع معرفات postback المتاحة
اختر معرفات postback التي تطابق تدفقات الروبوت التي تريد أن يطلقها كل زر
مررها كمصفوفة JSON في template_quick_reply_button_values عند إرسال القالب

template_quick_reply_button_values=["QUICK_REPLY_ORDER_TRACKING", "QUICK_REPLY_LOCATION_REPLY_BOT"]

معرّف postback الأول يرتبط بزر Quick Reply الأول، والثاني بالزر الثاني، وهكذا.

للحصول على دليل كامل، راجع Send Template Messages with Quick Reply Buttons via WhatChimp API.