{"id":17842,"date":"2016-08-03T10:44:10","date_gmt":"2016-08-03T10:44:10","guid":{"rendered":"http:\/\/apidocs.kore.com\/?post_type=docs&#038;p=4550"},"modified":"2021-03-26T10:25:24","modified_gmt":"2021-03-26T10:25:24","slug":"managing-your-groups","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v7-3\/docs\/bots\/bot-admin\/user-management\/managing-your-groups\/","title":{"rendered":"Managing Your Groups"},"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>On the <strong>Groups<\/strong> page in the <strong>User\u00a0Management<\/strong> module, you can create and manage logically related groups of users, as well as import groups, such as your company Active Directory groups.<\/p>\n<p>If the enterprise has varied and distinct Bot requirements for various departments or lines of business, creating groups, adding developers and assigning bots to the groups would be the recommended option. You can create a custom group of users, for example, by geographical location, department title, or common interest.<\/p>\n<p>Groups are automatically created when you import organizational units using Active Directory.<\/p>\n<p>The following illustration is an example of the <strong>Groups<\/strong> page in the <strong>User\u00a0Management<\/strong>\u00a0module.<\/p>\n<p><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/BAC_Groups-e1584702036371.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-22033 size-full\" src=\"\/wp-content\/uploads\/sites\/15\/BAC_Groups-e1584702036371.png\" alt=\"\" width=\"1366\" height=\"505\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/15\/20221201095555\/BAC_Groups-e1584702036371.png 1366w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/15\/20221201095555\/BAC_Groups-e1584702036371-300x111.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/wp-content\/uploads\/sites\/15\/20221201095555\/BAC_Groups-e1584702036371-1024x379.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<h3><span class=\"ez-toc-section\" id=\"Details\">Details<\/span><\/h3>\n<p>To sort the list of column values, click the <strong class=\"UserInterface_Kore.ai\">Arrow Up<\/strong> <img loading=\"lazy\" decoding=\"async\" class=\"icon size-full wp-image-8266\" src=\"\/wp-content\/uploads\/sites\/15\/Up-Arrow-1.png\" alt=\"up-arrow\" width=\"26\" height=\"15\" \/>\u00a0icon or <strong class=\"UserInterface_Kore.ai\">Arrow Down<\/strong>\u00a0<img loading=\"lazy\" decoding=\"async\" class=\"icon size-full wp-image-8267\" src=\"\/wp-content\/uploads\/sites\/15\/down-arrow-1.png\" alt=\"down-arrow\" width=\"26\" height=\"15\" \/> icon to the right of a column name.<\/p>\n<p>The following list describes the columns displayed in the Groups listing.<\/p>\n<table>\n<thead>\n<tr>\n<th class=\"wysiwyg-text-align-left\">COLUMN<\/th>\n<th class=\"wysiwyg-text-align-left\">DESCRIPTION<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Group Name<\/td>\n<td>Displays the group name. Click a group name to edit the the selected group &#8211; name, description &amp; members.<\/td>\n<\/tr>\n<tr>\n<td>Description<\/td>\n<td>Displays the description of the group. This is an optional field.<\/td>\n<\/tr>\n<tr>\n<td>Source<\/td>\n<td>The source used to create the group. One of:<\/p>\n<ul>\n<li value=\"1\"><strong>Local <\/strong>&#8211; The group was created manually from the <strong>User\u00a0Management<\/strong>\u00a0module.<\/li>\n<li value=\"2\"><strong>AD<\/strong> &#8211; The group was imported or synchronized using Active Directory.<\/li>\n<li value=\"2\"><strong>System<\/strong> &#8211; The group was created as a default group by Kore.ai, for example, <em><span class=\"wysiwyg-color-blue\">everyone<\/span><\/em>.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td>Membership<\/td>\n<td>Displays the number of group members as users, and the number of groups as child members of the parent group. Click the link to edit the list of Kore.ai users and child groups for the selected group.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h5>Using the Search Field<\/h5>\n<p>The list of entries in an admin console table can be very large depending on the size of your company. To find one or more specific users or groups, in the <strong class=\"UserInterface_Kore.ai\">Search<\/strong> field, enter at least three characters to begin find-as-you-type.<\/p>\n<p class=\"note\"><strong>Note:<\/strong> The number of search terms in a search query is unlimited, however, no more than the first 20 characters of each search term is used to return search results.<\/p>\n<p>To view all entries, clear the search field, and then press the <strong class=\"UserInterface_Kore.ai\">Enter<\/strong> key.<\/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<h3><span class=\"ez-toc-section\" id=\"Creation\">Creation<\/span><\/h3>\n<p>You may want to create one or more groups of users in your account for users with, for example, a related interest, department, or location. Groups created by the admin are not visible to the user and are for administrative purposes only. This topic describes how to define a new group and add users, or existing groups of users to that group.<\/p>\n<ol>\n<li>In the <strong>User\u00a0Management<\/strong> module, select the <strong>Groups<\/strong> section.<\/li>\n<li>Click the \u00a0<img loading=\"lazy\" decoding=\"async\" class=\"icon alignnone wp-image-8269 size-full\" src=\"\/wp-content\/uploads\/sites\/15\/AddNewButton.png\" alt=\"AddNewButton\" width=\"103\" height=\"36\" \/> button to display the <strong class=\"UserInterface_Kore.ai\">Create New User Group<\/strong> dialog to add a new Kore.ai group to your account.<\/li>\n<li>The <strong>Create New User Group<\/strong> dialog is displayed.<\/li>\n<li>In the <strong>Common<\/strong> tab,\n<ol>\n<li>in the <strong>Group Name<\/strong> field, enter the name for the group.<\/li>\n<li>Optionally, in the <strong>Description<\/strong> field, enter a description for the group.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/CreateNewGroup.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-6737 size-full alignnone\" src=\"\/wp-content\/uploads\/sites\/15\/CreateNewGroup.png\" alt=\"CreateNewGroup\" width=\"854\" height=\"247\" \/><\/a><\/li>\n<\/ol>\n<\/li>\n<li>Navigate to the <strong>Members<\/strong> tab, and select the user(s) and\/or group(s) to be added to this group. You can locate the needed users\/groups from the the <strong>Available Users\/Groups<\/strong> section by\n<ol>\n<li>using <strong>Sort<\/strong> and then selecting a <strong>Filter<\/strong> to display users and groups that can be added to the new group.<\/li>\n<li>entering a name in the <strong>Search<\/strong> field, or<\/li>\n<li>scrolling to select one or more Kore.ai users and Kore.ai groups,<\/li>\n<li>Then click <img loading=\"lazy\" decoding=\"async\" class=\"icon size-full wp-image-8273\" src=\"\/wp-content\/uploads\/sites\/15\/AddSingleArrow.png\" alt=\"addsinglearrow\" width=\"117\" height=\"30\" \/>, to move the selected list to the <strong>Current Members<\/strong> section.<\/li>\n<li>To add all available users and groups, click <img decoding=\"async\" class=\"icon\" src=\"\/wp-content\/uploads\/sites\/15\/AddDoubleArrow_117x30.png\" alt=\"\" \/><br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/BotsAdminUserMgmtGroupsCreateNewGroupAddUsers.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-11464 alignnone\" src=\"\/wp-content\/uploads\/sites\/15\/BotsAdminUserMgmtGroupsCreateNewGroupAddUsers.png\" alt=\"Adding Participants to a Group\" width=\"856\" height=\"632\" \/><\/a><\/li>\n<\/ol>\n<\/li>\n<li>Click <strong>Save<\/strong>. The group is created and the <strong>Groups<\/strong> page is displayed.<\/li>\n<li>The <em class=\"TitleOrPath_Kore.ai\">Group Updated<\/em> message is displayed at the top of the page.<\/li>\n<\/ol>\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<h3><span class=\"ez-toc-section\" id=\"Modification\">Modification<\/span><\/h3>\n<p>You may need to modify the members of a group. This topic describes how to modify the common group properties and the membership of an existing group.<\/p>\n<ol data-mc-continue=\"true\">\n<li>In the <strong class=\"UserInterface_Kore.ai\">User\u00a0Management<\/strong>\u00a0module, on the <strong class=\"UserInterface_Kore.ai\">Groups<\/strong> page, in the <strong class=\"UserInterface_Kore.ai\">Group Name<\/strong> column, click the name of the group to modify.<\/li>\n<li>The <strong class=\"UserInterface_Kore.ai\">Editing User Group<\/strong>\u00a0&#8211; <strong><em>&lt; Group Name &gt;<\/em><\/strong> dialog is displayed.<\/li>\n<li>On the <strong class=\"UserInterface_Kore.ai\">Common<\/strong> tab, you can modify the <strong class=\"UserInterface_Kore.ai\">Group Name<\/strong> and <strong class=\"UserInterface_Kore.ai\">Description<\/strong> field.<\/li>\n<li>On the <strong>Members<\/strong> tab, in the <strong class=\"UserInterface_Kore.ai\">Available Users\/Groups<\/strong> and <strong class=\"UserInterface_Kore.ai\">Current Members<\/strong> sections, optionally <strong class=\"UserInterface_Kore.ai\">Sort<\/strong>, and then select a <strong class=\"UserInterface_Kore.ai\">Filter<\/strong> to display users and groups to add or remove.<\/li>\n<li>To modify the members of the group, you can:\n<ol>\n<li>Enter a name in the <strong>Search<\/strong> field, or scroll to select one or more users and groups, and then click <img loading=\"lazy\" decoding=\"async\" class=\"icon size-full wp-image-8273\" src=\"\/wp-content\/uploads\/sites\/15\/AddSingleArrow.png\" alt=\"addsinglearrow\" width=\"117\" height=\"30\" \/>\u00a0to add new group members, or click <img loading=\"lazy\" decoding=\"async\" class=\"icon size-full wp-image-8278\" src=\"\/wp-content\/uploads\/sites\/15\/DeleteSingleArrow_120x30.png\" alt=\"deletesinglearrow_120x30\" width=\"120\" height=\"30\" \/>\u00a0to remove the selected group members.<\/li>\n<li>Click <img loading=\"lazy\" decoding=\"async\" class=\"icon size-full wp-image-8279\" src=\"\/wp-content\/uploads\/sites\/15\/AddDoubleArrow_117x30.png\" alt=\"adddoublearrow_117x30\" width=\"117\" height=\"30\" \/>\u00a0to add all available group members, or click <img loading=\"lazy\" decoding=\"async\" class=\"icon size-full wp-image-8277\" src=\"\/wp-content\/uploads\/sites\/15\/DeleteDoubleArrow_119x30.png\" alt=\"deletedoublearrow_119x30\" width=\"119\" height=\"30\" \/>\u00a0to remove all current group members.<\/li>\n<\/ol>\n<\/li>\n<li>\u00a0Click <strong class=\"UserInterface_Kore.ai\">Save<\/strong>. The group is modified and the <strong class=\"UserInterface_Kore.ai\">Groups<\/strong> page is displayed.<\/li>\n<\/ol>\n<p><a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/BotsAdminUserMgmtGroupsEdit.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-11466 alignnone\" src=\"\/wp-content\/uploads\/sites\/15\/BotsAdminUserMgmtGroupsEdit.png\" alt=\"Editing User Groups\" width=\"1716\" height=\"1262\" \/><\/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<h3 id=\"delete\"><span class=\"ez-toc-section\" id=\"Deletion\">Deletion<\/span><\/h3>\n<p>You may no longer need a group of users in your account. You must remove all users from a group before you can delete a group. Complete the steps in the following procedure to delete a group.<\/p>\n<p>Instead of deleting a group, you can also modify the common settings as well as the membership of an existing group. For more information, see <a class=\"MCXref xref\" href=\"#Modify_an_Existing_User_Group\">Modify an Existing User Group<\/a>.<\/p>\n<ol>\n<li value=\"1\">In the <strong class=\"UserInterface_Kore.ai\">User\u00a0Management<\/strong>\u00a0module, on the <strong class=\"UserInterface_Kore.ai\">Groups<\/strong> page, in the <strong class=\"UserInterface_Kore.ai\">Group Name<\/strong> column, select the name of one or more groups to delete.<\/li>\n<li value=\"2\">On the <strong class=\"UserInterface_Kore.ai\">Action<\/strong> bar, click <img loading=\"lazy\" decoding=\"async\" class=\"icon size-full wp-image-8281\" src=\"\/wp-content\/uploads\/sites\/15\/DeleteButton.png\" alt=\"deletebutton_74x30\" width=\"74\" height=\"30\" \/>.<\/li>\n<li value=\"3\">In the <strong class=\"UserInterface_Kore.ai\">Delete Group(s)<\/strong> confirmation dialog, click <strong class=\"UserInterface_Kore.ai\">Delete<\/strong>.<\/li>\n<\/ol>\n<p class=\"warning\"><strong>Warning:<\/strong> This operation is permanent and cannot be undone.<\/p>\n<p>The group is deleted.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/15\/BotsAdminUserManagementGroupsDelete.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-6743 size-full alignnone\" src=\"\/wp-content\/uploads\/sites\/15\/BotsAdminUserManagementGroupsDelete.png\" alt=\"BotsAdminUserManagementGroupsDelete\" width=\"902\" height=\"441\" \/><\/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><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"On the Groups page in the User\u00a0Management module, you can create and manage logically related groups of users, as well as import groups, such as your company Active Directory groups. If the enterprise has varied and distinct Bot requirements for various departments or lines of business, creating groups, adding developers and assigning bots to the...","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[41],"tags":[],"class_list":["post-17842","post","type-post","status-publish","format-standard","hentry","category-user-management"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/posts\/17842","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/comments?post=17842"}],"version-history":[{"count":11,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/posts\/17842\/revisions"}],"predecessor-version":[{"id":23339,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/posts\/17842\/revisions\/23339"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/media?parent=17842"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/categories?post=17842"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-3\/wp-json\/wp\/v2\/tags?post=17842"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}