Flux de dialogue : Demande de Webhook d'Accomplissement

Si vous construisez un Agent Dialogflow qui utilise extensivement Dialogflow Fulfillment vous trouverez les données passées par le fournisseur de canaux utiles pour votre application. Ces données sont transmises de la plate-forme respond.io à Dialogflow en utilisant le champ originalDetectIntentRequest.

Objet Contact

Pour permettre des cas d'utilisation plus avancés de l'API, l'objet Contact est ajouté à la requête par la plate-forme. L'élément cId de l'objet Contact reflète la même valeur utilisée dans l'API Contacts.

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

Facebook

"originalDetectIntentRequest": {  
    "payload": {  
      "source": "facebook",  
      "contact": {  
        "cId": "3854977680200098",  
        "contactId": "123456",  
        "canalId": "7890"  
      },  
      "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
      "body": {  
        "entry": \[  
          {  
            "messaging": \[  
              {  
                "recipient": {  
                  "id": "177689475607202"  
                },  
                "message": {  
                  "text": "hi",  
                  "mien": "D3DJuA0YlOgDgOybFG1M2ZHoJg9hq9IAjMQE2ps6RIN4QJ25rNPMi"  
                },  
                "horodatage": 1564743055901,  
                "expéditeur": {  
                  "id": "2254108171328398"  
                }  
              }  
            \],  
            "id": "177689475607202",  
            "temps": 1564743056313  
          }  
        \],  
        "objet": "page"  
      }  
    }  
}

LINE

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "line",  
    "contact": {  
        "cId": "U905251b5f5759acde5e4788681c04269",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "events": \[  
        {  
          "type": "message",  
          "replyToken": "16a59224c65b4c5cbecedc4f3504599b",  
          "source": {  
            "userId": "U905251b5f5759bbde5e4788681c04170",  
            "type": "utilisateur"  
          },  
          "horodatage": 1593146060317,  
          "mode": "actif",  
          "message": {  
            "type": "text",  
            "id": "12211455206333",  
            "text": "Bonjour"  
          }  
        }  
      \],  
      "destination": "U5698920083824716136c04633a9e1710"  
    }  
  }  
}

SMS Twilio

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "twilio",  
    "contact": {  
        "cId": "+12262120005",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "ToCountry": "CA",  
      "ToState": "Ontario",  
      "SmsMessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b",  
      "NumMedia": "0",  
      "ToCity": "",  
      "FromZip": "",  
      "SmsSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b",  
      "FromState": "Ontario",  
      "SmsStatus": "reçu",  
      "FromCity": "St Thomas",  
      "Corps": "Bonjour",  
      "Pays From": "CA",  
      "À": "+12267022870",  
      "ToZip": "",  
      "NumSegments": "1",  
      "MessageSid": "SM1f1c9a30ff67cf5b1a89d5b1e0735a2b",  
      "AccountSid": "AC75bcf6cd15a35c46c6e5fa6d6dde6028",  
      "De": "+12262121015",  
      "ApiVersion": "2010-04-01"  
    }  
  }  
}

Oiseau SMS

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "message\_bird",  
    "contact": {  
        "cId": "16364923690"  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "corps": {  
      "corps": "Bonjour",  
      "Date de création" : "2020-06-26T07:51:30+00:00",  
      "date": "1593186690",  
      "date\_utc": "1593157890",  
      "id": "6c4c8c58eb204e69ae7d07e309c5a11c",  
      "invocationId": "477a8bc9-a4ec-45db-98e0-3b982898945a",  
      "message": "Bonjour",  
      "message\_id": "026a4c0e38954e5684757ba1de645130",  
      "originateur": "12267022870",  
      "payload": "Bonjour",  
      "récepteur": "12262121015",  
      "destinataire": "12262121015",  
      "référence": "88003423322",  
      "expéditeur": "12267022870"  
    }  
  }  
}

Vonage SMS

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "nexmo",  
    "contact": {  
        "cId": "60133386712"  
    },  
    "corps": {  
      "msisdn": "12012938397",  
      "à": "12012938397",  
      "messageId": "16000002AB5DBF42",  
      "text": "Bonjour",  
      "type": "text",  
      "mot-clé": "HI",  
      "api-key": "2787fb30",  
      "message-timestamp": "2020-04-27 09:00:08"  
    }  
  }  
}

Telegram

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "telegramme",  
    "contact": {  
        "cId": "928825753",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "update\_id": 68062810,  
      "message": {  
        "message\_id": 358,  
        "from": {  
          "id": 921815852,  
          "is\_bot": false,  
          "prénom\_prénom": "Léo",  
          "language\_code": "en"  
        },  
        "chat": {  
          "id": 921815852,  
          "prénom\_prénom": "Léo",  
          "type": "privé"  
        },  
        "date": 1593415824,  
        "text": "Bonjour"  
      }  
    }  
  }  
}

Twitter

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "twitter",  
    "contact": {  
        "cId": "800244779787258095",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "body": {  
      "for\_user\_id": "800244779786258096",  
      "direct\_message\_events": \[  
        {  
          "type": "message\_create",  
          "id": "1277881813680091140",  
          "créé\_timestamp": "1593505740934",  
          "message\_create": {  
            "target": {  
              "recipient\_id": "800244779786258096"  
            },  
            "expéditeur\_id": "1236829623670812661",  
            "message\_data": {  
              "text": "Bonjour",  
              "entités": {  
                "hashtags": \[\],  
                "symboles": \[\],  
                "user\_mentions": \[\],  
                "urls": \[\]  
              }  
            }  
          }  
        }  
      \],  
      "utilisateurs": {  
        "1236829623670812661": {  
          "id": "1236829623670812661",  
          "créé\_timestamp": "1583718145786",  
          "nom": "leoawesome",  
          "screen\_name": "leoawesome21",  
          "protégé": faux,  
          "vérifié": faux,  
          "followers\_count": 0,  
          "amis\_count": 1,  
          "statuts\_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",  
          "name": "respond. o",  
          "screen\_name": "respond\_io",  
          "description": "https://t. o/8AN2CVzhwJ est une plate-forme de messagerie d'entreprise qui relie les clients de n'importe quel canal à chaque équipe. ,  
          "url": "https://t. o/vE593YRZwo",  
          "protégé": faux,  
          "vérifié": false,  
          "followers\_count": 246,  
          "amis\_count": 23,  
          "statuts\_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,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "event": "message",  
      "horodatage": 1593420787910,  
      "chat\_hostname": "BN-CHAT-14\_",  
      "message\_token": 5458312086267550000,  
      "expéditeur": {  
        "id": "T1yTBK3PQFGAGdhsDh1skA==",  
        "nom": "Leo",  
        "avatar": "https://media-direct. dn.viber. om/download\_photo? lid=tHBOJafTJ8WSwoFLCQ0x1lmS8RXeDXXyUVoAoLmmOGPIMprwqNCUO6BH3cG-VoAYd3WetLrBK4nP7C86ZN3MxG5T40A1lduzChAts-ULz0oO9l7FjW3bAYljiLyTGkYbaCRjcQ&fltp=jpg&imsz=0000",  
        "langue": "en",  
        "pays": "MY",  
        "api\_version": 8  
      },  
      "message": {  
        "text": "Bonjour",  
        "type": "text"  
      },  
      "silencieux": Faux  
    }  
  }  
}

WeChat

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "wechat",  
    "contact": {  
        "cId": "ovYOJv8eZlJ5efKToATGeOk5hBQM",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "xml": {  
        "ToUserName": \[  
          "gh\_5b17802cd972"  
        \],  
        "FromUserName": \[  
          "ovYOJv8eZlJ5evMToATGePk5hAQM"  
        \],  
        "Création": \[  
          "1593421765"  
        \],  
        "MsgType": \[  
          "texte"  
        \],  
        "Contenu": \[  
          "Bonjour"  
        \],  
        "MsgId": \[  
          "22812312807562437"  
        \]  
      }  
    }  
  }  
}

Chat web

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "webchat",  
    "contact": {  
        "cId": "e6507476-e507-4503-9652-bcde24e8ea88",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "body": {  
      "sender": {  
        "id": "07f1e397-12a8-485b-a417-14d7e3837608",  
        "locale": "en\_US"  
      },  
      "recipient": {  
        "id": "4db00a5db70efbb51a0cd6a6635918390dd1945a89ce77898ab66b82d5c15344"  
      },  
      "query": \[  
        {  
          "type": "query",  
          "text": "Bonjour"  
        }  
      \]  
    }  
  }  
}

API WhatsApp Business

"originalDetectIntentRequest": {  
"payload": {  
"body": {  
"object": "whatsapp\_business\_account",  
"entry": \[  
{  
"changes": \[  
{  
"value": {  
"contacts": \[  
{  
"wa\_id": "60124438291",  
"profile": {  
"name": "Shahzad"  
}  
}  
\],  
"métadonnées": {  
"display\_phone\_number": "15550468615",  
"phone\_number\_id": "106875742284151"  
},  
"messaging\_product": "whatsapp",  
"messages": \[  
{  
"id": "wamid. BgLNjAxMjQ0MzgyOTEVAgASGBYzRUIwOTA1ODAxRUQ5MDAxOTI1QTcxAA==",  
"type": "text",  
"from": "60124438291",  
"timestamp": "1680061817",  
"text": {  
"body": "Tell me a joke"  
}  
}  
\]  
},  
"champ": "messages"  
}  
\],  
"id": "106024152370383"  
}  
\]  
},  
"source": "whatsapp\_business",  
"contact": {  
"cId": "60124438291",  
"contactId": 38,  
"channelId": 59  
}  
}  
}

API WhatsApp Cloud

"originalDetectIntentRequest": {  
        "payload": {  
            "body": {  
                "entry": \[  
                    {  
                        "id": "106024152370383",  
                        "changes": \[  
                            {  
                                "field": "messages",  
                                "valeur": {  
                                    "messaging\_product": "whatsapp",  
                                    "messages": \[  
                                        {  
                                            "id": "wamid. BgLNjAxMjQ0MzgyOTEVAgASGBYzRUIwMjM1OUQ4NkE4MUJDRDY1QkE0AA==",  
                                            "horodatage": "1680063507",  
                                            "text": {  
                                                "body": "Dites-moi une blague"  
                                            },  
                                            "de": "60124438291",  
                                            "type": "text"  
                                        }  
                                    \],  
                                    "métadonnées": {  
                                        "display\_phone\_number": "15550468615",  
                                        "phone\_number\_id": "106875742284151"  
                                    },  
                                    "contacts": \[  
                                        {  
                                            "wa\_id": "60124438291",  
                                            "profile": {  
                                                "name": "Shahzad"  
                                            }  
                                        }  
                                    
  
                                }  
                            }  
                        \]  
                    }  
                \],  
                "objet": "whatsapp\_business\_accoun"  
            },  
            "contact": {  
                "cId": "60124438291",  
                "canalId": 45,  
                "contactId": 43  
            },  
            "source": "whatsapp\_cloud"  
        }  
}

WhatsApp Twilio

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "twilio\_whatsapp",  
    "contact": {  
        "cId": "whatsapp:+60133385703",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "SmsMessageSid": "SMb16231017683857d42ca62aafabcf205",  
      "NumMedia": "0",  
      "SmsSid": "SMb162317683857d42ca62aafabcf205",  
      "Statut SMS": "reçu",  
      "Corps": "Bonjour",  
      "À": "whatsapp:+14155238886",  
      "NumSegments": "1",  
      "MessageSid": "SMb16231017683857d42ca62aafabcf205",  
      "AccountSid": "AC75bcf6cd15a35c46c6e5fa6d6dde6028",  
      "De": "whatsapp:+60144486813",  
      "ApiVersion": "2010-04-01"  
    }  
  }  
}

Oiseau Message WhatsApp

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "message\_bird\_whatsapp",  
    "contact": {  
        "cId": "60133385712",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "contact": {  
        "attributes": {},  
        "Date de création" : "2020-05-18T03:02:01Z",  
        "customDetails": {},  
        "displayName": "60123376813",  
        "prénom": "",  
        "href": "https://contacts. oiseau essagé. om/v2/contacts/32845951f19c43d0b4e3371df0da941a",  
        "id": "32845951f19c43d0b4e3371df0da941a",  
        "NomNomNom": "",  
        "msisdn": 60123376813,  
        "date de mise à jour": "2020-05-18T03:02:01Z"  
      },  
      "conversation": {  
        "contactId": "32845951f19c43d0b4e3371df0da941a",  
        "créatedDatetime": "2020-05-18T03:02:01Z",  
        "id": "64d59ed4cb4f419ca39114c292c1a597",  
        "lastReceivedDatetime": "2020-06-26T08:58:55. 451283Z",  
        "statut": "actif",  
        "updatedDatetime": "2020-06-25T08:59:30. 77791342Z"  
      },  
      "message": {  
        "channelId": "f4b115e89415407ab2b97fe85ad3d191",  
        "content": {  
          "text": "Bonjour"  
        },  
        "conversationId": "64d59ed4cb4f419ca39114c292c1a597",  
        "créatedDatetime": "2020-06-26T08:58:55Z",  
        "direction": "reçu",  
        "de": "+60123376813",  
        "id": "91c8268bb72b412cab3b4080a974c5dc",  
        "plate-forme": "whatsapp",  
        "statut": "reçu",  
        "à": "+6531290788",  
        "type": "texte",  
        "updatedDatetime": "2020-06-26T08:58:55. 50324338Z"  
      },  
      "type": "message.  
    }  
  }  
}

Vonage WhatsApp

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "nexmo\_whatsapp",  
    "contact": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "message\_uuid": "2b53f909-1640-471f-a44d-e4cb9bd00c44",  
      "à": {  
        "type": "whatsapp",  
        "nombre": "12012938397"  
      },  
      "from": {  
        "type": "whatsapp",  
        "nombre": "60133285813"  
      },  
      "timestamp": "2020-06-29T04:37:21. 76Z",  
      "message": {  
        "content": {  
          "type": "text",  
          "text": "Bonjour"  
        }  
      },  
      "direction": "inbound"  
    }  
  }  
}

Boîte de dialogue WhatsApp 360 v1

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "message\_pipe\_whatsapp",  
    "contact": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "environment": {  
        "app\_id": "476"  
      },  
      "événements": \[  
        {  
          "name": "d360\_whatsapp\_message\_in",  
          "propriétés": {  
            "stack\_id": "85256128299",  
            "message\_id": "IY2Cx8lhx0E0M",  
            "conversation\_id": "K7SWYeCmed07C",  
            "type": "texte",  
            "content": {  
              "body": "Salut"  
            }  
          },  
          "horodatage": "1593502341000",  
          "id": "7a104e27-d4d2-4e5d-8c8a-c74f3ba8e6c1"  
        }  
      \],  
      "appareil": {  
        "mdn": "60133286713",  
        "profile\_name": "Leo"  
      },  
      "recipient\_id": "64f0699c-e005-409d-b177-6a975c61ba60"  
    }  
  }  
}

Boîte de dialogue WhatsApp 360 v2

"originalDetectIntentRequest": {  
  "payload": {  
    "source": "360dialog\_whatsapp",  
    "contact": {  
        "cId": "60133386712",  
        "contactId": 123456,  
        "canalId" : 7890  
    },  
    "pièces jointes": \[  
        {  
          "type": "emplacement",  
          "payload": {  
            "lat": 3. 46642,  
            "long": 101. 95847,  
            "adresse": "Centre de Ville de Kuala Lumpur"  
          }  
        }  
      \],  
    "body": {  
      "contacts": \[  
        {  
          "profile": {  
            "name": "John Don"  
          },  
          "wa\_id": "923339883320"  
        }  
      \],  
      "messages": \[  
        {  
          "from": "923339885509",  
          "id": "ABEGkjM5iFUJAhDGiqsifkiyZkH6HzvBfO2m",  
          "text": {  
            "body": "Bonjour"  
          },  
          "horodatage": "1595240228",  
          "type": "text"  
        }  
      \]  
    }  
  }  

FAQ et dépannage

La charge n'est pas prise en charge

Toutes les charges utiles non prises en charge, par exemple les cartes Google Assistant n'apparaîtront pas sur la plateforme et seront ignorées par respond.io.

Format de charge utile incorrect

Les formats de charge sont stricts et toutes les valeurs clés manquantes entraîneraient des résultats indésirables, c.-à-d. ne pas apparaître sur la plate-forme, n'apparaissant pas correctement, etc.

latence de temps supérieure à 5 secondes

Si vous avez un critère de satisfaction complexe, par ex. connexion à un service tiers qui fait des requêtes avant de retourner une réponse, alors vous devez considérer la latence de temps comme décrit dans la documentation Dialogflow ici. La réponse doit être retournée dans les 5 secondes sinon le webhook échoue et aucune réponse ne sera retournée à DialogFlow et respond.io.