Types of Rich Messages

Here is a list of available Rich Messages you can use in Kommunicate chat:

  • Buttons
    • Suggested Replies
    • Link Buttons
    • Submit Buttons
  • Images
  • List
  • Cards
    • Generic Card
    • Card Carousel
  • Form
    • Form with Calendar Date Picker

NOTE : Currently, only a collection of rich messages are supported with facebook integration, which are listed below.

  • Suggested Replies
  • Link buttons
  • Combined buttons (suggested buttons + link buttons)
  • Basic Card
  • Card Carousel

Buttons

You can add any number of Buttons in your conversations for faster navigation. There are three types of Buttons separated by their action.

Suggested Replies

Suggested Replies

{
    "message": "The oval shaped buttons below are examples of suggested replies",
    "platform": "kommunicate",
    "metadata": {
        "contentType": "300",
        "templateId": "6",
        "payload": [
         {
            "title": "Example 1",
            "message": "Message for Example 1."
        },
        {
            "title": "Example 1",
            "message": "Message for Example 2"
        },
        {
            "title": "Example for a long button",
            "message": "Message for long button"
        }
       ]
    }
}

Suggested Replies provide a way to send messages on a click without typing them all out manually. These are essentially the same as Suggestion Chips in Dialogflow and Postback Buttons in Facebook.

Note: Suggested Replies were previously called Quick Replies.

You can add any number of Suggested Replies by passing values in the metadata as described below:

In the following Suggested Replies example, if you click the button "Yes" it will be showing the message "Cool! send me more." and if you click "No" it will be showing the message "Not at all".

These button titles and messages can be customized based on your requirement.

Suggested Replies

{
    "message": "Do you want more updates?",
    "platform": "kommunicate",
    "metadata": {
        "contentType": "300",
        "templateId": "6",
        "payload": [{
            "title": "Yes",
            "message": "Cool! send me more."
        }, {
            "title": "No",
            "message": "Not at all"
        }]
    }
}

In addition, if you need you can use follow-up intents in Dialogflow to automatically set contexts for pairs of intents.

A follow-up intent is a child of its associated parent intent. When you create a follow-up intent, an output context is automatically added to the parent intent and an input context of the same name is added to the follow-up intent.

A follow-up intent is only matched when the parent intent is matched in the previous conversational turn. You can also create multiple levels of nested follow-up intents.

Dialogflow follow-up intent example:

Suggested Replies
Suggested Replies

In this example, The follow-up intents has been created for "Yes" and "No". When the buttons are clicked it will show the follow-up intent for that particular suggested reply.

Based on the use case and requirement, you can create follow-up texts, suggested replies, link buttons, etc.

Send custom data to bot platform via rich message response


{
    "message": "Do you want more updates?",
    "platform": "kommunicate",
    "metadata": {
        "contentType": "300",
        "templateId": "6",
        "payload": [{
            "title": "Yes",
            "message": "Cool! send me more."
        }, {
            "title": "No",
            "message": "Not at all",
            "replyMetadata": {
                "KM_CHAT_CONTEXT": {
                    "buttonClicked": true
                }
            }
        }]
    }
}

replyMetadata helps you to send custom data along with every suggested reply. Pair it with KM_CHAT_CONTEXT to receive data back when user click on the suggested reply. The appearance of the Suggested Replies and Buttons will be adjusted automatically according to the customization you have done on your chat widget.

In the above example replyMetadata has the parameter "buttonClicked": "true", this will send the data to bot platform to confirm the end user has clicked on the button "NO". If you want to perform some actions if a user clicks on a certain button you can use this option.

It is useful in several requirements such as,

  • To know which button user has clicked.
  • To send the extra data when a user clicks on a button.

Link Button

Link Button

Link Button redirects users to a given URL in a new tab.

Use the below metadata to render the Link Buttons:

{
    "message": "click on the buttons",
    "platform":"kommunicate",
    "metadata": {
        "contentType": "300",
        "templateId": "3",
        "payload": [{
                "type": "link",
                "url": "https://www.google.com",
                "name": "Go To Google"
            },
            {
                "type": "link",
                "url": "https://www.facebook.com",
                "name": "Go To Facebook",
                "openLinkInNewTab": false
            }
        ]
    }
}

Use openLinkInNewTab: false to open any link in the same tab. Default value is true, which will open the links in the new tab.

Submit Button

Submit Button

Submit Button allows you to post given data or redirect the user to a given URL. If parameter requestType:json is included, it will post the data with content type application/json on the formAction URL and the replyText will be used as acknowledgement message.

Default value for replyText is same as the value passed in name parameter. If requestType parameter is not passed, it will submit the formData with contentType application/x-www-form-urlencoded and redirect the user on formAction URL. The response will be rendered in new tab.

{
    "message": "click the pay button",
    "platform": "kommunicate",
    "metadata": {
        "contentType": "300",
        "templateId": "3",
        "payload": [{
            "name": "Pay",
            "replyText":"optional, will be used as acknowledgement message to user in case of requestType JSON. Default value is same as name parameter"
        }],
        "formData": {
            "amount": "1000",
            "description": "movie ticket"
        },
        "formAction": "https://example.com/book",
        "requestType":"json"
    }
}

Combine different type of buttons with single message

To combine the different buttons with single message you can put the payload of different button in a single array. Below example demonstrate how to achieve this :

{
  "message": "This example shows how to combine different buttons with a message",
  "platform": "kommunicate",
  "metadata": {
    "contentType": "300",
    "templateId": "11",
    "payload": [
      {
        "name": "Link button",
        "action": {
          "type": "link",
          "url": "https://www.facebook.com",
          "openLinkInNewTab": false
        }
      },
      {
        "name": "submit button",
        "action": {
          "type": "submit",
          "message": "optional- this message will be used as acknowledgement text when user clicks the button",
          "formData": {
            "amount": "1000",
            "description": "movie ticket"
          },
          "formAction": "https://example.com/book",
          "requestType": "json"
        }
      },
      {
        "name": "Suggested reply Button",
        "action": {
          "type": "quickReply",
          "message": "text will be sent as message"
        },
        "replyMetadata": {
          "KM_CHAT_CONTEXT": {
            "key": "value"
          }
        }
      }
    ]
  }
}

Images

Images can be rendered in conversation using below JSON. The image object contains a caption(optional) and an image URL. You can send a list of image objects in the payload. There is no action supported on image template.

{
  "message": "Hey I am Kommunicate support bot",
  "platform":"kommunicate",
  "metadata": {
    "contentType": "300",
    "templateId": "9",
    "payload": [
      {
        "caption": "Image caption",
        "url": "Image URL"
      }]
  }
}

List Template

The list template is a list of structured items with an optional header image and header text.

List Template

Components of a List Template

A list template may contain below items:

  • Header Image   (Recommended size: 910*330px)

  • Header text   (Character limit: 75)

  • List of items: Each item may contain below components:

    • Thumbnail image  (Recommended size: 150*150px)
    • Title   (Character limit: 32)
    • Description   (Character limit: 35)
    • The action of the item

  • List of buttons: Each button may contain below components:

    • Name of button
    • The action of the button

Actions on the List

There are two types of action supported on list items and buttons.

  • Link: It will navigate the user to another page in a new tab.

  • Suggested Replies: It will send a message with given text if passed. The default value will be the title of the list item or name of the button. The action is specified by the action object passed along with each item and button. This is how the action object looks like :

// for Suggested Reply, the action object will look like this:
"action": {
    "type": "quick_reply",
    "text": "This text will be sent as message"
}

// for Link, the action object will look like this:
"action": {
    "type": "link",
    "url": "URL to navigate other page"
}

Note: Any URL provided in url key above will open that URL in a new tab.

Here is the sample JSON for the List Template:

{
    "message": "This is the sample json for list template",
    "platform": "kommunicate",
    "metadata": {
        "contentType": "300",
        "templateId": "7",
        "payload": {
            "headerImgSrc": "URL for header image",
            "headerText": "Header text.",
            "elements": [{
                "imgSrc": "Thumbnail icon for list item",
                "title": "List item 1",
                "description": "Description for the list item",
                "action": {
                    "url": "https://www.google.com",
                    "type": "link"
                }
            }],
            "buttons": [{
                "name": "See us on facebook",
                "action": {
                    "url": "https://www.facebook.com",
                    "type": "link"
                }
            }]
        }
    }
}

Cards

The card template is a list of structured items with title, subtitle, image, and buttons. There are two types of Cards supported in Kommunicate:

  • Generic Card
  • Carousel Card

Generic Card

Generic Card

Components of card template

A card template may contain below items:

Labeled Generic Card

  • Header
    • Image (optional)    (Recommended size: 720*280px)
    • Overlay text (optional)
  • Card information section
    • Title    (Character limit: 16)
    • Title extension (optional)
    • Subtitle    (Character limit: 56)
    • Description    (Character limit is 99 and use \n to break the line.)
  • Card footer may contain a list of buttons, it can be:
    • Link Button
    • Submit Button
    • Suggested Replies

Actions on the button

  • Link: It will navigate the user to another page in a new tab.

  • Submit Button: Submit Button allows you to post given data or redirect the user to a given URL.

  • Suggested Replies: It will send a message with given text if passed. The default value will be the title of the list item or name of the button. The action is specified by the action object passed along with each item and button.

Here are the actions you can perform on click of the buttons:

Sample "action" object for Suggested Reply:

"action": {
    "type": "quickReply",
    "payload": {
        "title": "Yes",
        "message": "text will be sent as message",
    }
}

Sample "action" object for navigation link:

"action": {
    "type": "link",
    "payload": {
        "url": "https://www.facebook.com"
    }
}

Sample "action" object for Submit Button:

"action": {
    "type": "submit",
    "payload": {
        "text": "Button text",
        "formData": {
            "amount": "1000",
            "description": "movie ticket"
        },
        "formAction": "https://example.com/book",
        "requestType": "json"
    }
}

Here is the sample JSON for the single card:

{
  "message": "This is the sample json for card template",
  "platform": "kommunicate",
  "metadata": {
    "contentType": "300",
    "templateId": "10",
    "payload": [
      {
        "title": "Card Title",
        "subtitle": "Card Subtitle ",
        "header": {
          "overlayText": "Overlay Text",
          "imgSrc": "Header image for the card"
        },
        "description": "Description",
        "titleExt": "Title extension",
        "buttons": [
          {
            "name": "Link Button",
            "action": {
              "type": "link",
              "payload": {
                "url": "https://www.facebook.com"
              }
            }
          }
        ]
      }
    ]
  }
}

You can add any number of buttons in your card footer.

Card Carousel

The Kommunicate chat widget supports sending of a horizontally scroll-able carousel of generic templates.

Card Carousel Template

The payload is an array of objects, each object can be different cards. So you can pass multiple objects inside the payload.

Here is the sample JSON for the card carousel:

{
  "message": "Carousel",
  "platform": "kommunicate",
  "metadata": {
    "contentType": "300",
    "templateId": "10",
    "payload": [
      {
        "title": "OYO Rooms 1",
        "subtitle": "Kundanahalli road turn.",
        "header": {
          "overlayText": "$400",
          "imgSrc": "http://www.tollesonhotels.com/wp-content/uploads/2017/03/hotel-room.jpg"
        },
        "description": "Bharathi Road \n Near Head Post Office",
        "titleExt": "4.2/5",
        "buttons": [
          {
            "name": "Link Button",
            "action": {
              "type": "link",
              "payload": {
                "url": "https://www.facebook.com"
              }
            }
          },
          {
            "name": "Suggested Reply",
            "action": {
              "type": "quickReply",
              "payload": {
                "message": "text will be sent as message",
                "replyMetadata": {
                  "key1": "value1"
                }
              }
            }
          },
          {
            "name": "Submit button",
            "action": {
              "type": "submit",
              "payload": {
                "text": "acknowledgement text",
                "formData": {
                  "amount": "$55",
                  "description": "movie ticket"
                },
                "formAction": "https://example.com/book",
                "requestType": "json"
              }
            }
          }
        ]
      },
      {
        "title": "OYO Rooms 2",
        "subtitle": "Kundanahalli ",
        "header": {
          "overlayText": "$360",
          "imgSrc": "http://www.tollesonhotels.com/wp-content/uploads/2017/03/hotel-room.jpg"
        },
        "description": "Bharathi Road | Near Head Post Office, Cuddalore 607001",
        "titleExt": "4.2/5",
        "buttons": [
          {
            "name": "Link Button",
            "action": {
              "type": "link",
              "payload": {
                "url": "https://www.facebook.com"
              }
            }
          },
          {
            "name": "Submit button",
            "action": {
              "type": "submit",
              "payload": {
                "text": "acknowledgement text",
                "formData": {
                  "amount": "$22",
                  "description": "movie ticket"
                },
                "formAction": "https://example.com/book",
                "requestType": "json"
              }
            }
          },
          {
            "name": "Suggested Reply",
            "action": {
              "type": "quickReply",
              "payload": {
                "message": "text will be sent as message",
                "replyMetadata": {
                  "key1": "value1"
                }
              }
            }
          }
        ]
      },
      {
        "title": "OYO Rooms 3",
        "subtitle": "Kundanahalli ",
        "header": {
          "overlayText": "$750",
          "imgSrc": "http://www.tollesonhotels.com/wp-content/uploads/2017/03/hotel-room.jpg"
        },
        "description": "Bharathi Road | Near Head Post Office, Cuddalore 607001",
        "titleExt": "4.2/5",
        "buttons": [
          {
            "name": "Link Button",
            "action": {
              "type": "link",
              "payload": {
                "url": "https://www.facebook.com"
              }
            }
          },
          {
            "name": "Submit button",
            "action": {
              "type": "submit",
              "payload": {
                "text": "acknowledgement text",
                "formData": {
                  "amount": "$45",
                  "description": "movie ticket"
                },
                "formAction": "https://example.com/book",
                "requestType": "json"
              }
            }
          },
          {
            "name": "Suggested Reply",
            "action": {
              "type": "quickReply",
              "payload": {
                "message": "text will be sent as message",
                "replyMetadata": {
                  "key1": "value1"
                }
              }
            }
          }
        ]
      }
    ]
  }
}

Videos & Youtube

Videos can be rendered in conversation. The video object contains a caption(optional) and the video URL. Mention any video from public url or an youtube video.

Rich Message - Videos

For the Youtube - Youtube URL would be like this https://www.youtube.com/watch?v=3-ijFzzF934 Copy the youtube video id 3-ijFzzF934 then embed to the following youtube url https://www.youtube.com/embed/ in the url field

Below is the sample JSON code for video and the youtube

{
  "platform": "kommunicate",
  "message": "Hello this is example videos",
  "metadata": {
    "contentType": "300",
    "templateId": "14",
    "payload": [
      {
        "url": "https://s3-migration-dot-applozic.appspot.com/rest/ws/aws/file/AMIfv95BPKLnhNtiYz0SNJYXTDhUkvhPYQikSjFaoL1hbg1zCcK8n6KZZfZC5Z42bfxOLaNeKSbKrt4o9pI0_ICb1fKKY8HqtcCeEuUZU8b18u8sr-4U5d4rFtmC79cn_0xaiV0MQfF01T0hAea8sQANoaYuvR5hQJHiFSB047yp1mkfqcwNb_ExaX1xutdJ8Qamkjp8xTKjlPiG0920T7qqLFIBxl1eGL7ikvTCtXG_f8Me8OKsEOhUXOP7LLuJLcOG_p8cijsp",
        "caption": "Video & Youtube Examples"
      },
      {
        "source": "youtube",
        "url": "https://www.youtube.com/embed/3-ijFzzF934"
      }
    ]
  }
}

HTML content

HTML content will work with V2 APIs.

You can send HTML content as a message and Kommunicate will render the HTML in the UI. Pass the property messageType: html in custom payload from Dialogflow. You can send a standalone HTML message or combine it with Rich Messages. Below is the sample JSON with Suggested Replies:

Sample JSON with HTML in Suggested Replies:

{
        "messageType":"html",
    "platform": "kommunicate",
    "message": "<ul><li> Bangalore </li><li> California </li><li> Singapore </li><li> London </li></ul>"
}

Embed videos

Send video message from your bot using HTML content type. The embedded video links can be passed in the message property and Kommunicate will render and display it on the chatwidget. Below is the sample JSON code with the video link

{
  "message": "<iframe width='250' height='200' src='https://www.youtube.com/embed/aAJvI0UOspM'></iframe>",
  "platform": "kommunicate",
  "messageType": "html"
}

Embed videos

Form Template

You can add forms in your messages to collect information from users. The data filled by the user can be sent back to your bot or a URL to process it further.

Form

parameterdescription
requestTypeIt is optional, by default it will allow you to post form data to a given formAction URL and values are
json : it will post the form data with content type application/json on the formAction URL.
postBackToBotPlatform : it will send form data back to bot platform. formAction can be empty in case of postBackToBotPlatform.
replyTextIt will be used as acknowledgement message.

Supported input types for form fields in web and mobile SDKs

  • Text
  • Password
  • Hidden
  • Radio Buttons
  • Checkbox

here is the sample JSON for the form template:

{
  "message": "Submit your details",
  "platform": "kommunicate",
  "metadata": {
    "contentType": "300",
    "templateId": "12",
    "payload": [
      {
        "type": "text",
        "data": {
          "label": "Name",
          "placeholder": "Enter your name"
        }
      },
      {
        "type": "password",
        "data": {
          "label": "Password",
          "placeholder": "Enter your password"
        }
      },
      {
        "type": "hidden",
        "data": {
          "name": "userDetail",
          "value": "some_secret_detail"
        }
      },
      {
        "type": "radio",
        "data" : {
          "title": "What do you identify as:",
          "name": "Gender",
          "options": [
          {
            "label": "Male",
            "value": "male"
          },
          {
            "label": "Female",
            "value": "female"
          },
          {
            "label": "Other",
            "value": "other"
          }
        ]
        }
      },
      {
        "type": "checkbox",
        "data": {
          "title": "Choose your Music Type:",
          "name": "music_type",
          "options": [
          {
            "label": "Metal",
            "value": "metal"
          },
          {
            "label": "Pop",
            "value": "pop"
          },
          {
            "label": "Blues",
            "value": "blues"
          },
          {
            "label": "Folk",
            "value": "folk"
          }
        ]
        }
      },
      {
        "type": "submit",
        "data": {
          "action":{
            "message": "optional- this message will be used as acknowledgement text when user clicks the button",
            "requestType": "json",
            "formAction": "<URL>"
          },
          "type": "submit",
          "name": "Submit"
        }
      }
    ]
  }
}

Note: The value of formAction need to be replaced with a valid URL.

// If requestType parameter is not passed, it will submit the formData with
// contentType application/x-www-form-urlencoded.
// If requestType parameter is json/postBackToBotPlatform the content type will be application/json.

// The form data will be extracted as below,

{
  Name: "Jithin", // "Name" is the input label and "Jithin" is the input value
  Password :"password123", // "Password" is the input label and "password123" is the input value
  userDetail: "some_secret_key", // Hidden field where "userDetail" is the name and "some_secret_key" is the value,
  Gender: "Male", //Radio button where "Gender" is the name of the radio button and "Male" is the value of the checked radio option,
  music_type: ["Metal","folk"] //"Genre" is the name of the checkbox field and the value is an array of the selected checkbox options


}

If the requestType parameter is postBackToBotPlatform, Kommunicate will send form data back to your bot. You need to enable the fulfillment from Dialogflow console to access this data. Once it is enabled, you can access this data from the fulfillment code under originalDetectIntentRequest property. Below is the sample data your fulfillment will receive.

{
 ...
 "originalDetectIntentRequest": {
   "payload": {
     "formData": {
       "Name": "Jithin",
       "Age": "25"
     },
     "applicationId": "102797803a1e00dccfa83eaf700f2b28a",
     "attachments": [],
     "botId": "bot-cf6gk",
     "groupId": "341144",
     "messageSource": "1"
   }
 }
 ...
}

Form validation

In order to restrict users from entering invalid data, add form field validation using regex.

Instructions

  1. Create the Regex according to your requirements.
  2. If your regex has forward-slash (/) at the beginning and ending please remove it.
  3. Use a backslash (the escape character) in Dialogflow to skip double quotes or any other character which is throwing error.
  4. If your Regex includes backslash, add one more backslash with it.
warning
  1. This is only supported for the input type 'text'.

Below is the sample payload to validate an email input and to make the input field mandatory.

{
  "message": "Form",
  "platform": "kommunicate",
  "metadata": {
    "contentType": "300",
    "templateId": "12",
    "payload": [
      {
        "type": "text",
        "data": {
          "label": "Name",
          "placeholder": "Enter your name",
          "validation": {
            "regex": "[A-Za-z0-9]",
            "errorText": "Field is mandatory"
          }
        }
      },
      {
        "type": "text",
        "data": {
          "label": "Email",
          "placeholder": "Enter your email",
          "validation": {
          "regex": "^(([^<>()\\[\\]\\.;:\\s@\"]+(\\.[^<>()[\\]\\.,;:\\s@\"]+)*)|(\".+\"))@((\\[[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\])|(([a-zA-Z\\-0-9]+\\.)+[a-zA-Z]{2,}))$",
          "errorText": "Invalid Email"
        }
        }
      },
      {
        "type": "submit",
        "data": {
          "action":{
            "message": "Form was submitted successfully!",
            "requestType": "json",
            "formAction": "<URL>"
          },
          "type": "submit",
          "name": "Submit"
        }
      }
    ]
  }
}

Form with Dropdown list

The dropdown list allows the user to choose one value from a list. Pass the data options as the type dropdown.

Form with Dropdown list - Template 1

In this drop down list template, by default no option value will be selected. You have to click the dropdown, select a value and continue. Mention the "selected" and "disabled" parameters as true

In the below example, by default the option value is selected as "Select".

Form with Dropdown list

Below is the sample JSON code for this dropdown list template

{
  "platform": "kommunicate",
  "message": "Form Dropdown - Template 1",
  "metadata": {
    "templateId": "12",
    "contentType": "300",
    "payload": [
      {
        "type": "dropdown",
        "data": {
          "options": [
            {
              "value": "Engineer",
              "label": "Engineer"
            },
            {
              "value": "entrepreneur",
              "label": "Entrepreneur"
            },
            {
              "label": "Doctor",
              "value": "Doctor"
            },
            {
              "value": "Lawyer",
              "label": "Lawyer"
            },
            {
              "selected": true,
              "disabled": true,
              "label": "Select"
            }
          ],
          "validation": {
            "errorText": "Please select your profession"
          },
          "title": "Your Profession",
          "name": "profession"
        }
      },
      {
        "type": "text",
        "data": {
          "placeholder": "Enter your name",
          "label": "Name"
        }
      },
      {
        "data": {
          "name": "Submit",
          "type": "submit",
          "action": {
            "message": "optional- this message will be used as acknowledgement text when user clicks the button",
            "formAction": "https://reqres.in/api/users"
          }
        },
        "type": "submit"
      }
    ]
  }
}

Form with Dropdown list - Template 2

Here, by default one of the options from the list will be selected as value without clicking the dropdown. Pass the "selected" parameter as true in which option you want to set as default.

In the below example, under the option "Volvo" the parameter "selected" is mentioned as true and hence the Volvo option is shown as selected value when the list is loaded.

Form with Dropdown list

Below is the sample JSON code for this list template

{
  "platform": "kommunicate",
  "metadata": {
    "contentType": "300",
    "templateId": "12",
    "payload": [
      {
        "data": {
          "name": "cars",
          "options": [
            {
              "selected": true,
              "label": "Volvo",
              "value": "volvo"
            },
            {
              "label": "Saab",
              "value": "saab"
            },
            {
              "label": "Mercedes",
              "value": "mercedes"
            },
            {
              "value": "audi",
              "label": "Audi"
            }
          ],
          "title": "Cars"
        },
        "type": "dropdown"
      },
      {
        "type": "text",
        "data": {
          "label": "Name",
          "placeholder": "Enter your name"
        }
      },
      {
        "data": {
          "name": "Submit",
          "type": "submit",
          "action": {
            "message": "optional- this message will be used as acknowledgement text when user clicks the button",
            "formAction": "https://reqres.in/api/users"
          }
        },
        "type": "submit"
      }
    ]
  },
  "message": "Form Dropdown - Template 2"
}

Form with Calendar Date Picker

If your forms requires a calendar, then you can add it in the form template.

The Date Picker lets users quickly select dates from a collapsible calendar. It's perfect for order forms, reservation forms and booking forms, etc.

Form with Calendar Date Picker

Form with Calendar Date Picker

Payload for the calendar date picker and Time, if you have the requirement to use Time you can use it or you can ignore the type Time.

{
"payload": [
      {
        "type": "date",
        "data": {
          "label": "Date"
        }
      }, 
      {
        "type": "time",
        "data": {
          "label": "Time"
        }
      }
    ]
}

Here is the sample JSON for the form with calendar date picker template:

{
  "message": "Submit your details",
  "platform": "kommunicate",
  "metadata": {
    "contentType": "300",
    "templateId": "12",
    "payload": [
      {
        "type": "text",
        "data": {
          "label": "Name",
          "placeholder": "Enter your name"
        }
      },
      {
        "type": "password",
        "data": {
          "label": "Password",
          "placeholder": "Enter your password"
        }
      },
      {
        "type": "hidden",
        "data": {
          "name": "userDetail",
          "value": "some_secret_detail"
        }
      },
      {
        "type": "datetime-local",
        "data": {
           "label": "Date"
        }
      },
      {
        "type": "radio",
        "data": {
          "title": "What do you identify as:",
          "name": "Gender",
          "options": [
          {
            "label": "Male",
            "value": "male"
          },
          {
            "label": "Female",
            "value": "female"
          },
          {
            "label": "Other",
            "value": "other"
          }
        ]
        }
      },
      {
        "type": "submit",
        "data": {
          "action":{
            "message": "optional- this message will be used as acknowledgement text when user clicks the button",
            "requestType": "json",
            "formAction": "<URL>"
          },
          "type": "submit",
          "name": "Submit"
        }
      }
    ]
  }
}

Form with Text Area

You can add textarea in the forms for collecting user comments or reviews, etc. The size of a text area is specified by the cols and rows attributes.

Pass the property type: textarea in JSON payload. Validation can also be done for the textarea. We have mentioned JSON examples for the textarea with validation and without validation below.

Form with Text Area

Below is the sample JSON code for the form text area with validation

{
  "message": "Form Textarea with Validation",
  "metadata": {
    "contentType": "300",
    "payload": [
      {
        "type": "textarea",
        "data": {
          "cols": 10,
          "validation": {
            "regex": "^[^*|\\\":<>[\\]{}`\\\\()';@&$]+$",
            "errorText": "special characters not allowed"
          },
          "title": "Review of Kommunicate",
          "name": "review",
          "rows": 4,
          "placeholder": "Describe yourself here..."
        }
      },
      {
        "type": "text",
        "data": {
          "label": "Name",
          "placeholder": "Enter your name"
        }
      },
      {
        "data": {
          "name": "Submit",
          "action": {
            "message": "optional- this message will be used as acknowledgement text when user clicks the button",
            "formAction": "https://reqres.in/api/users"
          },
          "type": "submit"
        },
        "type": "submit"
      }
    ],
    "templateId": "12"
  },
  "platform": "kommunicate"
}

Form with Text Area

Below is the sample JSON code for the form text area without validation

{
  "message": "Form Textarea without Validation",
  "platform": "kommunicate",
  "metadata": {
    "templateId": "12",
    "contentType": "300",
    "payload": [
      {
        "data": {
          "placeholder": "Describe yourself here...",
          "cols": 10,
          "name": "review2",
          "rows": 4,
          "title": "Review of Kommunicate 2"
        },
        "type": "textarea"
      },
      {
        "type": "text",
        "data": {
          "placeholder": "Enter your name",
          "label": "Name"
        }
      },
      {
        "data": {
          "action": {
            "formAction": "https://reqres.in/api/users",
            "message": "optional- this message will be used as acknowledgement text when user clicks the button"
          },
          "type": "submit",
          "name": "Submit"
        },
        "type": "submit"
      }
    ]
  }
}

Form data using Dialogflow fulfillment

The form template can be configured with Dialogflow fulfillment, and you can submit the form data either to the endpoint URL of the server or back to the Dialogflow webhook by creating a follow-up intent and passing the this parameter "requestType": "postBackToBotPlatform"

{
  "platform": "kommunicate",
  "message": "What are you looking for?",
  "metadata": {
    "templateId": "12",
    "contentType": "300",
    "payload": [
      {
        "name": "choice_type",
        "type": "checkbox",
        "title": "Please choose from the options.",
        "options": [
          {
            "label": "Business Plan",
            "value": "Business Plan"
          },
          {
            "value": "Investor Deck",
            "label": "Investor Deck"
          },
          {
            "label": "Company Presentation",
            "value": "Company Presentation"
          },
          {
            "value": "Marketing Plan",
            "label": "Marketing Plan"
          },
          {
            "value": "Content Strategy",
            "label": "Content Strategy"
          },
          {
            "value": "Social  Strategy",
            "label": "Social  Strategy"
          }
        ]
      },
      {
        "label": "Submit",
        "type": "submit",
        "message": "Got that.",
        "requestType": "postBackToBotPlatform",
        "formAction": "URL"
      }
    ]
  }
}

Note: The value of formAction need to be replaced with a valid URL.

When the user clicks the submit button, Kommunicate will trigger a follow-up intent and the response will be obtained from the webhook. See a sample response below:


  "originalDetectIntentRequest": {
    "payload": {
      "botId": "BotId",
      "messageSource": "1",
      "formData": {
        "choice_type": ["Company Presentation"]
      }
    }
  }

Autosuggestions in your chat box

Autosuggestions make your users' life easier by populating the list of possible answers/data in the chat itself (see the image below).

If you want to ask any question or enter any text message into the chat box and send possible answers or list of data with that question, you can pass a list of answers or data into metadata. It will be displayed in the suggestion list. Suggestion list can also be fetched from a source URL/server if you pass source URL into the message.

Autosuggestions

The format of the message is as below:

{
  "message": "Where do you wanna go this summer?",
  "platform": "kommunicate",
  "metadata": {
    "KM_AUTO_SUGGESTION": {
      "placeholder": "enter city name ",
      "source": []
    }
  }
}

"placeholder" (optional) will appear in the chat input field as placeholder text. The "source" can be any one of the below formats:

  • Array of string
{
    "source": [
        "London",
        "New York",
        "Delhi"
    ]
}
  • Array of object
{
    "source": [{
            "searchKey": "Photography",
            "message": "Photography Lessons"
        },
        {
            "searchKey": "passport visa Services",
            "message": "Passport & Visa Services"
        }
    ]
}
  • Url: Pass the API endpoint to get the data. Kommunicate will send data in the query parameter.
{
  "source": {
    "url": "<API_ENDPOINT>",
    "headers": {}
  }
}

The API should return data in below format :

[
  {
    "searchKey": "searchable value",
    "name": "Text message which you want display/send into conversation.",
    "metadata": { "key": "value" } //optional, any extra information you want to send with message
  }
]

"metadata" is any extra information you want to send with the message. This field is optional.

Types of Rich Messages in IBM Watson

Rich messages that are supported in IBM Watson that can be used in Kommunicate chat:

How to add the supported rich messages in IBM Watson:

  1. Log in to your IBM Waston assistant console and click on the Resouces List from the left side menu

  2. Find the Services option and click on the Assistant listed inside the Services

  3. Launch Waton Assistant & click on the Assistant that you've created

  4. Now click on the "Dialog" of that Assistant. It will show list of Intents, Entities, Dialog, etc.

  5. Click on "Dialog" & then click on the node.

  6. Select the message type [Example: Image, Option]

Images

Select the Assistant responds as 'Image' and provide an image source (Note: source cannot be longer than 512 characters)

IBM Watsom Images

Quick Replies

Select the Assistant responds as 'Option'. Click 'Add Option+' and enter the quick reply options in the Enter label and Enter Value fields.

IBM Watsom Options

For all other Kommunicate rich messages, you have to put Kommunicate rich message JSON inside the IBM Watson JSON template format. Inside user_defined key, put the Kommunicate JSON payload

{
  "output": {
    "generic": [
      {
        "user_defined": 
    --------    
        
    Kommunicate rich message JSON       
        
    --------    
        ,
        "response_type": "user_defined"
      }
    ]
  }
}

Some examples are mentioned below.

Link Button

{
  "output": {
    "generic": [
      {
        "user_defined": {
          "message": "click on the buttons",
          "metadata": {
            "payload": [
              {
                "url": "https://www.amazon.com/s?k=men+dresses&ref=nb_sb_noss_2",
                "name": "🤵Men Dresses",
                "type": "link"
              },
              {
                "name": "👸Women Dresses",
                "url": "https://www.amazon.com/s?k=women+clothing&crid=85W5AF67F3FZ&sprefix=women+clo%2Caps%2C519&ref=nb_sb_ss_i_1_9",
                "type": "link"
            },
            {
                "url": "https://www.amazon.com/s?k=watches&ref=nb_sb_noss_2",
                "name": "⌚Watches",
                "type": "link"
            },
            {
                "url": "https://www.amazon.com/s?k=accessories+for+women&crid=3T0OO2UGMCSOS&sprefix=access%2Caps%2C437&ref=nb_sb_ss_i_6_6",
                "name": "👜Accessories",
                "type": "link"
            },
            {
                "url": "https://www.amazon.com/s?k=mobile&ref=nb_sb_noss_2",
                "name": "📲Mobiles",
                "type": "link"
            },
            {
                "openLinkInNewTab": true,
                "url": "https://www.amazon.com/s?k=personal+care&crid=XOU0P7MKU1O0&sprefix=personal+care%2Caps%2C646&ref=nb_sb_ss_i_1_13",
                "name": "💄Personal Care",
                "type": "link"
            }
            ],
            "templateId": "3",
            "contentType": "300"
          },
          "platform": "kommunicate"
        },
        "response_type": "user_defined"
      }
    ]
  }
}

Card Carousel

{
  "output": {
    "generic": [
      {
        "user_defined": {
  "message": "Shop 🛍️ our unique collections⭐",
  "metadata": {
    "templateId": "10",
    "contentType": "300",
    "payload": [
      {
        "buttons": [
          {
            "name": "Shop Now",
            "action": {
              "payload": {
                "url": "https://www.amazon.com/s?k=men+fashion&crid=2AWHC23U7KS5A&sprefix=men+fas%2Caps%2C466&ref=nb_sb_ss_i_1_7"
              },
              "type": "link"
            }
          }
        ],
        "title": "MEN'S FASHION",
        "description": "Fashion is what you’re offered four times a year by designers. And style is what you choose.",
        "titleExt": "4.5/5",
        "header": {
          "imgSrc": "https://images.unsplash.com/photo-1493146146946-e907f69cdf23?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=890&q=80"
        }
      },
      {
        "title": "WOMEN'S FASHION",
        "header": {
          "imgSrc": "https://images.unsplash.com/photo-1589960062943-bfb9f51756fa?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=750&q=80"
        },
        "buttons": [
          {
            "name": "Shop Now",
            "action": {
              "type": "link",
              "payload": {
                "url": "https://www.amazon.com/s?k=women+fashion+tops&crid=223ZVO20GFDP6&sprefix=women+fashio%2Caps%2C549&ref=nb_sb_ss_i_1_12"
              }
            }
          }
        ],
        "description": "Style is something each of us already has, all we need to do is find it.",
        "titleExt": "4.8/5"
      },
      {
        "titleExt": "4.8/5",
        "description": "Looking for watches? We stock a huge range of designer watches for gents, women, kids from famous brands",
        "buttons": [
          {
            "name": "Shop Now",
            "action": {
              "payload": {
                "url": "https://www.amazon.com/s?k=watch&crid=FSYRY8G29WSC&sprefix=watch%2Caps%2C1077&ref=nb_sb_ss_i_5_5"
              },
              "type": "link"
            }
          }
        ],
        "title": "WATCHES",
        "header": {
          "imgSrc": "https://images.unsplash.com/photo-1558505780-e7a9d70b4bab?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=873&q=80"
        }
      }
    ]
  },
  "platform": "kommunicate"
},
        "response_type": "user_defined"
      }
    ]
  }
}

List Template

{
  "output": {
    "generic": [
      {
        "user_defined": {
  "platform": "kommunicate",
  "metadata": {
    "payload": {
      "headerText": "Best Headphones 🎧 under 2000",
      "elements": [
        {
          "action": {
            "type": "link",
            "url": "https://www.amazon.in/Boat-Rockerz-400-Bluetooth-Headphones/dp/B01J82IYLW/ref=sr_1_1"
          },
          "description": "HD Clarity with Super Bass, Noise Cancelling, Playing time: Up to 8 hours",
          "imgSrc": "https://i.pinimg.com/originals/a2/82/1e/a2821ef77269ac2186ee260395ec7474.jpg",
          "title": "Boat Rockerz 400 On-Ear Bluetooth Headphones"
        },
        {
          "imgSrc": "https://i.pinimg.com/originals/82/e3/db/82e3dbfdd51fec40b8bc5bdeb0c7f4bf.jpg",
          "description": "Earphones with a user-friendly design and a life-like rhythmic reaction can be a great accessory for music enthusiasts.",
          "action": {
            "type": "link",
            "url": "https://www.amazon.in/Sony-MDR-ZX110A-Stereo-Headphones-without/dp/B00KGZZ824/ref=sr_1_3"
          },
          "title": "Sony MDR-ZX110A On-Ear Stereo Headphones"
        },
        {
          "action": {
            "type": "link",
            "url": "https://www.amazon.in/Heads-900-Wired-Headphones-White/dp/B078W65FJ7/ref=sr_1_5"
          },
          "title": "boAt Bass Heads 900 Wired Headphones with Mic",
          "imgSrc": "https://images-eu.ssl-images-amazon.com/images/I/414uBpZsGcL.jpg",
          "description": "The boAt Bass Heads 900 wired headphones come with an amalgamation of style with performance."
        }
      ]
    },
    "templateId": "7",
    "contentType": "300"
  },
  "message": "Shop now & enjoy 🎧"
},
        "response_type": "user_defined"
      }
    ]
  }
}
← How To UseBot setup →