Editing an Existing Bot

To create a task for a Kore Bot, you must first define a Bot. For more information, see Creating a Bot.

After you create a Bot for using Bot Builder, you may need to change the settings, for example, to update or add a Bot icon, or description. This topic describes how to edit an existing Bot.

To open a Bot for editing, log on to Bot Builder, and then click a Bot in the YOUR BOTS section as shown in the following illustration.

To edit the Bot, click the Settings  icon located to the rightmost side of the Bot name in Bot Builder, and then click Edit as shown in the following illustration.

The following illustrations are an example of the Edit Bot dialog.

Modify one or more of the settings described in the following table for the Edit 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. This field is mandatory. 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.

To save your modifications to the Bot, click Save Bot.

The Bot < My Bot Name > updated successfully message is displayed and the the modified Bot is displayed in the Kore Bot Builder.

Next Steps

After you modify your Bot, you are ready to add a task or flow. For more information, see About Alert Tasks and About Action Tasks.  

Comments