Dialogflow: طلب Webhook للوفاء

إذا كنت تبني وكيل Dialogflow يستخدم تنفيذ Dialogflow بشكل مكثف، ستجد البيانات المرسلة من موفر القناة مفيدة لتطبيقك. يتم تمرير هذه البيانات من النظام الأساسي respond.io إلى Dialogflow باستخدام الحقل originalDetectIntentRequest.

كائن جهة الاتصال

للسماح لمزيد من حالات استخدام API المتقدمة، يتم إلحاق كائن جهة الاتصال بالطلب من قبل المنصة. عنصر cId في كائن جهة الاتصال يعكس نفس القيمة المستخدمة في API جهات الاتصال.

    "جهة الاتصال": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "channelId": 7890  
}

Facebook

"originalDetectIntentRequest": {  
    "payload": {  
      "source": "facebook",  
      "contact": {  
        "cId": "3854977680200098",  
        "contactId": "123456",  
        "channelId": "7890"  
      },  
      "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3.146642,  
            "long": 101.695847,  
            "address": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
      "النص": {  
        "الإدخال": \[  
          {  
            "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،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "النص": {  
      "إلى الدولة": "CA"،  
      "إلى الولاية": "أونتاريو"،  
      "معرف واجهة رسالة الرسائل القصيرة": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b"،  
      "عدد الوسائط": "0"،  
      "إلى المدينة": ""،  
      "من الرمز البريدي": ""،  
      "SmsSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b"،  
      "FromState": "أونتاريو"،  
      "SmsStatus": "تم الاستلام"،  
      "FromCity": "سانت توماس"،  
      "Body": "مرحبًا"،  
      "FromCountry": "CA"،  
      "To": "+12267022870"،  
      "ToZip": ""،  
      "NumSegments": "1"،  
      "MessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b"،  
      "معرف الحساب": "AC75bcf6cd15a35c46c6e5fa6d6dde6028"،  
      "من": "+12262121015"،  
      "إصدار واجهة برمجة التطبيقات": "2010-04-01"  
    }  
  }  
}

SMS MessageBird

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "message\_bird",  
    "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

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "nexmo",  
    "contact": {  
        "cId": "60133386712"  
    },  
    "body": {  
      "msisdn": "12012938397"،  
      "to": "12012938397"،  
      "messageId": "16000002AB5DBF42"،  
      "text": "مرحبًا"،  
      "type": "text"،  
      "keyword": "HI"،  
      "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،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "النص": {  
      "معرف التحديث": 68062810،  
      "الرسالة": {  
        "معرف الرسالة": 358،  
        "من": {  
          "معرف": 921815852،  
          "هو بوت": false،  
          "الاسم الأول": "ليو"،  
          "language\_code": "en"  
        }،  
        "chat": {  
          "id": 921815852،  
          "الاسم الأول": "ليو"،  
          "type": "خاص"  
        }،  
        "date": 1593415824،  
        "text": "مرحبًا"  
      }  
    }  
  }  
}

Twitter

"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": "ليو",

Viber

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "viber"،  
    "contact": {  
        "cId": "T1yTBK3PQTHAFchsDh1skA=="،  
        "contactId": 123456،  
        "channelId": 7890  
    }،  
    "attachments": \[  
        {  
          "type": "location"،  
          "payload": {  
            "lat": 3.146642،  
            "long": 101.695847،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "النص": {  
      "الحدث": "رسالة"،  
      "الطابع الزمني": 1593420787910،  
      "اسم مضيف الدردشة": "BN-CHAT-14\_"،  
      "رمز الرسالة": 5458312086267550000،  
      "المرسل": {  
        "معرف": "T1yTBK3PQFGAGdhsDh1skA=="،  
        "الاسم": "ليو"،  
        "الصورة الرمزية": "https://media-direct.cdn.viber.com/download\_photo?dlid=tHBOJafTJ8WSwoFLCQ0x1lmS8RXeDXXyUVoAoLmmOGPIMprwqNCUO6BH3cG-VoAYd3WetLrBK4nP7C86ZN3MxG5T40A1lduzChAts-ULz0oO9l7FjW3bAYljiLyTGkYbaCRjcQ&fltp=jpg&imsz=0000"،  
        "اللغة": "en"،  
        "البلد": "MY"،  
        "api\_version": 8  
      }،  
      "message": {  
        "text": "مرحبًا"،  
        "type": "نص"  
      }،  
      "silent": false  
    }  
  }  
}

WeChat

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "wechat",  
    "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": "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": "مرحبًا"  
        }  
      \]  
    }  
  }  
}

واتسآب API للأعمال

"originalDetectIntentRequest": {  
"payload": {  
"body": {  
"object": "whatsapp\_business\_account",  
"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": "text",  
"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،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "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": "تم الاستلام" ،  
        "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،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "النص": {  
      "message\_uuid": "2b53f909-1640-471f-a44d-e4cb9bd00c44"،  
      "إلى": {  
        "النوع": "واتساب"،  
        "الرقم": "12012938397"  
      }،  
      "من": {  
        "النوع": "واتساب"،  
        "الرقم": "60133285813"  
      }،  
      "الطابع الزمني": "2020-06-29T04:37:21.876Z"،  
      "الرسالة": {  
        "المحتوى": {  
          "النوع": "نص"،  
          "نص": "مرحبًا"  
        }  
      }،  
      "الاتجاه": "وارد"  
    }  
  }  
}

"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": {  
  "payload": {  
    "source": "360dialog_whatsapp",  
    "contact": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3.146642,  
            "long": 101.695847،  
            "address": "وسط مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "body": {  
      "contacts": \[  
        {  
          "profile": {  
            "name": "جون دون"  
          }،  
          "wa_id": "923339883320"  
        }  
      \]،  
      "messages": \[  
        {  
          "from": "923339885509"،  
          "id": "ABEGkjM5iFUJAhDGiqsifkiyZkH6HzvBfO2m"،  
          "text": {  
            "body": "مرحبًا"  
          }،  
          "timestamp": "1595240228"،  
          "type": "نص"  
        }  
      \]  
    }  
  }  
}

الأسئلة الشائعة واستكشاف الأخطاء

الحمولة غير مدعومة

لن تظهر أي حمولات غير مدعومة، مثل بطاقات مساعد جوجل على المنصة وسوف يتم تجاهلها من قبل respon.io.

تنسيق الحمولة غير صحيح

وأشكال الحمولة صارمة وأي قيم رئيسية مفقودة ستسفر عن نتائج غير مرغوب فيها، أي أنها لا تظهر على المنصة، وتظهر بشكل غير صحيح، وما إلى ذلك.

الوقت المتأخر أكثر من 5 ثوان

إذا كان لديك معايير تنفيذ معقدة، على سبيل المثال. الاتصال ببعض خدمات الطرف الثالث التي تقوم باستفسارات قبل إعادة الرد، ثم يجب عليك النظر في الوقت المتأخر كما هو مبين في الوثائق Dialogflow هنا. يجب إعادة الاستجابة في غضون 5 ثوان أو فشل الويهوك وإلا لن يعاد أي رد إلى DialogFlow و respon.io.