{"id":17980,"date":"2017-03-07T15:34:33","date_gmt":"2017-03-07T15:34:33","guid":{"rendered":"https:\/\/developer.kore.com\/?post_type=docs&#038;p=10250"},"modified":"2021-03-30T10:57:44","modified_gmt":"2021-03-30T09:57:44","slug":"general-settings","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v7-2\/docs\/bots\/bot-settings\/general-settings\/","title":{"rendered":"General Settings"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row type_default valign_top\"><div class=\"vc_col-sm-12 wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\">\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p>To modify the general settings of a bot, hover over the side navigation panel of the bot and click <strong>Settings -&gt; Config Settings<\/strong>. The <strong>General Settings<\/strong> tab opens by default.<\/p>\n<p><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/13\/general-settings.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-21993\" src=\"\/wp-content\/uploads\/sites\/13\/general-settings.png\" alt=\"\" width=\"1366\" height=\"768\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/13\/20221201095202\/general-settings.png 1366w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/13\/20221201095202\/general-settings-300x169.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/13\/20221201095202\/general-settings-1024x576.png 1024w\" sizes=\"auto, (max-width: 1366px) 100vw, 1366px\" \/><\/a><\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h2 id=\"gen-settings\"><span class=\"ez-toc-section\" id=\"General_Bot_Settings\">General Bot Settings<\/span><\/h2>\n<p>Modify one or more of the settings described in the following table.<\/p>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Bot Name<\/td>\n<td>The name of the Bot\u00a0displayed in the Bot Store, for example,\u00a0<em>My Web Service Bot<\/em>, as the name of a Bot shown in the title bar in the following illustration. While a Bot is published, the <strong>Name<\/strong> cannot be changed. This field is required.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/13\/BotStoreBot.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-8585 alignnone\" src=\"\/wp-content\/uploads\/sites\/13\/BotStoreBot.png\" alt=\"A Bot from the Bot Store\" width=\"1170\" height=\"893\" \/><\/a><\/td>\n<\/tr>\n<tr>\n<td>Description<\/td>\n<td>The description\u00a0of the Bot, for example, <span style=\"color: #0000ff\">This is the description for My Web Service Bot.<\/span>, displayed in Bot\u00a0Builder and the Bot Store\u00a0as shown in the previous illustration. This field is required.<\/td>\n<\/tr>\n<tr>\n<td>Icon<\/td>\n<td>The icon\u00a0image for\u00a0the Bot\u00a0displayed in Bot\u00a0Builder, Bots Marketplace, and the end-user interface as shown in the previous illustration. The image format must be <span style=\"color: #0000ff\">.png<\/span> and best results are obtained using a 200 x 200-pixel image. This field is required.<\/td>\n<\/tr>\n<tr>\n<td>Target Audience<\/td>\n<td>\n<ul>\n<li>Select <strong style=\"font-family: inherit;font-size: inherit\">General Public<\/strong><span style=\"font-family: inherit;font-size: inherit\"> if the bot is for public use for both managed and unmanaged users in your domain. Bot assignments are not required and when the Bots Admin deploys the bot, it is available for use by all domain users. Use this option to make a bot widely available for all user types.<\/span><\/li>\n<li>Select <strong style=\"font-family: inherit;font-size: inherit\">Enterprise Users<\/strong><span style=\"font-family: inherit;font-size: inherit\"> if the bot is for managed users only in a domain, for example, for your employees or paid customers. After the Bots Admin approves and deploys this bot, it is not available to any managed users unless explicitly assigned by the Bots Admin. Use this option when you want to control which managed users in your domain can access and set up this bot on their devices.<\/span><\/li>\n<\/ul>\n<p>Once <strong>Target Audience<\/strong> is defined and saved, you cannot change them.<\/td>\n<\/tr>\n<tr>\n<td>Default Bot Language<\/td>\n<td>This is uneditable and is set at the time of Bot creation.<\/td>\n<\/tr>\n<tr>\n<td>Bot Id<\/td>\n<td>Non-editable, assigned by the platform. Can be copied for use in API calls etc..<\/td>\n<\/tr>\n<tr>\n<td>Subdomain (Tenancy)<\/td>\n<td>Click <strong>Yes<\/strong> to enable the use of tenancy. When the tenancy is defined, the end-user is prompted to enter a tenant name as part of the URL for the Bot, for example, <span style=\"color: #0000ff\"><em>kore<\/em>,<span style=\"color: #333333\"> for the\u00a0<span style=\"color: #0000ff\">www.<strong><em>kore<\/em><\/strong>.someWebService.com<\/span> tenant-specific URL.<\/span><\/span><br \/>\nWhen enabled define the following properties:<\/p>\n<ul>\n<li><strong>Help Hint<\/strong> &#8211; The text displayed to the end-user to prompt the user to enter a tenant-specific URL for the Bot.<\/li>\n<li><strong>Base\u00a0URL<\/strong> &#8211; The base URL for the Bot that the end-user must specify their company to complete the tenant-specific URL using the following syntax: <span style=\"color: #0000ff\"><br \/>\nhttps:\/\/{tenant}.someWebService.com<span style=\"color: #333333\">\u00a0where<\/span>\u00a0{tenant}<span style=\"color: #333333\">, including the braces, represents the tenant name.<\/span><\/span><span style=\"color: #0000ff\"><span style=\"color: #333333\">\u00a0<\/span><\/span>The following illustration is an example of a configured subdomain.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/13\/subdomain.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-8664 size-full alignnone\" src=\"\/wp-content\/uploads\/sites\/13\/subdomain.png\" alt=\"Tenancy for Bots\" width=\"882\" height=\"274\" \/><\/a><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>Show link for task setup\/execution<\/td>\n<td>\n<ul>\n<li>Select <strong style=\"font-family: inherit;font-size: inherit\">Yes<\/strong><span style=\"font-family: inherit;font-size: inherit\"> to display a link to enable the choice for a user to input information used to execute a task in a user interface form or input the data directly into the message input field, for example, <\/span><span style=\"color: #333333\"><em>Enter the title for new Asana task. To make edits, click <span style=\"color: #0000ff\">here.<\/span>\u00a0<\/em><\/span><span style=\"font-family: inherit;font-size: inherit\">where\u00a0<\/span><em style=\"font-family: inherit;font-size: inherit\"><span style=\"color: #0000ff\">here<\/span><\/em><span style=\"font-family: inherit;font-size: inherit\"> is a link to a form with fields.<\/span><\/li>\n<li>When <strong style=\"font-family: inherit;font-size: inherit\">No<\/strong><span style=\"font-family: inherit;font-size: inherit\"> is selected, the user can only input information for the task in the message input field. For example, <\/span><i style=\"font-family: inherit;font-size: inherit\">Enter the title for new Asana task<\/i><span style=\"font-family: inherit;font-size: inherit\">.<\/span><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>Error Message(s)<\/td>\n<td>Edit or add custom <strong>HTTP Status Codes<\/strong> and error messages for your Bot. For more information, see <a href=\"\/v7-2\/docs\/bots\/bot-settings\/customizing-error-messages\/\">Customizing Error Messages<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>To save the Bot settings, click <strong>Save<\/strong>. The <em>&lt; <strong>Bot Name<\/strong> &gt; updated successfully<\/em> message is displayed.<\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"To modify the general settings of a bot, hover over the side navigation panel of the bot and click Settings -&gt; Config Settings. The General Settings tab opens by default. General Bot Settings Modify one or more of the settings described in the following table. Field Description Bot Name The name of the Bot\u00a0displayed in...","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[65],"tags":[],"class_list":["post-17980","post","type-post","status-publish","format-standard","hentry","category-bot-settings"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/posts\/17980","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/comments?post=17980"}],"version-history":[{"count":6,"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/posts\/17980\/revisions"}],"predecessor-version":[{"id":21995,"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/posts\/17980\/revisions\/21995"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/media?parent=17980"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/categories?post=17980"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-2\/wp-json\/wp\/v2\/tags?post=17980"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}