جدول المحتويات
تدفق الاتصالات: تطبيق طلب Webhook
محدث بواسطة Susan Swier
إذا كنت تبني عامل تدفق حوار يستخدم تنفيذ تدفق الهاتفي على نطاق واسع، سوف تجد البيانات التي يمر بها موفر القناة مفيدة لتطبيقك. يتم تمرير هذه البيانات من النظام الأساسي respond.io إلى Dialogflow باستخدام الحقل originalDetectIntentRequest.
جهة الاتصال
للسماح لمزيد من حالات استخدام API المتقدمة، يتم إلحاق كائن جهة الاتصال بالطلب من قبل المنصة. عنصر cId في كائن جهة الاتصال يعكس نفس القيمة المستخدمة في API جهات الاتصال.
"اتصل": {
"cId": "60133386712",
"جهة الاتصال": 123456،
"قناة": 7890
}
فيسبوك
"originalDetectIntentRequest": {
"payload": {
"source": "facebook",
"contact": {
"cId": "3854977680200098",
"contactId": "123456",
"channelId": "7890"
},
"attachments": [
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"address": "Kuala Lumpur City Center"
}
}
],
"body": {
"entry": [
{
"messaging": [
{
"recipient": {
"id": "177689475607202"
},
"message": {
"text": "hi",
"mid": "D3DJuA0YlOgDgOybFG1M2ZHoJg9hq9IAjMQE2ps6RIN4QJ25rNPMi"
},
"timestamp": 1564743055901,
"sender": {
"id": "2254108171328398"
}
}
],
"id": "177689475607202",
"time": 1564743056313
}
],
"object": "page"
}
}
}
ليند
"originalDetectIntentRequest": {
"payload": {
"source": "line",
"contact": {
"cId": "U905251b5f5759acde5e4788681c04269",
"contactId": 123456,
"channelId": 7890
},
"attachments": [
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"address": "Kuala Lumpur City Center"
}
}
],
"body": {
"events": [
{
"type": "message",
"replyToken": "16a59224c65b4c5cbecedc4f3504599b",
"source": {
"userId": "U905251b5f5759bbde5e4788681c04170",
"type": "user"
},
"timestamp": 1593146060317,
"mode": "active",
"message": {
"type": "text",
"id": "12211455206333",
"text": "Hi"
}
}
],
"destination": "U5698920083824716136c04633a9e1710"
}
}
}
الرسائل القصيرة - توليو
"originalDetectIntentRequest": {
"payload": {
"source": "twilio",
"الاتصال": {
"cId": "+12262120005"،
"جهة اتصال"123456،
"channelId": 7890
}،
"المرفقات": [
{
"type": "location",
"الحمولة": {
"lat": 3. 46642,
"طول": 101. 95847،
"عنوان": "مركز مدينة كوالالمبور"
}
}
]،
"body": {
"ToCountry": "CA",
"ToState": "Ontario",
"SmsMessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b"،
"NumMedia": "0"،
"ToCity": ""،
"FromZip": ""،
"SmsSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b",
"FromState": "Ontario",
"SmsStatus": "تلقّى"،
"FromCity": "St Thomas",
"Body": "Hi"،
"FromCountry": "CA",
"إلى": "+12267022870"،
"ToZip": ""،
"أرقام": "1"،
"MessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b",
"AccountSid": "AC75bcf6cd15a35c46c6e5fa6d6dde6028",
"من": "+12262121015"،
"ApiVersion": "2010-04-01"
}
}
}
الرسائل القصيرة - رسالة الطيور
"originalDetectIntentRequest": {
"payload": {
"source": "message_bird",
"جهة اتصال": {
"cId": "16364923690"
}،
"المرفقات": [
{
"type": "site",
"الحمولة": {
"lat": 3. 46642,
"طويل": 101. 95847،
"عنوان": "مركز مدينة كوالالمبور"
}
}
]،
"body": {
"body": "Hi",
"تم إنشاء": "2020-06-26T07:51:30+00:00",
"تاريخ": "1593186690",
"date_utc": "1593157890",
"معرف": "6c4c8c58eb204e69ae7d07e309c5a11c",
"الاستناد": "477a8bc9-a4ec-45db-98e0-3b982898945a"،
"رسالة": "Hi",
"message_id": "026a4c0e38954e5684757ba1de6430"،
"المنشئ": "12267022870"،
"الحمولة": "Hi"،
"جهاز الاستقبال": "12262121015"،
"متلق": "12262121015"،
"المرجع": "88003423322"،
"المرسل": "12267022870"
}
}
}
الرسائل القصيرة - فترة الصباح
"originalDetectIntentRequest": {
"payload": {
"source": "nexmo",
"جهة اتصال": {
"cId": "60133386712"
}،
"body": {
"msisdn": "12012938397"،
"إلى": "12012938397"،
"رسالة": "16000002AB5DBF42"،
"النص": "Hi",
"نوع": "نص"،
"الكلمة الرئيسية": "HI"،
"api-key": "2787fb30",
"رسالة - توقيت": "2020-04-27 09:00:08"
}
}
}
تيليجرام
"originalDetectIntentRequest": {
"payload": {
"source": "برقية"،
"جهة اتصال": {
"cId": "928825753"،
"جهة اتصال"123456،
"channelId": 7890
}،
"المرفقات": [
{
"type": "location",
"الحمولة": {
"lat": 3. 46642,
"طول": 101. 95847،
"عنوان": "مركز مدينة كوالالمبور"
}
}
]،
"body": {
"update_id": 68062810،
"رسالة": {
"message_id": 358,
"من": {
"id": 921815852,
"is_bot": false,
"first_name": "Leo",
"language_code": "en"
}،
"دردشة": {
"id": 921815852,
"first_name": "Leo",
"نوع": "الخاص"
}،
"تاريخ": 1593415824،
"نص": "Hi"
}
}
}
}
تويتر
"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": "Hi",
"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 is a business messaging platform that connects customers from any channel to every team.",
"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": "viber",
"جهة اتصال": {
"cId": "T1yTBK3PQTHAFchsDh1skA=="،
"جهة اتصال"123456،
"channelId": 7890
}،
"المرفقات": [
{
"type": "location",
"الحمولة": {
"lat": 3. 46642,
"طول": 101. 95847،
"عنوان": "مركز مدينة كوالالمبور"
}
}
]،
"body": {
"event": "رسالة",
"timestamp": 1593420787910،
"Chat_hostname": "BN-CHAT-14_",
"message_token": 5458312086267550000,
"المرسل": {
"id": "T1yTBK3PQFGAGdhdh1skA=="،
"اسم": "ليو"،
"الصورة الرمزية": "https://media-direct. dn.viber om/download_photo؟ lid=tHBOJafTJ8WSwoFLCQ0x1lmS8RXeDXXyUVoAoLmmOGPIMprwqNCUO6BH3cG-VoAYd3WetLrBK4nP7C86ZN3MxG5T40A1lduzChAts-ULz0oO9l7FjW3bAYljiLyTGkYbaCRjcQ&fltp=jpg&imsz=0000"
لغة "لغة": "en",
"الدولة": "MY"،
"api_version": 8
}،
"رسالة": {
"نص": "Hi",
"نوع": "نص"
}،
"صامت": كاذب
}
}
}
"originalDetectIntentRequest": {
"payload": {
"source": "wechat",
"جهة اتصال": {
"cId": "ovYOJv8eZlJ5efKToATGeOk5hBQM"،
"جهة اتصال"123456،
"channelId": 7890
}،
"المرفقات": [
{
"type": "location",
"الحمولة": {
"lat": 3. 46642,
"طول": 101. 95847،
"عنوان": "مركز مدينة كوالالمبور"
}
}
]،
"body": {
"xml": {
"ToUserName": [
"gh_5b17802cd972"
]،
"FromUserName": [
"ovYOJv8eZlJ5evMToATGePk5hAQM"
]،
"CreateTime": [
"1593421765"
]،
"MsgType": [
"نص"
]،
"محتوى": [
"Hi"
]،
"MsgId": [
"228123807562437"
]
}
}
}
}
الدردشة
"originalDetectIntentRequest": {
"payload": {
"source": "webchat",
"الاتصال": {
"cId": "e6507476-e507-4503-9652-bcde24e8ea88"،
"جهة اتصال"123456،
"channelId": 7890
}،
"body": {
"sender": {
"id": "07f1e397-12a8-485b-a417-14d7e3837608",
"locale": "en_US"
}،
"المتلقي": {
"id": "4db00a5db70efb51a0cd6a6635918390dd1945a89ce77898ab66b82d5c15344"
},
"الاستفسار": [
{
"type": "query",
"النص": "Hi"
}
]
}
}
}
واتساب - توليو
"originalDetectIntentRequest": {
"payload": {
"source": "twilio_whatsapp"،
"contact": {
""whatsapp: +60133385703"،
"contactId": "،
"channelId": 7890
} ،
"مرفقًا": [
{
"نوع": "موقع"،
"حمولة": {
"خط عرض": 3.146642 ،
"بطول": 101.695847 ،
"عنوان": "مدينة كوالالمبور المركز"
}
}
]،
"body": {
"SmsMessageSid": "SMb16231017683857d42ca62aafabcf205""
"NumMedia": "0"، 64 "SmsSid 66: ""
":" "
"،
"Body": "Hi"،
"To": "whatsapp: +14155238886"،
"NumSegments": "1"،
"MessageSid": "SMb16231017683857d42ca62aafabcf205"،
"
": "" "من": "whatsapp: +60144486813"
"" "2010-04-01"}
}
}
واتساب - 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": "Kuala Lumpur City Center"
}
}
],
"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": "active",
"updatedDatetime": "2020-06-25T08:59:30.877791342Z"
},
"message": {
"channelId": "f4b115e89415407ab2b97fe85ad3d191",
"content": {
"text": "Hi"
},
"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",
"جهة اتصال": {
"cId": "60133386712"،
"جهة اتصال"123456،
"channelId": 7890
}،
"المرفقات": [
{
"type": "location",
"الحمولة": {
"lat": 3. 46642,
"طول": 101. 95847،
"عنوان": "مركز مدينة كوالالمبور"
}
}
]،
"body": {
"message_uuid": "2b53f909-1640-471f-a44d-e4cb9bd00c44",
"إلى": {
"type": "Whatsapp",
"عدد": "12012938397"
}،
"من": {
"type": "Whatsapp",
"عدد": "60133285813"
}،
"الوقت": "2020-06-29T04:37:21. 76Z"،
"رسالة": {
"محتوى": {
"نوع": "نص"،
"نص": "Hi"
}
},
"الاتجاه": "الوارد"
}
}
}
واتساب - واجهة برمجة التطبيقات للدردشة
"originalDetectIntentRequest": {
"payload": {
"source": "whatsapp",
"contact": {
"cId": "60132385803@c.us",
"contactId": 123456,
"channelId": 7890
},
"attachments": [
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"address": "Kuala Lumpur City Center"
}
}
],
"body": {
"messages": [
{
"id": "false_60133376613@c.us_4A4AE5DAA5601F0560C45E46C16186FE",
"body": "Hi",
"fromMe": false,
"self": 0,
"isForwarded": 0,
"author": "60133376613@c.us",
"time": 1593491156,
"chatId": "60133376613@c.us",
"messageNumber": 155,
"type": "chat",
"senderName": "Leo",
"caption": null,
"quotedMsgBody": null,
"quotedMsgId": null,
"chatName": "Leo"
}
],
"instanceId": "144708"
}
}
}
WhatsApp 360 Dialog v1
"originalDetectIntentRequest": {
"payload": {
"source": "message_pipe_whatsapp",
"contact": {
"cId": "60133386712",
"contactId": 123456,
"channelId": 7890
},
"attachments": [
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"address": "Kuala Lumpur City Center"
}
}
],
"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": "Hi"
}
},
"timestamp": "1593502341000",
"id": "7a104e27-d4d2-4e5d-8c8a-c74f3ba8e6c1"
}
],
"device": {
"mdn": "60133286713",
"profile_name": "Leo"
},
"recipient_id": "64f0699c-e005-409d-b177-6a975c61ba60"
}
}
}
WhatsApp 360 Dialog v2
"originalDetectIntentRequest": {
"payload": {
"source": "360dialog_whatsapp",
"جهة اتصال": {
"cId": "60133386712"،
"جهة اتصال"123456،
"channelId": 7890
}،
"المرفقات": [
{
"type": "location",
"الحمولة": {
"lat": 3. 46642,
"طول": 101. 95847،
"عنوان": "مركز مدينة كوالالمبور"
}
}
]،
"body": {
"جهة اتصال": [
{
"ملف": {
"name": "John Don"
},
"wa_id": "923339883320"
}
]،
"رسالة": [
{
"من": "923339885509"،
"معرف" "ABEGkjM5iFUJAhDGiqsifkiyZkH6HzvBfO2m"،
"النص": {
"body": "Hi"
}،
"timestamp": "1595240228",
"نوع": "نص"
}
]
}
}
}
استكشاف الأخطاء
الحمولة غير مدعومة
لن تظهر أي حمولات غير مدعومة، مثل بطاقات مساعد جوجل على المنصة وسوف يتم تجاهلها من قبل respon.io.
تنسيق الحمولة غير صحيح
وأشكال الحمولة صارمة وأي قيم رئيسية مفقودة ستسفر عن نتائج غير مرغوب فيها، أي أنها لا تظهر على المنصة، وتظهر بشكل غير صحيح، وما إلى ذلك.
الوقت المتأخر أكثر من 5 ثوان
إذا كان لديك معايير تنفيذ معقدة، على سبيل المثال. الاتصال ببعض خدمات الطرف الثالث التي تقوم باستفسارات قبل إعادة الرد، ثم يجب عليك النظر في الوقت المتأخر كما هو موضح في وثائق تدفق الحوار هنا. يجب إعادة الاستجابة في غضون 5 ثوان أو فشل الويهوك وإلا لن يعاد أي رد إلى DialogFlow و respon.io.