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.
|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.
|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:
|Class||Select one of the following Bot classification for the Add Bots dialog in the Kore application. One of:
The following illustration shows the Professional class tab in the Get bots dialog for the Kore app.
|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:
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:
|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.|
You can edit an existing Bot if needed. For more information, see Editing an Existing Bot.