تنسيق الاستجابة لإرسال الرسائل الديناميكية:

{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text"
},
{
...Another messages
}
],
"actions": [ //optional
{
"action": "add_tag",
"tag_name": "example tag"
},
{
...Another actions
}
],
"quick_replies": [ //optional
{
"type": "node",
"caption": "Quick reply text",
"target": "My Content"
},
{
...Another quick replies
}
]
}
}

واجهة برمجة تطبيقات الكتل الديناميكية الإصدار v1 الحالي للكتلة الديناميكية حد لا يزيد عن 10 رسائل في messages الكتلة، و11 ردا سريعا و5 إجراءات. "buttons"خصائص ، "actions"، "quick_replies" اختيارية.

url, call, node

{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text with button",
"buttons": [
{
"type": "url",
"caption": "Show",
"url": "https://NewAge Ai.au" //valid url
},
{
"type": "call",
"caption": "Show",
"phone": "+61412345678" //phone number E164
},
{
"type": "node",
"caption": "Show",
"target": "My Content" //Node name
}
]
}
]
}
}

استخدم هذا الرد لإرسال الرسائل النصية.

يمكن استخدام أزرار url، flow، و node مع الرسائل النصية.

الخصائص "buttons"، "actions"، و "quick_replies" اختيارية.

{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text with button",
"buttons": [
{
"type": "url",
"caption": "External link",
"url": "https://NewAge Ai.com.au"
}
]
}
],
"actions": [],
"quick_replies": []
}
}

إرسال الرسائل كرد على معرف الرسالة السابقة (القنوات المتاحة: فيسبوك، واتساب، تيك توك)

{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "text one reply to message",
"reply_to_mid": "m_5rqZy3-yriLwL9zUjT"
},
{
"type": "text",
"text": "text two"
},
{
"type": "text",
"text": "text three reply to another message",
"reply_to_mid": "m_X98YmVGhuSSrsBoh9t"
}
]
}
}

يستخدم هذا الرد لإرسال ملفات الصور. يدعم Messenger صور JPG وPNG وGIF. يمكنك استخدام url، call، buy، flow و node الأزرار.

الخصائص "buttons"، "actions"، و "quick_replies" اختيارية.

{
"version": "v1",
"content": {
"messages": [
{
"type": "image",
"url": "https://image.amazonaws.com/ca/xxxxxxzzzzzzzzz.png"
}
],
"actions": [],
"quick_replies": []
}
}

إرسال عدة صور (فيسبوك فقط)

{
"version": "v1",
"content": {
"messages": [
{
"type": "files",
"items": [
{"type": "image", "url": "https://image.amazonaws.com/ca/aaaa.png"},
{"type": "image", "url": "https://image.amazonaws.com/ca/bbbb.png"}
]
}
]
}
}

استخدم هذا الرد لإضافة وسم إلى جهة اتصال. يجب أن توجد وسم بنفس الاسم في روبوتك.

{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text"
}
],
"actions": [
{
"action": "add_tag",
"tag_name": "your tag",
}
],
"quick_replies": []
}
}

يجب أن يتطابق اسم الوسم المرسل باستخدام المعلمة tag_name مع أحد الوسوم الموجودة

استخدم هذا الرد لتعيين قيمة حقل المستخدم المخصص لمستخدم البوت. يجب أن يوجد حقل مخصص بنفس الاسم في روبوتك.

{
"version": "v1",
"content": {
"messages": [
{
"type": "text",
"text": "simple text"
}
],
"actions": [
{
"action": "set_field_value",
"field_name": "your field name",
"value": "some value"
}
],
"quick_replies": []
}
}

يجب أن يتطابق اسم الملف المرسل باستخدام field_name الروبوت. تحتاج إلى التحكم في نوع البيانات المسجل في الحقول المخصصة، ويجب أن يتطابق نوع البيانات مع نوع الحقل المخصص.