إذا كنت تبني وكيل Dialogflow يستخدم تنفيذ Dialogflow بشكل مكثف، ستجد البيانات المرسلة من موفر القناة مفيدة لتطبيقك. يتم تمرير هذه البيانات من النظام الأساسي respond.io إلى Dialogflow باستخدام الحقل originalDetectIntentRequest.
كائن الاتصال
للسماح لمزيد من حالات استخدام API المتقدمة، يتم إلحاق كائن جهة الاتصال بالطلب من قبل المنصة. عنصر cId في كائن جهة الاتصال يعكس نفس القيمة المستخدمة في API جهات الاتصال.
"جهة الاتصال": {
"معرف العميل": "60133386712"،
"معرف جهة الاتصال": 123456،
"معرف القناة": 7890
}"originalDetectIntentRequest": {
"payload": {
"source": "فيسبوك",
"contact": {
"cId": "3854977680200098",
"contactId": "123456",
"channelId": "7890"
},
"attachments": [
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"address": "مركز مدينة كوالالمبور"
}
}
],
"body": {
"entry": [
{
"messaging": [
{
"recipient": {
"id": "177689475607202"
},
"message": {
"text": "مرحبًا",
"mid": "D3DJuA0YlOgDgOybFG1M2ZHoJg9hq9IAjMQE2ps6RIN4QJ25rNPMi"
},
"timestamp": 1564743055901,
"sender": {
"id": "2254108171328398"
}
}
],
"id": "177689475607202",
"time": 1564743056313
}
],
"object": "page"
}
}
}LINE
"originalDetectIntentRequest": {
"payload": {
"source": "LINE" ،
"contact": {
"cId": "U905251b5f5759acde5e4788681c04269" ،
"contactId": 123456 ،
"channelId": 7890
} ،
"attachments": [
{
"type": "location" ،
"payload": {
"lat": 3.146642 ،
"long": 101.695847 ،
"address": "مركز مدينة كوالالمبور"
}
}
] ،
"body": {
"events": [
{
"type": "message" ،
"replyToken": "16a59224c65b4c5cbecedc4f3504599b" ،
"source": {
"userId": "U905251b5f5759bbde5e4788681c04170" ،
"type": "user"
} ،
"timestamp": 1593146060317 ،
"mode": "active" ،
"message": {
"type": "text" ،
"id": "12211455206333" ،
"text": "مرحبًا"
}
}
] ،
"destination": "U5698920083824716136c04633a9e1710"
}
}
}تويليو SMS
"originalDetectIntentRequest": {
"payload": {
"source": "Twilio" ،
"contact": {
"cId": "+12262120005" ،
"contactId": 123456 ،
"channelId": 7890
} ،
"attachments": [
{
"type": "location" ،
"payload": {
"lat": 3.146642 ،
"long": 101.695847 ،
"address": "مركز مدينة كوالالمبور"
}
}
] ،
"body": {
"ToCountry": "CA" ،
"ToState": "Ontario" ،
"SmsMessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b" ،
"NumMedia": "0" ،
"ToCity": "" ،
"FromZip": "" ،
"SmsSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b" ،
"FromState": "Ontario" ،
"SmsStatus": "تم الاستلام" ،
"FromCity": "سانت توماس" ،
"Body": "مرحبًا" ،
"FromCountry": "CA" ،
"To": "+12267022870" ،
"ToZip": "" ،
"NumSegments": "1" ،
"MessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b" ،
"AccountSid": "AC75bcf6cd15a35c46c6e5fa6d6dde6028" ،
"From": "+12262121015" ،
"ApiVersion": "2010-04-01"
}
}
}SMS MessageBird
"originalDetectIntentRequest": {
"payload": {
"source": "تطبيق الرسائل\_الطائر" ،
"contact": {
"cId": "16364923690"
} ،
"attachments": [
{
"type": "location" ،
"payload": {
"lat": 3.146642 ،
"long": 101.695847 ،
"address": "مركز مدينة كوالالمبور"
}
}
] ،
"body": {
"body": "مرحبًا" ،
"createdDatetime": "2020-06-26T07:51:30+00:00" ،
"date": "1593186690" ،
"date_utc": "1593157890" ،
"id": "6c4c8c58eb204e69ae7d07e309c5a11c" ،
"invocationId": "477a8bc9-a4ec-45db-98e0-3b982898945a" ،
"message": "مرحبًا" ،
"message_id": "026a4c0e38954e5684757ba1de645130" ،
"originator": "12267022870" ،
"payload": "مرحبًا" ،
"receiver": "12262121015" ،
"recipient": "12262121015" ،
"reference": "88003423322" ،
"sender": "12267022870"
}
}
}SMS Vonage
"originalDetectIntentRequest": {
"payload": {
"source": "nexmo" ،
"contact": {
"cId": "60133386712"
} ،
"body": {
"msisdn": "12012938397" ،
"to": "12012938397" ،
"messageId": "16000002AB5DBF42" ،
"text": "مرحبًا" ،
"نوع": "نص" ،
"keyword": "HI" ،
"api-key": "2787fb30" ،
"message-timestamp": "2020-04-27 09:00:08"
}
}
}تيليجرام
"originalDetectIntentRequest": {
"payload": {
"source": "تليجرام" ،
"contact": {
"cId": "928825753" ،
"contactId": 123456 ،
"channelId": 7890
} ،
"attachments": [
{
"type": "location" ،
"payload": {
"lat": 3.146642 ،
"long": 101.695847 ،
"address": "مركز مدينة كوالالمبور"
}
}
] ،
"body": {
"update_id": 68062810 ،
"message": {
"message_id": 358 ،
"from": {
"id": 921815852 ،
"is_bot": false ،
"first_name": "ليو" ،
"language_code": "en"
} ،
"chat": {
"id": 921815852 ،
"first_name": "ليو" ،
"type": "خاص"
} ،
"date": 1593415824 ،
"text": "مرحبًا"
}
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "twitter",
"contact": {
"cId": "800244779787258095",
"contactId": 123456,
"channelId": 7890
},
"body": {
"for\_user\_id": "800244779786258096",
"direct\_message\_events": \[
{
"type": "message\_create",
"id": "1277881813680091140",
"created\_timestamp": "1593505740934",
"message\_create": {
"target": {
"recipient\_id": "800244779786258096"
},
"sender\_id": "1236829623670812661",
"message\_data": {
"text": "مرحبًا",
"entities": {
"hashtags": \[\],
"symbols": \[\],
"user\_mentions": \[\],
"urls": \[\]
}
}
}
}
\],
"users": {
"1236829623670812661": {
"id": "1236829623670812661",
"created\_timestamp": "1583718145786",
"name": "leoawesome",
"screen\_name": "leoawesome21",
"protected": false,
"verified": false,
"followers\_count": 0,
"friends\_count": 1,
"statuses\_count": 0,
"profile\_image\_url": "http://abs.twimg.com/sticky/default\_profile\_images/default\_profile\_normal.png",
"profile\_image\_url\_https": "https://abs.twimg.com/sticky/default\_profile\_images/default\_profile\_normal.png"
},
"800244779786258096": {
"id": "800244779786258096",
"created\_timestamp": "1479628198125",
"name": "respond.io",
"screen\_name": "respond\_io",
"description": "https://t.co/8AN2CVzhwJ هو منصة رسائل الأعمال تربط العملاء من أي قناة بكل فريق.",
"url": "https://t.co/vE593YRZwo",
"protected": false,
"verified": false,
"followers\_count": 246,
"friends\_count": 23,
"statuses\_count": 1527,
"profile\_image\_url": "http://pbs.twimg.com/profile\_images/1250330944067653632/3KiCeUhc\_normal.jpg",
"profile\_image\_url\_https": "https://pbs.twimg.com/profile\_images/1250330944067653632/3KiCeUhc\_normal.jpg"
}
}
}
}
}Viber
"originalDetectIntentRequest": {
"payload": {
"source": "فايبر"،
"contact": {
"cId": "T1yTBK3PQTHAFchsDh1skA=="،
"contactId": 123456،
"channelId": 7890
}،
"attachments": [
{
"type": "location"،
"payload": {
"lat": 3.146642،
"long": 101.695847،
"address": "مركز مدينة كوالالمبور"
}
}
]،
"body": {
"event": "message"،
"timestamp": 1593420787910،
"chat_hostname": "BN-CHAT-14_"،
"message_token": 5458312086267550000،
"sender": {
"id": "T1yTBK3PQFGAGdhsDh1skA=="،
"name": "ليو"،
"avatar": "https://media-direct.cdn.viber.com/download_photo?dlid=tHBOJafTJ8WSwoFLCQ0x1lmS8RXeDXXyUVoAoLmmOGPIMprwqNCUO6BH3cG-VoAYd3WetLrBK4nP7C86ZN3MxG5T40A1lduzChAts-ULz0oO9l7FjW3bAYljiLyTGkYbaCRjcQ&fltp=jpg&imsz=0000"،
"language": "en"،
"country": "MY"،
"api_version": 8
}،
"message": {
"text": "مرحبًا"،
"type": "text"
}،
"silent": false
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "وي شات" ،
"contact": {
"cId": "ovYOJv8eZlJ5efKToATGeOk5hBQM" ،
"contactId": 123456 ،
"channelId": 7890
} ،
"attachments": [
{
"type": "location" ،
"payload": {
"lat": 3.146642 ،
"long": 101.695847 ،
"address": "مركز مدينة كوالالمبور"
}
}
] ،
"body": {
"xml": {
"ToUserName": [
"gh_5b17802cd972"
] ،
"FromUserName": [
"ovYOJv8eZlJ5evMToATGePk5hAQM"
] ،
"CreateTime": [
"1593421765"
] ،
"MsgType": [
"text"
] ،
"Content": [
"مرحبًا"
] ،
"MsgId": [
"22812312807562437"
]
}
}
}
}الدردشة عبر الويب
"originalDetectIntentRequest": {
"payload": {
"source": "دردشة الويب" ،
"contact": {
"cId": "e6507476-e507-4503-9652-bcde24e8ea88" ،
"contactId": 123456 ،
"channelId": 7890
} ،
"body": {
"sender": {
"id": "07f1e397-12a8-485b-a417-14d7e3837608" ،
"locale": "en_US"
} ،
"recipient": {
"id": "4db00a5db70efbb51a0cd6a6635918390dd1945a89ce77898ab66b82d5c15344"
} ،
"query": [
{
"type": "query" ،
"text": "مرحبًا"
}
]
}
}
}واتسآب API للأعمال
"originalDetectIntentRequest": {
"payload": {
"body": {
"object": "حساب واتساب للأعمال" ،
"entry": [
{
"changes": [
{
"value": {
"contacts": [
{
"wa_id": "60124438291" ،
"profile": {
"name": "شهزاد"
}
}
] ،
"metadata": {
"display_phone_number": "15550468615" ،
"phone_number_id": "106875742284151"
} ،
"messaging_product": "واتساب" ،
"messages": [
{
"id": "wamid.HBgLNjAxMjQ0MzgyOTEVAgASGBYzRUIwOTA1ODAxRUQ5MDAxOTI1QTcxAA==" ،
"type": "نص" ،
"from": "60124438291" ،
"timestamp": "1680061817" ،
"text": {
"body": "أخبرني بنكتة"
}
}
]
} ،
"field": "messages"
}
] ،
"id": "106024152370383"
}
]
} ،
"source": "whatsapp_business" ،
"contact": {
"cId": "60124438291" ،
"contactId": 38 ،
"channelId": 59
}
}
}واتسآب API السحابي
"originalDetectIntentRequest": {
"payload": {
"body": {
"entry": \[
{
"id": "106024152370383",
"changes": \[
{
"field": "messages",
"value": {
"messaging\_product": "whatsapp",
"messages": \[
{
"id": "wamid.HBgLNjAxMjQ0MzgyOTEVAgASGBYzRUIwMjM1OUQ4NkE4MUJDRDY1QkE0AA==",
"timestamp": "1680063507",
"text": {
"body": "أخبرني بنكتة"
},
"from": "60124438291",
"type": "text"
}
\],
"metadata": {
"display\_phone\_number": "15550468615",
"phone\_number\_id": "106875742284151"
},
"contacts": \[
{
"wa\_id": "60124438291",
"profile": {
"name": "Shahzad"
}
}
\]
}
}
\]
}
\],
"object": "whatsapp\_business\_account"
},
"contact": {
"cId": "60124438291",
"channelId": 45,
"contactId": 43
},
"source": "whatsapp\_cloud"
}
}"originalDetectIntentRequest": { "payload": { "source": "nexmo\_whatsapp", "contact": { "cId": "60133386712", "contactId": 123456, "channelId": 7890 }, "attachments": \[ { "type": "location", "payload": { "lat": 3.146642, "long": 101.695847، "address": "مركز مدينة كوالالمبور" } } \], "body": { "message_uuid": "2b53f909-1640-471f-a44d-e4cb9bd00c44", "to": { "type": "whatsapp", "number": "12012938397" }, "from": { "type": "whatsapp", "number": "60133285813" }, "timestamp": "2020-06-29T04:37:21.876Z", "message": { "content": { "type": "text", "text": "مرحبًا" } }, "direction": "وارد" } } }
"originalDetectIntentRequest": {
"payload": {
"source": "twilio_whatsapp" ،
"contact": {
"cId": "whatsapp:+60133385703" ،
"contactId": 123456،
"channelId": 7890
} ،
"attachments": [
{
"type": "location" ،
"payload": {
"lat": 3.146642 ،
"long": 101.695847 ،
"address": "مركز مدينة كوالالمبور"
}
}
] ،
"body": {
"SmsMessageSid": "SMb16231017683857d42ca62aafabcf205" ،
"NumMedia": "0" ،
"SmsSid": "SMb16231017683857d42ca62aafabcf205" ،
"SmsStatus": "تم الاستلام" ،
"Body": "مرحبًا" ،
"To": "whatsapp:+14155238886" ،
"NumSegments": "1" ،
"MessageSid": "SMb16231017683857d42ca62aafabcf205" ،
"AccountSid": "AC75bcf6cd15a35c46c6e5fa6d6dde6028" ،
"From": "whatsapp:+60144486813" ،
"ApiVersion": "2010-04-01"
}
}
}WhatsApp MessageBird
"originalDetectIntentRequest": {
"payload": {
"source": "message_bird_whatsapp" ،
"contact": {
"cId": "60133385712" ،
"contactId": 123456 ،
"channelId": 7890
} ،
"attachments": [
{
"type": "location" ،
"payload": {
"lat": 3.146642 ،
"long": 101.695847 ،
"address": "مركز مدينة كوالالمبور"
}
}
] ،
"body": {
"contact": {
"attributes": {} ،
"createdDatetime": "2020-05-18T03:02:01Z" ،
"customDetails": {} ،
"displayName": "60123376813" ،
"firstName": "" ،
"href": "https://contacts.messagebird.com/v2/contacts/32845951f19c43d0b4e3371df0da941a" ،
"id": "32845951f19c43d0b4e3371df0da941a" ،
"lastName": "" ،
"msisdn": 60123376813 ،
"updatedDatetime": "2020-05-18T03:02:01Z"
} ،
"conversation": {
"contactId": "32845951f19c43d0b4e3371df0da941a" ،
"createdDatetime": "2020-05-18T03:02:01Z" ،
"id": "64d59ed4cb4f419ca39114c292c1a597" ،
"lastReceivedDatetime": "2020-06-26T08:58:55.7451283Z" ،
"status": "نشط" ،
"updatedDatetime": "2020-06-25T08:59:30.877791342Z"
} ،
"message": {
"channelId": "f4b115e89415407ab2b97fe85ad3d191" ،
"content": {
"text": "مرحبًا"
} ،
"conversationId": "64d59ed4cb4f419ca39114c292c1a597" ،
"createdDatetime": "2020-06-26T08:58:55Z" ،
"direction": "received" ،
"from": "+60123376813" ،
"id": "91c8268bb72b412cab3b4080a974c5dc" ،
"platform": "whatsapp" ،
"status": "received" ،
"to": "+6531290788" ،
"type": "text" ،
"updatedDatetime": "2020-06-26T08:58:55.750324338Z"
} ،
"type": "message.created"
}
}
}
واتساب ڤوناج
"originalDetectIntentRequest": {
"payload": {
"source": "nexmo_whatsapp" ،
"contact": {
"cId": "60133386712" ،
"contactId": 123456 ،
"channelId": 7890
} ،
"attachments": [
{
"type": "location" ،
"payload": {
"lat": 3.146642 ،
"long": 101.695847 ،
"address": "مركز مدينة كوالالمبور"
}
}
] ،
"body": {
"message_uuid": "2b53f909-1640-471f-a44d-e4cb9bd00c44" ،
"to": {
"type": "whatsapp" ،
"number": "12012938397"
} ،
"from": {
"type": "whatsapp" ،
"number": "60133285813"
} ،
"timestamp": "2020-06-29T04:37:21.876Z" ،
"message": {
"content": {
"type": "text" ،
"text": "مرحبًا"
}
} ،
"direction": "incoming"
}
}
}"originalDetectIntentRequest": { "payload": { "source": "whatsapp\_360dialog"، "contact": { "cId": "60133386712"، "contactId": 123456، "channelId": 7890 }، "attachments": \[ { "type": "location"، "payload": { "lat": 3.146642، "long": 101.695847، "العنوان": "وسط مدينة كوالالمبور" } } \]، "النص": { "message\_uuid": "2b53f909-1640-471f-a44d-e4cb9bd00c44"، "إلى": { "النوع": "واتساب"، "الرقم": "12012938397" }، "من": { "النوع": "واتساب"، "الرقم": "60133285813" }، "الطابع الزمني": "2020-06-29T04:37:21.876Z"، "الرسالة": { "المحتوى": { "النوع": "نص"、 "نص": "مرحبًا" } }، "الاتجاه": "وارد" } } }
"originalDetectIntentRequest": {
"payload": {
"source": "message_pipe_whatsapp" ،
"contact": {
"cId": "60133386712" ،
"contactId": 123456 ،
"channelId": 7890
} ،
"attachments": [
{
"type": "location" ،
"payload": {
"lat": 3.146642 ،
"long": 101.695847 ،
"address": "مركز مدينة كوالالمبور"
}
}
] ،
"body": {
"environment": {
"app_id": "476"
},
"events": [
{
"name": "d360_whatsapp_message_in" ،
"properties": {
"stack_id": "85256128299" ،
"message_id": "IY2Cx8lhx0E0M" ،
"conversation_id": "K7SWYeCmed07C" ،
"type": "text" ،
"content": {
"body": "مرحبًا"
}
} ،
"timestamp": "1593502341000" ،
"id": "7a104e27-d4d2-4e5d-8c8a-c74f3ba8e6c1"
}
] ،
"device": {
"mdn": "60133286713" ،
"profile_name": "الأسد"
},
"recipient_id": "64f0699c-e005-409d-b177-6a975c61ba60"
}
}
}WhatsApp 360dialog v2
"originalDetectIntentRequest": {
"الحمولة": {
"المصدر": "360dialog\_whatsapp"،
"جهة الاتصال": {
"معرف العميل": "60133386712"،
"معرف جهة الاتصال": 123456،
"معرف القناة": 7890
}،
"المرفقات": \[
{
"النوع": "الموقع"،
"الحمولة": {
"خط العرض": 3.146642،
"طويل": 101.695847،
"عنوان": "مركز مدينة كوالالمبور"
}
}
\]،
"نص": {
"جهات الاتصال": \[
{
"الملف الشخصي": {
"الاسم": "جون دون"
},
"wa\_id": "923339883320"
}
\],
"الرسائل": \[
{
"من": "923339885509"،
"معرف": "ABEGkjM5iFUJAhDGiqsifkiyZkH6HzvBfO2m"،
"نص": {
"نص": "مرحبًا"
},
"الطابع الزمني": "1595240228"،
"النوع": "النص"
}
\]
}
}
}
الأسئلة الشائعة وحل المشكلات
تنسيق الحمولة غير مدعوم
أي حمولة غير مدعومة، مثل بطاقات مساعد جوجل، لن تظهر على المنصة وستتم تجاهلها من قبل Respond.io.
تنسيق الحمولة غير صحيح
تنسيقات الحمولة صارمة وأي قيم مفتاح مفقودة ستؤدي إلى نتائج غير مرغوب فيها، مثل عدم الظهور على المنصة، أو أن تظهر بشكل غير صحيح، إلخ.
فترة تأخير زمنية تزيد عن 5 ثواني
إذا كان لديك معايير تحقيق معقدة، مثل الاتصال ببعض الخدمات الخارجية التي تقوم بالاستعلامات قبل إرجاع استجابة، فعليك أخذ فترة التأخير الزمنية في الاعتبار كما هو موضح في وثائق Dialogflow هنا. يجب إرجاع الاستجابة خلال 5 ثوانٍ وإلا ستفشل الويب هوك ولن يتم إرجاع أي استجابة إلى DialogFlow وRespond.io.