Creating a New Bot

Kore provides many built-in Bots that you can use to create tasks and flows. For more information, see Integrations for Kore Bots. If you need tasks for a Bot not currently supported by Kore, you can create your own custom Bot, and then define custom tasks, and if you map alert tasks to your action tasks, you can create a flow for that Bot. This topic describes how to create a custom Bot.

What is a Bot?

A Bot is a website, web application, or any system that can act as a source for tasks, as alert tasks, action tasks, or flows where an alert task is mapped to one or more action tasks, called a flow. For example, a Bot can be Twitter, Salesforce, CNN. In the Bot for Twitter, you can create an alert task to notify you whenever you get a new follower or a mention for your Twitter account, and another action task to tweet a reply. When you map the action task to your alert task for Twitter, it becomes a flow for Twitter.

Process for Creating a New Bot

When you create a new Bot, you are basically defining the metadata about the web-based application or web service that you want to use to provide messages in the Kore application as alert tasks and then, if desired, execute action tasks for that Bot. 

After you define the Bot, you can then define the new tasks for that Bot that end-users can select, configure, and use.

Note: Only users with paid individual accounts, and users that are members of a space or company currently enrolled in a Kore PREMIUM plan can access Bot Builder.

Defining a Bot

To get started, you need to log on to Bot Builder, and then click the Add Bot  icon. For more information, see How to Open Bot Builder.

On the Create Bot page, you define the Bot configuration, images, domain, search keywords, and error message codes. Define the fields shown in the following illustrations, and then click Save Bot.

"

"

The following table describes the fields in the Create Bot dialog shown in the previous illustration.

Field NameDescription
Name The name of the Bot displayed in the end-user interface, for example, Twitter, as the name of a Bot shown in title bar in the following illustration. This field is required.
Description The description of the Bot, for example, Social Networking site enables users to send and read short 140-character messages called "tweets". This integration allows you tweet,retweet,send DM and receive tweets from the people you follow on Twitter, displayed in Bot Builder and the end-user interface as shown in the previous illustration. This field is required.
Icon The banner image for the Bot displayed in Bot Builder and the end-user interface as shown in the previous illustration. The image format must be .png and best results are obtained using a 200 x 200 pixel image. This field is required.
Large Banner The banner displayed at the top of the dialog when the end-user selects a Bot to install a task. For example, the Twitter banner for the Bot shown in the previous illustration below the title bar. The image format must be .png and best results are obtained using a 640 x 300 pixel image. This field is required.
Small Banner The banner displayed in the Bot Builder user interface as displayed in the following illustration. The image format must be .png and best results are obtained using a 320 x 170 pixel image. This field is required.
 alt=
Color Click the drop-down arrow to open the color picker to choose the color for the background of your Bot images. In the right column, slide the selector bar vertically to the color hue desired, and then in the left color display box, click to select a specific shade, and then click Choose to save the selected color as shown in the following illustration

"

Category Select one or more categories to display the Bot in the end-user interface. Select one or more of:
  • Social Network
  • Communication
  • News & Weather
  • Productivity
  • File Management
  • Entertainment & Lifestyle
  • Sports
  • Utilities
  • Education
  • Shopping & Services
  • Developer Tools
  • Monitoring & Analytics
  • Project Management
  • CRM
  • HR
  • Marketing
  • Customer Support
  • Finance & Accounting
  • Travel
  • Collaboration
This field is required.
Class Select one of the following Bot classification for the Add Bots dialog in the Kore application. One of:
  • Personal Use - The task is designed for personal messaging and tasks, for example, Twitter and other social media. These Bots are displayed on the Personal tab in the Get bots dialog in the end-user interface.
  • Work Related - The task is designed for business-oriented messaging and tasks, for example, Salesforce and JIRA. These bots are displayed on the Professional tab in the Get bots dialog in the end-user interface.

The following illustration shows the Professional class tab in the Get bots dialog for the Kore app. 


 alt=

Bot Setup Confirmation - User A message displayed in the Kore application when a user adds this Bot to their account.
Bot Setup Confirmation - Room A message displayed in the Kore application when a space adds this Bot to a room.
Bot Command  Select Bot Command to display the Bot Command configuration settings, and then define the following properties:
  • Command Name - The name used for the Bot using the @Bot command in the user interface.
  • Help - The help text displayed for this Bot command.
  • Example Command - An example command displayed next to the name of the Bot command in the user interface.
  • Description - The description to display for the Bot command.

For more information, see Working with Bot Commands.

Homepage link An optional link displayed on the About page for the Bot in the end-user interface.
Subdomain   Click the This Bot has subdomains (Tenancy links) button to enable use of tenancy, for example, as a subdomain of the Bot such as www.kore.zendesk.com. When tenancy is defined, the end-user is prompted to enter a tenant-specific URL for the Bot. When selected, define the following properties:
  • Help Hint - The text displayed to the end-user to prompt the user to enter a tenant-specific URL for the Bot.
  • Base URL The base URL for the Bot that the end-user must specify to complete the tenant-specific URL using the following syntax:
    https://{tenant}.somecompany.com
Search Keywords Specify one or more search terms for this Bot used in the end-user interface to find your Bot.
Error Messages Edit or add custom HTTP Status Codes and error messages for your Bot.

Next Steps

After you define your Bot, you are ready to add one or more tasks. For more information, see About Alert Tasks and About Action Tasks.

You can edit an existing Bot if needed. For more information, see Editing an Existing Bot.

Comments