تدفق الاتصالات: تطبيق طلب Webhook

إذا كنت تبني عامل تدفق حوار يستخدم Falogflow Implementation على نطاق واسع، سوف تجد البيانات التي يمر بها موفر القناة مفيدة لتطبيقك. يتم تمرير هذه البيانات من النظام الأساسي 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،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
      "النص": {  
        "الإدخال": \[  
          {  
            "الرسالة": \[  
              {  
                "المستلم": {  
                  "المعرف": "177689475607202"  
                }،  
                "الرسالة": {  
                  "النص": "مرحبًا"،  
                  "منتصف": "D3DJuA0YlOgDgOybFG1M2ZHoJg9hq9IAjMQE2ps6RIN4QJ25rNPMi"  
                },  
                "الطابع الزمني": 1564743055901,  
                "المرسل": {  
                  "المعرف": "2254108171328398"  
                }  
              }  
            \],  
            "المعرف": "177689475607202",  
            "الوقت": 1564743056313  
          }  
        \],  
        "كائن": "صفحة"  
      }  
    }  
}

LINE

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "line",  
    "contact": {  
        "cId": "U905251b5f5759acde5e4788681c04269",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3.146642,  
            "طويل": 101.695847،  
            "عنوان": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "نص": {  
      "أحداث": \[  
        {  
          "نوع": "رسالة"،  
          "رمز الرد": "16a59224c65b4c5cbecedc4f3504599b"،  
          "مصدر": {  
            "معرف المستخدم": "U905251b5f5759bbde5e4788681c04170",  
            "النوع": "مستخدم"  
          },  
          "الطابع الزمني": 1593146060317,  
          "الوضع": "نشط",  
          "الرسالة": {  
            "النوع": "نص",  
            "المعرّف": "12211455206333",  
            "نص": "مرحبًا"  
          }  
        }  
      \],  
      "الوجهة": "U5698920083824716136c04633a9e1710"  
    }  
  }  
}

توليو SMS

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

SMS MessageBird

"originalDetectIntentrequest": {  
  "payload": {  
    "المصدر": "message\_bird",  
    "جهة الاتصال": {  
        "cId": "16364923690"  
    }،  
    "المرفقات": \[  
        {  
          "النوع": "الموقع"،  
          "payload": {  
            "lat": 3. 46642,  
            "الطول": 101. 95847،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
  
      \]  
    "هيئة": {  
      "هيئة": "مرحباً"،  
      "تم إنشاؤه": "2020-06-26T07:51:30+00:00",  
      "التاريخ": "1593186690",  
      "date\_utc": "1593157890",  
      "id": "6c4c8c58eb204e69ae7d07e309c5a11c",  
      "invocationId": "477a8bc9-a4ec-45db-98e0-3b989898945a",  
      "رسالة": "مرحباً"،  
      "رسالة\_id": "026a4c0e38954e5684757ba1de645130"،  
      "المنشئ": "12267022870",  
      "payload": "مرحبا"،  
      "حارس الاستقبال": "12262121015"،  
      "متلقي": "12262121015"،  
      "المرجع": "88003423322"،  
      "المرسل": "12267022870"  
    }  
  
}

صالة SMS

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "nexmo",  
    "contact": {  
        "cId": "60133386712"  
    },  
    "body": {  
      "msisdn": "12012938397",  
      "to": "12012938397",  
      "messageId": "16000002AB5DBF42",  
      "text": "مرحبًا",  
      "type": "text",  
      "keyword": "مرحبًا"،  
      "مفتاح واجهة برمجة التطبيقات": "2787fb30"،  
      "طابع زمني للرسالة": "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،  
          "هو بوت": خطأ،  
          "الاسم الأول": "ليو"،  
          "language\_code": "en"  
        },  
        "chat": {  
          "id": 921815852,  
          "first\_name": "Leo",  
          "type": "private"  
        },  
        "date": 1593415824,  
        "text": "Hi"  
      }  
    }  
  }  
}

Twitter

"originalDetectIntentrequest": {  
  "payload": {  
    "المصدر": "twitter",  
    "اتصال": {  
        "cId": "800244779787258095",  
        "جهة الاتصال": 123456،  
        "channelId": 7890  
    }،  
    "الهيئة": {  
      "for\_user\_id": "800244779786258096",  
      "direct\_message\_events": \[  
        {  
          "type": "message\_create",  
          "معرف": "1277881813680091140"،  
          "إنشاء\_timestamp": "1593505740934",  
          "message\_create": {  
            "target": {  
              "recipient\_id": "800244779786258096"  
            }،  
            "sender\_id": "1236829623670812661"،  
            "message\_data": {  
              "text": "مرحباً"،  
              "الكيانات": {  
                "Hashtags": \[\]  
                "الرموز": \[\]  
                "user\_mentions": \[\]،  
                "urls": \[\]  
  
            }  
  
  
      \]،  
      "المستخدمون": {  
        "1236829623670812661": {  
          "id": "1236829623670812661",  
          "created\_timestamp": "1583718145786",  
          "الاسم": "ليواويزوم"،  
          "الشاشة\_name": "leoawesome21",  
          "محمية": خاطئ،  
          "تحقق": خاطئ،  
          "متابعون\_count": 0،  
          "الأصدقاء\_count": 1،  
          "الحالات\_count": 0،  
          "profile\_image\_url": "http://abs. wimg.com/sticky/default\_profile\_images/default\_profile\_normal.png",  
          "profile\_image\_url\_https": "https://abs.twimg.com/sticky/default\_profile\_images/default\_profile\_normal. ن غ"  
        }،  
        "800244779786258096": {  
          "id": "800244779786258096"،  
          "created\_timestamp": "1479628198125",  
          "name": "respond. o",  
          "الشاشة\_name": "respond\_io",  
          "وصف": "https://t. o/8AN2CVzhwJ هو منصة الرسائل التجارية التي تربط العملاء من أي قناة إلى كل فريق. ,  
          "url": "https://t. o/vE593YRZwo",  
          "محمية": خطأ،  
          "تم التحقق": خاطئ،  
          "متابعون\_count": 246،  
          "الأصدقاء\_count": 23،  
          "الحالات\_count": 1527،  
          "profile\_image\_url": "http://pbs. wimg.com/profile\_images/1250330944067653632/3KiCeUhc\_normal.jpg",  
          "profile\_image\_url\_https": "https://pbs.twimg. om/profile\_images/1250330944067653632/3KiCeUhc\_normal. ج"  
  
  
  
  
}

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",  
        "البلد": "بلدي",  
        "api\_version": 8  
      },  
      "message": {  
        "text": "مرحبًا"،  
        "type": "text"  
      },  
      "silent": false  
    }  
  }  
}

WeChat

"originalDetectIntentrequest": {  
  "payload": {  
    "المصدر": "wechat",  
    "جهة الاتصال": {  
        "cId": "ovYOJv8eZlJ5efKToATGeOk5hBQM",  
        "جهة الاتصال": 123456،  
        "channelId": 7890  
    }،  
    "الملحقات": \[  
        {  
          "النوع": "الموقع"،  
          "payload": {  
            "lat": 3. 46642,  
            "الطول": 101. 95847،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
  
      \]،  
    "الجسم": {  
      "xml": {  
        "ToUserName": \[  
          "gh\_5b17802cd972"  
        \]  
        "FromUserName": \[  
          "ovYOJv8eZlJ5evMToATGePk5hAQM"  
        \]  
        "CreateTime": \[  
          "1593421765"  
        \]،  
        "MsgTpe": \[  
          "text"  
        \]،  
        "المحتوى": \[  
          "Hi"  
        \]،  
        "MsgId": \[  
          "22812312807562437"  
        \]  
  
  
  
 A}

الدردشة

"originalDetectIntentrequest": {  
  "payload": {  
    "المصدر": "webchat",  
    "جهة الاتصال": {  
        "cId": "e6507476-e507-4503-9652-bcde24e8ea88",  
        "جهة الاتصال": 123456،  
        "channelId": 7890  
    }،  
    "الهيئة": {  
      "sender": {  
        "id": "07f1e397-12a8-485b-a417-14d7e3837608"،  
        "locale": "en\_US"  
      }،  
      "متلقي": {  
        "id": "4db00a5db70efb51a0cd6a6635918390dd1945a89ce77898ab66b82d5c15344"  
      }،  
      "استفسار": \[  
        {  
          "نوع": "استفسار"،  
          "النص": "Hi"  
  
      \]  
    }  
  
}

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

"originalDetectIntentRequest": {  
"payload": {  
"body": {  
"object": "whatsapp\_business\_account",  
"entry": \[  
{  
"changes": \[  
{  
"value": {  
"contacts": \[  
{  
"wa\_id": "60124438291",  
"profile": {  
"name": "شهزاد"  
}  
}  
\],  
"البيانات الوصفية": {  
"عرض رقم الهاتف": "15550468615",  
"رقم الهاتف": "106875742284151"  
},  
"منتج الرسائل": "واتساب",  
"الرسائل": \[  
{  
"المعرف": "wamid.HBgLNjAxMjQ0MzgyOTEVAgASGBYzRUIwOTA1ODAxRUQ5MDAxOTI1QTcxAA==",  
"النوع": "نص",  
"من": "60124438291"،  
"الطابع الزمني": "1680061817"،  
"النص": {  
"النص": "أخبرني نكتة"  
}  
}  
\]  
}،  
"الحقل": "الرسائل"  
}  
\]،  
"المعرّف": "106024152370383"  
}  
\]  
}،  
"المصدر": "واتساب\_أعمال"،  
"جهة الاتصال": {  
"معرف العميل": "60124438291"،  
"معرف جهة الاتصال": 38،  
"معرف القناة": 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": "شهاد"  
                                            }  
                                        }  
                                    \]  
                                }  
                            }  
                        \]  
                    }  
                \],  
                "object": "whatsapp\_business\_account"  
            },  
            "contact": {  
                "cId": "60124438291",  
                "channelId": 45,  
                "contactId": 43  
            },  
            "source": "whatsapp\_cloud"  
        }  
    }

تويليو واتساب

"originalDetectIntentrequest": {  
  "payload": {  
    "المصدر": "twilio\_whatsapp",  
    "جهة الاتصال": {  
        "cId": "Whatsapp:+60133385703",  
        "جهة الاتصال": 123456،  
        "channelId": 7890  
    }،  
    "الملحقات": \[  
        {  
          "النوع": "الموقع"،  
          "payload": {  
            "lat": 3. 46642,  
            "الطول": 101. 95847،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
  
      \]،  
    "الجسم": {  
      "SmsMessageSid": "SMb16231017683857d42ca62aafabcf205",  
      "NumMedia": "0",  
      "SmsSid": "SMb16231017683857d42ca62aafcf205",  
      "SmsStatus": "تلقى"،  
      "الجسم": "مرحباً"،  
      "إلى": "Whatsapp:+14155238886"،  
      "الأرقام": "1"،  
      "MessageSid": "SMb16231017683857d42ca62aafcf205",  
      "AccountSid": "AC75bcf6cd15a35c46c6e5fa6dde6028",  
      "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،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "النص": {  
      "جهة الاتصال": {  
        "السمات": {}،  
        "تاريخ الإنشاء": "2020-05-18T03:02:01Z"،  
        "تفاصيل مخصصة": {}،  
        "اسم العرض": "60123376813"،  
        "الاسم الأول": ""،  
        "href": "https://contacts.messagebird.com/v2/contacts/32845951f19c43d0b4e3371df0da941a",  
        "id": "32845951f19c43d0b4e3371df0da941a",  
        "lastName": "",  
        "msisdn": 60123376813,  
        "updatedDatetime": "2020-05-18T03:02:01Z"  
      },  
      "conversation": {  
        "contactId": "32845951f19c43d0b4e3371df0da941a",  
        "تاريخ الإنشاء": "2020-05-18T03:02:01Z",  
        "المعرف": "64d59ed4cb4f419ca39114c292c1a597",  
        "تاريخ الاستلام الأخير": "2020-06-26T08:58:55.7451283Z",  
        "الحالة": "نشط",  
        "تاريخ التحديث": "2020-06-25T08:59:30.877791342Z"  
      },  
      "الرسالة": {  
        "معرف القناة": "f4b115e89415407ab2b97fe85ad3d191",  
        "المحتوى": {  
          "النص": "مرحبًا"  
        },  
        "معرف المحادثة": "64d59ed4cb4f419ca39114c292c1a597",  
        "تاريخ الإنشاء": "2020-06-26T08:58:55Z",  
        "الاتجاه": "تم الاستلام",  
        "من": "+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،  
            "العنوان": "وسط مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "النص": {  
      "الرسالة\_uuid": "2b53f909-1640-471f-a44d-e4cb9bd00c44"،  
      "إلى": {  
        "النوع": "واتساب"،  
        "الرقم": "12012938397"  
      }،  
      "من": {  
        "النوع": "واتساب"،  
        "الرقم": "60133285813"  
      }،  
      "الطابع الزمني": "2020-06-29T04:37:21.876Z"،  
      "الرسالة": {  
        "المحتوى": {  
          "النوع": "نص"،  
          "نص": "مرحبًا"  
        }  
      }،  
      "الاتجاه": "وارد"  
    }  
  }  
}

WhatsApp 360dialog v1

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "message\_pipe\_whatsapp",  
    "contact": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3.146642,  
            "long": 101.695847،  
            "العنوان": "مركز مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "الجسم": {  
      "البيئة": {  
        "معرف التطبيق": "476"  
      }،  
      "الأحداث": \[  
        {  
          "الاسم": "d360\_whatsapp\_message\_in"،  
          "الخصائص": {  
            "معرف المكدس": "85256128299"،  
            "معرّف الرسالة": "IY2Cx8lhx0E0M"،  
            "معرّف المحادثة": "K7SWYeCmed07C"،  
            "النوع": "نص"،  
            "المحتوى": {  
              "النص": "مرحبًا"  
            }  
          }،  
          "الطابع الزمني": "1593502341000"،  
          "المعرّف": "7a104e27-d4d2-4e5d-8c8a-c74f3ba8e6c1"  
        }  
      \]،  
      "الجهاز": {  
        "mdn": "60133286713"،  
        "اسم الملف الشخصي": "ليو"  
      }،  
      "معرف المستلم": "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،  
            "العنوان": "وسط مدينة كوالالمبور"  
          }  
        }  
      \]،  
    "النص": {  
      "جهات الاتصال": \[  
        {  
          "الملف الشخصي": {  
            "الاسم": "جون دون"  
          }،  
          "wa\_id": "923339883320"  
        }  
      \]،  
      "الرسائل": \[  
        {  
          "من": "923339885509"،  
          "معرف": "ABEGkjM5iFUJAhDGiqsifkiyZkH6HzvBfO2m"،  
          "نص": {  
            "نص": "مرحبًا"  
          }،  
          "طابع زمني": "1595240228"،  
          "نوع": "نص"  
        }  
      \]  
    }  
  }  
}

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

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

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

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

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

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

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