Диалогпоток: Запрос на заполнение Webhook

Если вы создаете Агент Диалога, который активно использует Выполнение Диалога , вы найдете данные, которые переданы поставщиком каналов, полезные для вашего приложения. Эти данные передаются из платформы respond.io в Диалог с помощью поля originalDetectIntentRequest.

Контактный объект

Чтобы разрешить более продвинутые варианты использования API, контактный объект добавляется к запросу платформы. Элемент CId в объекте Контакта отражает то же значение, которое используется в API Контактов.

    "contact": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "channelId": 7890  
}

Facebook

"originalDetectIntentRequest": {  
    "payload": {  
      "source": "facebook",  
      "contact": {  
        "cId": "3854977680200098",  
        "contactId": "123456",  
        "channelId": "7890"  
      },  
      "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3. 46642,  
            "длинна": 101. 95847,  
            "Адрес": "Куала-Лумпур центр города"  
          }  
        }  
      \],  
      "body": {  
        "entry": \[  
          {  
            "messaging": \[  
              {  
                "recipient": {  
                  "id": "177689475607202"  
                },  
                "message": {  
                  "text": "hi",  
                  "mid": "D3DJuA0YlOgDgOybFG1M2ZHoJg9hq9IAjMQE2ps6RIN4QJ25rNPMi"  
                },  
                "timestamp": 1564743055901,  
                "sender": {  
                  "id": "2254108171328398"  
                }  
              }  
            \],  
            "id": "177689475607202",  
            "time": 1564743056313  
          }  
        \],  
        "объект": "страница"  
      }  
    }  
}

LINE

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "line",  
    "contact": {  
        "cId": "U905251b5f5759acde5e4788681c04269",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3. 46642,  
            "длинна": 101. 95847,  
            "Адрес": "Куала-Лумпур центр города"  
          }  
        }  
      \],  
    "body": {  
      "events": \[  
        {  
          "type": "message",  
          "replyToken": "16a59224c65b4c5cbecedc4f3504599b",  
          "source": {  
            "userId": "U905251b5f5759bbde5e4788681c04170",  
            "type": "user"  
          },  
          "timestamp": 1593146060317,  
          "режим": "активный",  
          "message": {  
            "type": "text",  
            "id": "12211455206333",  
            "текст": "Привет"  
          }  
        }  
      \],  
      "Местоположение": "U5698920083824716136c04633a9e1710"  
    }  
  }  
}

Твилио SMS

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "twilio",  
    "contact": {  
        "cId": "+12262120005",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "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": "Привет",  
      "FromCountry": "CA",  
      "К": "+12267022870",  
      "ToZip": "",  
      "NumSegments": "1",  
      "MessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b",  
      "AccountSid": "AC75bcf6cd15a35c46c6e5fa6d6dde6028",  
      "От": "+12262121015",  
      "ApiVersion": "2010-04-01"  
    }  
  }  
}

SMS-сообщение

"originalDetectIntentRequest": {  
  "полезная нагрузка": {  
    "источник": "сообщение\_bird",  
    "контакт": {  
        "cId": "16364923690"  
    },  
    "вложения": \[  
        {  
          "тип": "местоположение",  
          "полезная нагрузка": {  
            "lat": 3.146642,  
            "long": 101.695847,  
            "адрес": "Центр города Куала-Лумпур"  
          }  
        }  
      \],  
    "body": {  
      "body": "Привет",  
      "createdDatetime": "2020-06-26T07:51:30+00:00",  
      "date": "1593186690",  
      "date\_utc": "1593157890",  
      "id": "6c4c8c58eb204e69ae7d07e309c5a11c",  
      "invocationId": "477a8bc9-a4ec-45db-98e0-3b982898945a",  
      "сообщение": "Привет",  
      "сообщение\_id": "026a4c0e38954e5684757ba1de645130",  
      "отправитель": "12267022870",  
      "полезная нагрузка": "Привет",  
      "получатель": "12262121015",  
      "получатель": "12262121015",  
      "ссылка": "88003423322",  
      "отправитель": "12267022870"  
    }  
  }  
}

SMS Vonage

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "nexmo",  
    "contact": {  
        "cId": "60133386712"  
    },  
    "body": {  
      "msisdn": "12012938397",  
      "до": "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. 46642,  
            "длинна": 101. 95847,  
            "Адрес": "Куала-Лумпур центр города"  
          }  
        }  
      \],  
    "body": {  
      "update\_id": 68062810,  
      "message": {  
        "message\_id": 358,  
        "от": {  
          "id": 921815852,  
          "is\_bot": false,  
          "first\_name": "Leo",  
          "language\_code": "ru"  
        },  
        "Чат": {  
          "id": 921815852,  
          "first\_name": "Leo",  
          "type": "private"  
        },  
        "date": 1593415824,  
        "Текст": "Привет"  
      }  
    }  
  }  
}

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"  
            },  
            "отправитель\_id": "1236829623670812661",  
            "message\_data": {  
              "text": "Привет",  
              "entities": {  
                "hashtags": \[\],  
                "символы": \[\],  
                "user\_mentions": \[\],  
                "urls": \[\]  
              }  
            }  
          }  
        }  
      \],  
      "пользователей": {  
        "1236829623670812661": {  
          "id": "1236829623670812661",  
          "created\_timestamp": "1583718145786",  
          "name": "leoawesome",  
          "screen\_name": "leoawesome21",  
          "protected": false,  
          "проверено": false,  
          "Следователи\_count": 0,  
          "Друзья\_count": 1,  
          "statuses\_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. ng"  
        },  
        "800244779786258096": {  
          "id": "800244779786258096",  
          "created\_timestamp": "1479628198125",  
          "имя": "ответил. о",  
          "screen\_name": "respond\_io",  
          "description": "https://t. o/8AN2CVzhwJ - платформа для обмена сообщениями, которая соединяет клиентов из любого канала с каждой командой. ,  
          "url": "https://t. o/vE593YRZwo",  
          "защищено": false,  
          "проверено": false,  
          "последователи\_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. pg"  
        }  
      }  
    }  
  }  
}

Viber

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "viber",  
    "contact": {  
        "cId": "T1yTBK3PQTHAFchsDh1skA==",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3. 46642,  
            "длинна": 101. 95847,  
            "Адрес": "Куала-Лумпур центр города"  
          }  
        }  
      \],  
    "body": {  
      "event": "message",  
      "timestamp": 1593420787910,  
      "chat\_hostname": "BN-CHAT-14\_",  
      "message\_token": 5458312086267550000,  
      "sender": {  
        "id": "T1yTBK3PQFGdhsDh1skA==",  
        "name": "Лео",  
        "avatar": "https://media-direct. dn.viber. om/download\_photo? lid=tHBOJafTJ8WSwoFLCQ0x1lmS8RXeDXXyUVoAoLmOGPIMprwqNCUO6BH3cG-VoAYd3WetLrBK4nP7C86ZN3MxG5T40A1lduzChAts-ULz0oO9l7FjW3bAYljiLyTGkYbaCRjcQ&fltp=jpg&imsz=000000",  
        "язык": "ru",  
        "Страна": "MY",  
        "api\_version": 8  
      },  
      "message": {  
        "text": "Привет",  
        "type": "text"  
      },  
      "Тишина": ложная  
    }  
  }  
}

WeChat

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "wechat",  
    "contact": {  
        "cId": "ovYOJv8eZlJ5efKToATGeOk5hBQM",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3. 46642,  
            "длинна": 101. 95847,  
            "Адрес": "Куала-Лумпур центр города"  
          }  
        }  
      \],  
    "body": {  
      "xml": {  
        "ToUserName": \[  
          "gh\_5b17802cd972"  
        \],  
        "FromUserName": \[  
          "ovYOJv8eZlJ5evMToATGePk5hAQM"  
        \],  
        "CreateTime": \[  
          "1593421765"  
        \],  
        "MsgType": \[  
          "text"  
        \],  
        «Контент»: \[  
          «Привет»  
        \],  
        "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": "ru\_US"  
      },  
      "получатель": {  
        "id": "4db00a5db70efbb51a0cd6a6635918390dd1945a89ce77898ab66b82d5c15344"  
      },  
      "query": \[  
        {  
          "type": "query",  
          "Текст": "Привет"  
        }  
      \]  
    }  
  }  
}

Бизнес-API WhatsApp

"originalDetectIntentRequest": {  
"payload": {  
"body": {  
"object": "whatsapp\_business\_account",  
"entry": \[  
{  
"changes": \[  
{  
"value": {  
"contacts": \[  
{  
"wa\_id": "60124438291",  
"profile": {  
"name": "Shahzad"  
}  
}  
\],  
"metadata": {  
"display\_phone\_number": "15550468615",  
"phone\_number\_id": "106875742284151"  
},  
"messaging\_product": "whatsapp",  
"messages": \[  
{  
"id": "wamid. BgLNjAxMjQ0MzgyOTEVAgASGBYzRUIwOTA1ODAxRUQ5MDAxOTI1QTcxAA==",  
"type": "text",  
"from": "60124438291",  
"timestamp": "1680061817",  
"text": {  
"body": "Расскажите мне шутку"  
}  
}  
\]  
},  
"field": "messages"  
}  
\],  
"id": "106024152370383"  
}  
\]  
},  
"source": "whatsapp\_business",  
"contact": {  
"cId": "60124438291",  
"contactId": 38,  
"channelId": 59  
}  
}  
}

WhatsApp Cloud API

"originalDetectIntentRequest": {  
        "payload": {  
            "body": {  
                "entry": \[  
                    {  
                        "id": "106024152370383",  
                        "changes": \[  
                            {  
                                "field": "messages",  
                                "value": {  
                                    "messaging\_product": "whatsapp",  
                                    "messages": \[  
                                        {  
                                            "id": "wamid. БгLNjAxMjQ0MzgyOTEVAgASGBYzRUIwM1OUQ4NkE4MUJDRDY1QkE0A==",  
                                            "timestamp": "1680063507",  
                                            "text": {  
                                                "body": "Расскажите мне шутку"  
                                            },  
                                            "с": "60124438291",  
                                            "type": "text"  
                                        }  
                                    \],  
                                    "metadata": {  
                                        "display\_phone\_number": "15550468615",  
                                        "phone\_number\_id": "106875742284151"  
                                    },  
                                    "контакты": \[  
                                        {  
                                            "wa\_id": "60124438291",  
                                            "profile": {  
                                                "name": "Shahzad"  
                                            }  
                                        }  
                                    \]  
                                }  
                            }  
                        \]  
                    }  
                \],  
                "object": "whatsapp\_business\_account"  
            },  
            "contact": {  
                "cId": "60124438291",  
                "channelId": 45,  
                "contactId": 43  
            },  
            "source": "whatsapp\_cloud"  
        }  
}

WhatsApp Twilio

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "twilio\_whatsapp",  
    "contact": {  
        "cId": "whatsapp:+60133385703",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3. 46642,  
            "длинна": 101. 95847,  
            "Адрес": "Куала-Лумпур центр города"  
          }  
        }  
      \],  
    "body": {  
      "SmsMessageSid": "SMb16231017683857d42ca62aafabcf205",  
      "NumMedia": "0",  
      "SmsSid": "SMb16231017683857d42ca62aafabcf205",  
      "SmsStatus": "Получено",  
      "Тело": "Привет",  
      "К": "whatsapp:+14155238886",  
      "NumSegments": "1",  
      "MessageSid": "SMb16231017683857d42ca62aafabcf205",  
      "AccountSid": "AC75bcf6cd15a35c46c6e5fa6d6dde6028",  
      "От: "whatsapp:+60144486813",  
      "ApiVersion": "2010-04-01"  
    }  
  }  
}

WhatsApp сообщение

"originalDetectIntentRequest": {  
  "полезная нагрузка": {  
    "источник": "сообщение\_птица\_whatsapp",  
    "контакт": {  
        "cId": "60133385712",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "вложения": \[  
        {  
          "тип": "местоположение",  
          "полезная нагрузка": {  
            "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": "Привет"  
        },  
        "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"  
      },  
      "тип": "сообщение.создано"  
    }  
  }  
}

Vonage WhatsApp

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "nexmo\_whatsapp",  
    "contact": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3. 46642,  
            "длинна": 101. 95847,  
            "Адрес": "Куала-Лумпур центр города"  
          }  
        }  
      \],  
    "body": {  
      "message\_uuid": "2b53f909-1640-471f-a44d-e4cb9bd00c44",  
      "до": {  
        "type": "whatsapp",  
        "number": "12012938397"  
      },  
      "из": {  
        "type": "whatsapp",  
        "number": "60133285813"  
      },  
      "timestamp": "2020-06-29T04:37:21. 76Z",  
      "message": {  
        "content": {  
          "type": "text",  
          "текст": "Привет"  
        }  
      },  
      "направление": "входящий"  
    }  
  }  
}

WhatsApp 360dialog v1

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "message\_pipe\_whatsapp",  
    "contact": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3. 46642,  
            "длинна": 101. 95847,  
            "Адрес": "Куала-Лумпур центр города"  
          }  
        }  
      \],  
    "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": "Leo"  
      },  
      "recipient\_id": "64f0699c-e005-409d-b177-6a975c61ba60"  
    }  
  }  
}

диалоговое окно WhatsApp 3602

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "360dialog\_whatsapp",  
    "contact": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "channelId": 7890  
    },  
    "attachments": \[  
        {  
          "type": "location",  
          "payload": {  
            "lat": 3. 46642,  
            "длинна": 101. 95847,  
            "Адрес": "Куала-Лумпур центр города"  
          }  
        }  
      \],  
    "body": {  
      "contacts": \[  
        {  
          "profile": {  
            "name": "John Don"  
          },  
          "wa\_id": "923339883320"  
        }  
      \],  
      "messages": \[  
        {  
          "from": "923339885509",  
          "id": "ABEGkjM5iFUJAhDGiqsifkiyZkH6HzvBfO2m",  
          "text": {  
            "body": "Привет"  
          },  
          "Метка времени": "1595240228",  
          "type": "text"  
        }  
      \]  
    }  
  }  
}

FAQ и устранение неполадок

Payload не поддерживается

Все неподдерживаемые полезные нагрузки, например карты Google Assistant не будут отображаться на платформе и будут проигнорированы respond.io.

Неверный формат полезной нагрузки

Форматы загрузчика строгие, и любые отсутствующие значения ключей приводят к нежелательным результатам, т.е. не появляются на платформе, появляются неправильно и т.д.

Задержка времени более 5 секунд

Если у вас есть сложные критерии исполнения, то напр. подключившись к некоторым сторонним службам, которые выполняют запросы до возврата ответа, тогда вы должны рассмотреть вопрос о задержке времени, как это описано в документации Диалога здесь. Ответ должен быть возвращен в течение 5 секунд или другой вебхук завершился неудачей, и ответ не будет возвращен в Диалог и respond.io.