Basic Response

Craft simple bot responses with common components.

Overview

Basic Response Automation forms the foundation of chatbot interactions (e.g. responses, broadcast messages, etc.), offering a user-friendly structure to design intuitive and engaging bot responses and experiences. It's the initial step to crafting a bot that not only answers but also engages, educates, and directs users using a mix of text, media, and interactive components.

Coming soon: the Basic Response Automation UI is set to launch in the ON Portal during Q2 2024!

Configurations

The following are the components of a Basic Response that can be configured:

• Text: Draft direct and concise responses for various user queries.

• Media: Share images and gifs to make your bot's reply more interactive and engaging.

• Embed Media: Share embedded videos to be played in the ON Web Chat client.

• Link Cards: Integrate external URLs to guide users to relevant web pages, forms, or resources.

  • Link: the URL to direct users to

  • Target: how a web link behaves when it is clicked by a user

    • BLANK: open links in a new tab or window

    • SELF: open links in the same tab or window

    • IN_CHAT: open supported links in the ON Web Chat Client itself

    • IN_CHAT_EXPANDED: open supported links in the ON Web Chat Client itself with expanded viewing window

  • Image: the thumbnail image presented in the card

  • Title: title of URL users are being directed to

  • Subtitle: additional context to message about the URL

  • Button Text: text in the button of the card e.g. "Read More"

• Link Carousels: Display a series of links, offering users multiple related options in a scroll-friendly format.

• Quick Replies: Provide users with pre-defined clickable responses, ensuring the conversation remains on track and interactive.

Randomizing Text Components

To prevent repetitiveness and offer a more organic feel in bot interactions consider introducing multiple text components within a single message. The bot, when responding, will randomly select one of the provided text components, ensuring varied and dynamic responses. This feature is particularly useful in keeping user engagement high and making interactions feel less scripted.

Triggers

Every automation requires a trigger – an event or user input that prompts the bot to respond. For Basic Automation:

• Intent Trigger: An intent labeled "Greetings" could cover inputs like "Hello", "Hi there", and "Good day".

• Direct Trigger: Basic Responses are ideal for specific commands or unique terms. A Direct trigger set would activate only when a user types in that exact phrase or its close variations.

Examples

Included below are example implementations to get started:

Basic Response Sample

{
  "messages": [
    {
      "textSet": [
        "This is a text component of a message."
      ]
    },   
    {
      "textSet": [
        "Here’s another message from the bot with more characters and longer sentence."
      ],
      "attachments": [
        {
          "image": "https://dq7axd795mydj.cloudfront.net/bots/on-product-demo/assets/on-platform-16x9-wine.png",
          "link": "https://onplatform.com/",
          "readMoreButtonText": "Button Text",
          "title": "Link Card 1"
        },
        {
          "image": "https://dq7axd795mydj.cloudfront.net/bots/on-product-demo/assets/on-platform-16x9-hibiscus.png",
          "link": "https://onplatform.com/",
          "readMoreButtonText": "Button Text",
          "title": "Link Card 2"
        },
        {
          "image": "https://dq7axd795mydj.cloudfront.net/bots/on-product-demo/assets/on-platform-16x9-carrot.png",
          "link": "https://onplatform.com/",
          "readMoreButtonText": "Button Text",
          "title": "Link Card 3"
        }
      ],
      "choices": [
        {
          "returnValue": "Quick Reply 1",
          "title": "Quick Reply 1"
        },
        {
          "returnValue": "Quick Reply 2",
          "title": "Quick Reply 2"
        },
        {
          "returnValue": "Quick Reply 3",
          "title": "Quick Reply 3"
        },
        {
          "returnValue": "Quick Reply 4",
          "title": "Quick Reply 4"
        },
        {
          "returnValue": "Quick Reply 5",
          "title": "Quick Reply 5"
        }
      ]
    }
  ]
}

Basic Response with Embed Media

{
  "messages": [
    {
      "embedMedia": [
        {
          "errorMessage": "Video failed to load.",
          "fallbackImage": "https://i.ytimg.com/vi/e91M0XLX7Jw/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLApH_0gVmGRKeh3ZuYoXzgsz0s4lA",
          "fallbackText": "xQc Gets Checkmated by MoistCr1tikal in 6 Moves! | Chess.com PogChamps",
          "height": 216,
          "link": "https://www.youtube.com/embed/e91M0XLX7Jw?si=HvqTssK55xZ4HqKp",
          "width": "DEFAULT"
        }
      ],
      "textSet": [
        "Hi here's your video:"
      ]
    }
  ]
}