يوجد نوعان من الـJSON API في مجموعة الرسائل:
رد طلب الـAPI
يمكنك استخدام رد طلب الـAPI في التالي:
-
إعادة توجيه المستخدم لمجموعة رسائل معينة
-
تخصيص محتوى مجموعة الرسائل بمتغيرات
-
إرسال انواع عديدة من الردود كالفواتير
-
تحديث متغيرات المستخدم
يجب أن تحرص على ألا يأخذ وقت رد طلب الـAPI أكثر من 10 ثواني حتى لا ينتهي وقته.
بالأسفل بعض العناصر التي يمكن أن تضعها برد طلب الـAPI الخاص بك ويمكنك إضافة بعض أو كلهم:
عنصر "Attributes"
-
يمكنك استخدامه لتحديد أو تغيير قيم المتغيرات
-
يمكنك تحديد مجموعة من المتغيرات بالمرة حيث يتكون كل متغير من عنصر أساسي وقيمة للمتغير
-
يجب أن تحرص على أنك قد قمت مسبقًا بإنشاء اسم متغير متاح للعنصر الأساسي.
عنصر"FlowName":
-
يمكنك استخدامه للتوجيه لمجموعة رسائل محددة بعد نجاح طلب الـAPI
-
يجب أن تحرص على أنك قد قمت مسبقًا بإنشاء اسم متاح لمجموعة الرسائل.
عنصر "FacebookResponse"
-
هو إضافة عناصر ردود مخصوصة لترسلها لمستخدمينك.
-
لتصل لرقم تعريف المستلم، اترك متغير “{psid}” كما هو وسنبدله لك.
-
تعلم أكثر عن ردود فيس بوك المتوفرة من ملفات منصة Messenger.
يجب أن يكون رد الـAPI الخاص بك بصورة صالحة مثل: :
{
"attributes":{"Key1":"Value", "Key2":"Value"},
"FlowName" : "My new Flow",
"FacebookResponse" : {
"messaging_type": "<MESSAGING_TYPE>",
"recipient":{
"id":"{psid}"
},
"message":{
"text":"hello, world!"
}
}
}
طلب استدعاء
يسمح لك طلب الاستدعاء أن تحفز رد البوت لاحقًا بعد حتى دقيقتين.
يمكنك استخدام طلب الاستدعاء لنفس أسباب استخدامك لطلب الرد بالأضافة للعمليات التي قد تتخذ وقت أطول كالمعاملات البنكية أو عمليات جداول البيانات المعقدة.
عندما تتيح طلبات الاستدعاء تحصل على 2 هيدر اضافي في طلب الـJSON API:
-
رابط الاستدعاء
هو نقطة النهاية الذي سينتهي عنده طلب الاستدعاء الخاص بك. سيكون العنصر الأساسي للهيدر في هيئة “callbackurl”
2. الرمز
يجب على هيدر طلب الاستدعاء أن يحتوي على نفس الرمز الذي يتأكد أن هذا الطلب منك فيبادر بتنفيذه. تنتهي صلاحية هذا الرمز بعد دقيقتين. سيكون تعريف قيمة العنوان بهيئة: “x-bot-token.
يمكنك أن تنشئ عدة طلبات لرابط الاستعادة طالما لم تنتهي صلاحية الرمز.
يجب لمحتوى الطلب أن يكون بهيئة بنفس محتوى رد الـAPI ويجب أن يحتوي هيدر الطلب على “x-bot-token”.
.