Schémas JSON TORM
Cette page fournit les schémas JSON pour les éléments multimédias enrichis TORM suivants :
- Sélecteurs de liste
- Réponses rapides
- Sélecteurs d’heure
- Liens enrichis
- Cartes adaptatives
Il s'agit des éléments TORM qui peuvent être utilisés dans les scripts. Vous pouvez les créer dans une action SNIPPET en vue de les envoyer aux contacts . Avant d'utiliser un élément, vérifiez que le canal numérique avec lequel vous travaillez prend en charge cet élément.
Vous pouvez envoyer ces éléments directement à l'aide de l’API sortante. Les exemples TORM de cette page illustrent le schéma à suivre pour le paramètre messageContent de l’API sortante.
Lien enrichi
Un lien enrichi est une URL avec un aperçu d'image et un titre sur lesquels on peut cliquer pour ouvrir l'URL. Les liens riches TORM présentent certaines limitations basées sur les canaux.
{
"type": "RICH_LINK",
"fallbackText": "Text sent if rich message is not available on external platform",
"payload": {
"media": {
"fileName": "place-kitten.jpg",
"url": "https://placekitten.com/200/300",
"mimeType": "image/jpeg"
},
"title": {
"content": "Check our new gadget!"
},
"url": "https://www.google.com"
}
}
Sélecteur de liste
Un sélecteur de liste est une liste d'options parmi lesquelles le contact peut choisir. Les options sont généralement présentées dans une fenêtre en incrustation avec des fonctionnalités de formatage enrichies, par exemple des icônes, des titres et des sous-titres. Les sélecteurs de liste permettent de proposer plus d’options que les réponses rapides. Les contacts peuvent choisir plusieurs options, et les choix sont conservés dans la conversation. Les sélecteurs de listes TORM présentent certaines limitations basées sur les canaux.
{
"type": "LIST_PICKER",
"fallbackText": "Text sent if rich message is not available on external platform",
"payload": {
"title": {
"content": "Choose a color!"
},
"text": {
"content": "What is your favourite color?"
},
"actions": [
{
"type": "REPLY_BUTTON",
"icon": {
"fileName": "place-kitten.jpg",
"url": "https://placekitten.com/200/300",
"mimeType": "image/jpeg"
},
"text": "red",
"description": "Like a tomato",
"postback": "/red"
},
{
"type": "REPLY_BUTTON",
"icon": {
"fileName": "place-kitten.jpg",
"url": "https://placekitten.com/200/300",
"mimeType": "image/jpeg"
},
"text": "Green",
"description": "Like an apple",
"postback": "/green"
}
]
}
Réponses rapides
Une réponse rapide est un message texte avec des boutons. Le contact peut cliquer sur l’un des boutons. Après le clic, son contenu est envoyé comme message sortant. En général, lorsqu’une réponse est envoyée, il n’est pas possible de cliquer sur d’autres boutons. Les réponses rapides TORM présentent certaines limitations basées sur les canaux.
{
"type": "QUICK_REPLIES",
"fallbackText": "Text sent if rich message is not available on external platform",
"payload": {
"text": {
"content": "Hello, we will deliver the package between 12:00 and 16:00. Please specify which day."
},
"actions": [
{
"type": "REPLY_BUTTON",
"text": "Today",
"postback": "{\"id\":\"1\"}"
},
{
"type": "REPLY_BUTTON",
"text": "Tomorrow",
"postback": "{\"id\":\"2\"}"
}
]
}
}
Sélecteur de créneau horaire
Les sélecteurs d'heures vous permettent d'offrir au contact un choix d'heures, par exemple pour planifier des rendez-vous. Les sélecteurs de temps TORM présentent certaines limitations basées sur les canaux.
{
"type": "TIME_PICKER",
"fallbackText": "Text sent if rich message is not available on external platform",
"payload": {
"title": {
"content": "Check our new gadget!"
},
"timeSlots": [
{
"id": "unique-id",
"duration": 3600,
"startTime": "2017-05-26T08:27:55+00:00"
}
],
"location": {
"title": {
"content": "Check our new gadget!"
},
"latitude": 44.44,
"longitude": 55.55,
"radius": 33.3
}
}
}
Adaptive Card
Adaptive Cards est une méthode indépendante de la plate-forme d'envoi de médias enrichis développée par Microsoft. "Adaptive Cards ne sont pris en charge que sur les canaux de discussion numériques Any channel, contact, or skill associated with Digital Experience.
{
"type": "ADAPTIVE_CARD",
"fallbackText": "Url sent: https://placekitten.com",
"payload": {
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
"type": "AdaptiveCard",
"version": "1.5",
"body": [{
"type": "Image",
"url": "https://placekitten.com/200/300",
"spacing": "none",
"size": "stretch"
}],
"actions": [{
"type": "Action.OpenUrl",
"title": "Show me the cats!",
"url": "https://placekitten.com"
}]
}
}