Nếu bạn đang xây dựng một Dialogflow Agent sử dụng Dialogflow Fulfillment rộng rãi, bạn sẽ thấy dữ liệu được nhà cung cấp kênh truyền qua hữu ích cho ứng dụng của mình. Dữ liệu này được truyền từ nền tảng respond.io đến Dialogflow bằng trường originalDetectIntentRequest.
Để cho phép sử dụng API ở nhiều trường hợp nâng cao hơn, đối tượng Liên hệ sẽ được nền tảng thêm vào yêu cầu. Mục cId trong đối tượng Liên hệ phản ánh cùng một giá trị được sử dụng trong API Liên hệ.
"liên hệ": {
"cId": "60133386712",
"contactId": 123456,
"channelId": 7890
}"originalDetectIntentRequest": {
"payload": {
"source": "facebook",
"contact": {
"cId": "3854977680200098",
"contactId": "123456",
"channelId": "7890"
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"địa chỉ": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"nội dung": {
"mục nhập": \[
{
"nhắn tin": \[
{
"người nhận": {
"id": "177689475607202"
},
"tin nhắn": {
"văn bản": "xin chào",
"giữa": "D3DJuA0YlOgDgOybFG1M2ZHoJg9hq9IAjMQE2ps6RIN4QJ25rNPMi"
},
"dấu thời gian": 1564743055901,
"người gửi": {
"id": "2254108171328398"
}
}
\],
"id": "177689475607202",
"thời gian": 1564743056313
}
\],
"đối tượng": "trang"
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "line",
"contact": {
"cId": "U905251b5f5759acde5e4788681c04269",
"contactId": 123456,
"channelId": 7890
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"dài": 101.695847,
"địa chỉ": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"nội dung": {
"sự kiện": \[
{
"loại": "tin nhắn",
"mã thông báo trả lời": "16a59224c65b4c5cbecedc4f3504599b",
"nguồn": {
"userId": "U905251b5f5759bbde5e4788681c04170",
"kiểu": "người dùng"
},
"dấu thời gian": 1593146060317,
"chế độ": "hoạt động",
"tin nhắn": {
"kiểu": "văn bản",
"id": "12211455206333",
"văn bản": "Xin chào"
}
}
\],
"điểm đến": "U5698920083824716136c04633a9e1710"
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "twilio",
"contact": {
"cId": "+12262120005",
"contactId": 123456,
"channelId": 7890
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"address": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"body": {
"ToCountry": "CA",
"ToState": "Ontario",
"SmsMessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b",
"NumMedia": "0",
"ToCity": "",
"FromZip": "",
"SmsSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b",
"FromState": "Ontario",
"SmsStatus": "đã nhận",
"FromCity": "St Thomas",
"Body": "Xin chào",
"FromCountry": "CA",
"To": "+12267022870",
"ToZip": "",
"NumSegments": "1",
"MessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b",
"AccountSid": "AC75bcf6cd15a35c46c6e5fa6d6dde6028",
"Từ": "+12262121015",
"ApiVersion": "2010-04-01"
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "message\_bird",
"contact": {
"cId": "16364923690"
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"address": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"body": {
"body": "Xin chào",
"createdDatetime": "2020-06-26T07:51:30+00:00",
"date": "1593186690",
"date\_utc": "1593157890",
"id": "6c4c8c58eb204e69ae7d07e309c5a11c",
"invocationId": "477a8bc9-a4ec-45db-98e0-3b982898945a",
"message": "Xin chào",
"message\_id": "026a4c0e38954e5684757ba1de645130",
"originator": "12267022870",
"payload": "Xin chào",
"receiver": "12262121015",
"receiver": "12262121015",
"reference": "88003423322",
"người gửi": "12267022870"
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "nexmo",
"contact": {
"cId": "60133386712"
},
"body": {
"msisdn": "12012938397",
"to": "12012938397",
"messageId": "16000002AB5DBF42",
"text": "Xin chào",
"type": "text",
"từ khóa": "CHÀO",
"api-key": "2787fb30",
"message-timestamp": "2020-04-27 09:00:08"
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "telegram",
"contact": {
"cId": "928825753",
"contactId": 123456,
"channelId": 7890
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"địa chỉ": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"nội dung": {
"cập nhật\_id": 68062810,
"tin nhắn": {
"tin nhắn\_id": 358,
"từ": {
"id": 921815852,
"là\_bot": false,
"tên\_đầu tiên": "Leo",
"language\_code": "en"
},
"chat": {
"id": 921815852,
"first\_name": "Leo",
"type": "private"
},
"date": 1593415824,
"text": "Xin chào"
}
}
}
}"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": "Chào",
"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 là nền tảng nhắn tin doanh nghiệp kết nối khách hàng từ bất kỳ kênh nào đến mọi nhóm.",
"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"
}
}
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "viber",
"contact": {
"cId": "T1yTBK3PQTHAFchsDh1skA==",
"contactId": 123456,
"channelId": 7890
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"dài": 101.695847,
"địa chỉ": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"nội dung": {
"sự kiện": "tin nhắn",
"dấu thời gian": 1593420787910,
"trò chuyện\_tên máy chủ": "BN-CHAT-14\_",
"tin nhắn\_mã thông báo": 5458312086267550000,
"người gửi": {
"id": "T1yTBK3PQFGAGdhsDh1skA==",
"tên": "Leo",
"hình đại diện": "https://media-direct.cdn.viber.com/download\_photo?dlid=tHBOJafTJ8WSwoFLCQ0x1lmS8RXeDXXyUVoAoLmmOGPIMprwqNCUO6BH3cG-VoAYd3WetLrBK4nP7C86ZN3MxG5T40A1lduzChAts-ULz0oO9l7FjW3bAYljiLyTGkYbaCRjcQ&fltp=jpg&imsz=0000",
"ngôn ngữ": "en",
"quốc gia": "MY",
"api\_version": 8
},
"message": {
"text": "Xin chào",
"type": "text"
},
"silent": false
}
}
}"originalDetectIntentRequest": {
"tải trọng": {
"nguồn": "wechat",
"liên hệ": {
"cId": "ovYOJv8eZlJ5efKToATGeOk5hBQM",
"contactId": 123456,
"channelId": 7890
},
"tệp đính kèm": \[
{
"loại": "vị trí",
"tải trọng": {
"vĩ độ": 3.146642,
"dài": 101.695847,
"địa chỉ": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"thân": {
"xml": {
"ToUserName": \[
"gh\_5b17802cd972"
\],
"FromUserName": \[
"ovYOJv8eZlJ5evMToATGePk5hAQM"
\],
"CreateTime": \[
"1593421765"
\],
"MsgType": \[
"text"
\],
"Content": \[
"Hi"
\],
"MsgId": \[
"22812312807562437"
\]
}
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "webchat",
"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": "Xin chào"
}
\]
}
}
}"originalDetectIntentRequest": {
"payload": {
"body": {
"object": "whatsapp\_business\_account",
"entry": \[
{
"changes": \[
{
"value": {
"contacts": \[
{
"wa\_id": "60124438291",
"profile": {
"name": "Shahzad"
}
}
\],
"siêu dữ liệu": {
"hiển thị\_số\_điện_thoại": "15550468615",
"số\_điện_thoại\_id": "106875742284151"
},
"sản_phẩm\_tin_nhắn": "whatsapp",
"tin_nhắn": \[
{
"id": "wamid.HBgLNjAxMjQ0MzgyOTEVAgASGBYzRUIwOTA1ODAxRUQ5MDAxOTI1QTcxAA==",
"loại": "văn bản",
"từ": "60124438291",
"dấu thời gian": "1680061817",
"văn bản": {
"nội dung": "Kể cho tôi một câu chuyện cười"
}
}
\]
},
"trường": "tin nhắn"
}
\],
"id": "106024152370383"
}
\]
},
"nguồn": "whatsapp\_business",
"liên hệ": {
"cId": "60124438291",
"contactId": 38,
"channelId": 59
}
}
}"originalDetectIntentRequest": {
"payload": {
"body": {
"entry": \[
{
"id": "106024152370383",
"changes": \[
{
"field": "messages",
"value": {
"messaging\_product": "whatsapp",
"messages": \[
{
"id": "wamid.HBgLNjAxMjQ0MzgyOTEVAgASGBYzRUIwMjM1OUQ4NkE4MUJDRDY1QkE0AA==",
"timestamp": "1680063507",
"text": {
"body": "Kể cho tôi một câu chuyện cười"
},
"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": "twilio\_whatsapp",
"contact": {
"cId": "whatsapp:+60133385703",
"contactId": 123456,
"channelId": 7890
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"dài": 101.695847,
"địa chỉ": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"nội dung": {
"SmsMessageSid": "SMb16231017683857d42ca62aafabcf205",
"NumMedia": "0",
"SmsSid": "SMb16231017683857d42ca62aafabcf205",
"SmsStatus": "đã nhận",
"Nội dung": "Xin chào",
"Gửi đến": "whatsapp:+14155238886",
"NumSegments": "1",
"MessageSid": "SMb16231017683857d42ca62aafabcf205",
"AccountSid": "AC75bcf6cd15a35c46c6e5fa6d6dde6028",
"Từ": "whatsapp:+60144486813",
"ApiVersion": "2010-04-01"
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "message\_bird\_whatsapp",
"contact": {
"cId": "60133385712",
"contactId": 123456,
"channelId": 7890
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"address": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"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"
},
"cuộc trò chuyện": {
"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": "Xin chào"
},
"conversationId": "64d59ed4cb4f419ca39114c292c1a597",
"createdDatetime": "2020-06-26T08:58:55Z",
"direction": "received",
"từ": "+60123376813",
"id": "91c8268bb72b412cab3b4080a974c5dc",
"nền tảng": "whatsapp",
"trạng thái": "đã nhận",
"đến": "+6531290788",
"loại": "văn bản",
"ngày giờ cập nhật": "2020-06-26T08:58:55.750324338Z"
},
"loại": "message.created"
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "nexmo\_whatsapp",
"contact": {
"cId": "60133386712",
"contactId": 123456,
"channelId": 7890
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"long": 101.695847,
"địa chỉ": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"nội dung": {
"tin nhắn\_uuid": "2b53f909-1640-471f-a44d-e4cb9bd00c44",
"đến": {
"loại": "whatsapp",
"số": "12012938397"
},
"từ": {
"loại": "whatsapp",
"số": "60133285813"
},
"dấu thời gian": "2020-06-29T04:37:21.876Z",
"tin nhắn": {
"nội dung": {
"loại": "văn bản",
"văn bản": "Xin chào"
}
},
"hướng": "đến"
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "message\_pipe\_whatsapp",
"contact": {
"cId": "60133386712",
"contactId": 123456,
"channelId": 7890
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"dài": 101.695847,
"địa chỉ": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"thân": {
"môi trường": {
"ứng dụng\_id": "476"
},
"sự kiện": \[
{
"tên": "d360\_whatsapp\_message\_in",
"thuộc tính": {
"ngăn xếp\_id": "85256128299",
"message\_id": "IY2Cx8lhx0E0M",
"conversation\_id": "K7SWYeCmed07C",
"type": "text",
"content": {
"body": "Xin chào"
}
},
"timestamp": "1593502341000",
"id": "7a104e27-d4d2-4e5d-8c8a-c74f3ba8e6c1"
}
\],
"thiết bị": {
"mdn": "60133286713",
"tên\_hồ sơ": "Leo"
},
"id\_người_nhận": "64f0699c-e005-409d-b177-6a975c61ba60"
}
}
}"originalDetectIntentRequest": {
"payload": {
"source": "360dialog\_whatsapp",
"contact": {
"cId": "60133386712",
"contactId": 123456,
"channelId": 7890
},
"attachments": \[
{
"type": "location",
"payload": {
"lat": 3.146642,
"dài": 101.695847,
"địa chỉ": "Trung tâm thành phố Kuala Lumpur"
}
}
\],
"nội dung": {
"liên hệ": \[
{
"hồ sơ": {
"tên": "John Don"
},
"wa\_id": "923339883320"
}
\],
"tin nhắn": \[
{
"từ": "923339885509",
"id": "ABEGkjM5iFUJAhDGiqsifkiyZkH6HzvBfO2m",
"văn bản": {
"nội dung": "Xin chào"
},
"dấu thời gian": "1595240228",
"loại": "văn bản"
}
\]
}
}
}
Bất kỳ dữ liệu nào không được hỗ trợ, ví dụ như thẻ Google Assistant, sẽ không xuất hiện trên nền tảng và sẽ bị respond.io bỏ qua.
Định dạng tải trọng rất nghiêm ngặt và bất kỳ giá trị khóa nào bị thiếu đều có thể dẫn đến kết quả không mong muốn, tức là không hiển thị trên nền tảng, hiển thị không đúng, v.v.
Nếu bạn có tiêu chí thực hiện phức tạp, ví dụ, kết nối với một số dịch vụ của bên thứ ba thực hiện truy vấn trước khi trả về phản hồi, thì bạn phải cân nhắc độ trễ thời gian như được mô tả trong tài liệu Dialogflow tại đây. Phản hồi cần được trả về trong vòng 5 giây, nếu không webhook sẽ không thành công và sẽ không có phản hồi nào được trả về DialogFlow và respond.io.
Bài viết liên quan 👩💻