{"id":22911,"date":"2019-11-25T11:43:16","date_gmt":"2019-11-25T11:43:16","guid":{"rendered":"https:\/\/developer.kore.ai\/v7-1\/?p=22911"},"modified":"2019-12-02T08:39:50","modified_gmt":"2019-12-02T08:39:50","slug":"adding-the-workplace-by-facebook-channel-upcoming","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v7-1\/docs\/bots\/channel-enablement\/adding-the-workplace-by-facebook-channel-upcoming\/","title":{"rendered":"Adding the Workplace by Facebook Channel &#8211; Upcoming"},"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><strong>NOTE<\/strong>: This new approach to the integration of Workplace by Facebook Channel with Kore.ai Bots will be implemented in the upcoming release. <a href=\"\/v7-1\/docs\/bots\/channel-enablement\/adding-the-facebook-workplace-channel\/\">Refer to this link till then<\/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<p>To add the Workplace by Facebook channel to your bot, you will need a developer portal <em>Facebook<\/em>\u00a0account to configure the connection between <em>Facebook Workplace<\/em> and Kore.ai. Kore.ai application needs to be authorized to send and receive messages from the Workplace by Facebook channel.<\/p>\n<p><strong>To add the Workplace by\u00a0Facebook channel<\/strong><br \/>\nTo complete the following procedure, you must have an admin account in the <em>Facebook Workplace Developers Portal<\/em>\u00a0at\u00a0<span style=\"color: #0000ff\">https:\/\/&lt; <strong><em>Your Domain<\/em><\/strong> &gt;.workplace.com\/work\/admin<\/span>.<\/p>\n<ol>\n<li>In Bot Builder, in the <strong>Bots<\/strong> section, click the bot that you want to enable the Workplace by Facebook channel.<\/li>\n<li>On the <strong>Channels<\/strong> tab, click the <strong>Workplace by Facebook<\/strong> icon.<\/li>\n<li>The <strong>Workplace by Facebook Channel<\/strong>\u00a0page is displayed.<\/li>\n<li>Navigate to the <strong>Configurations<\/strong> tab\n<ul>\n<li>In the <strong>Communication Mode<\/strong> section, select one or both of the following:\n<ul>\n<li><strong>Allow communication with a Bot in a Workplace Group<\/strong><\/li>\n<li><strong>Allow communication with a Bot through a\u00a0Work Chat<\/strong><\/li>\n<\/ul>\n<\/li>\n<li>In\u00a0<strong>Manage Permissions<\/strong> section, set the following as per your requirements (<a href=\"https:\/\/developers.facebook.com\/docs\/workplace\/reference\/permissions\" target=\"_blank\" rel=\"noopener noreferrer\">see here for more on the permissions<\/a>):\n<ul>\n<li><strong>Message any member<\/strong> &#8211; To send messages to any group member. This permission is selected by default and is mandatory hence not editable;<\/li>\n<li><strong>Mention bot<\/strong> &#8211; Needed when the bot is mentioned in a post, to see the post and to reply to comments. This permission is selected by default and is required for the bot to respond to users in groups;<\/li>\n<li><strong>Manage group content<\/strong> &#8211; Required to post and comment in groups. This permission is selected by default and is required for the bot to respond to users in groups;<\/li>\n<li><strong>Create link previews<\/strong> &#8211; Needed to see links added to posts in order to display preview for certain domains;<\/li>\n<li><strong>Read user email<\/strong> &#8211; Required to see any group member\u2019s email address;<\/li>\n<li><strong>Read work profile<\/strong> &#8211; Required to see any group member\u2019s complete profile, including phone number, department and location;<\/li>\n<li><strong>Read org chart<\/strong> &#8211; Needed to check a group member\u2019s profile to see who they report to and who reports to them;<\/li>\n<\/ul>\n<p>Note: You are advised to set the permissions correctly after evaluating the above-mentioned link carefully. Managing the permissions for your bot after installing Kore.ai application on your workplace account needs you to uninstall the application on workplace account and re-authorize it in the bot platform.<\/li>\n<\/ul>\n<\/li>\n<li>Click <strong>Authorize<\/strong>\u00a0button.<\/li>\n<li>You will be redirected to Workplace by Facebook page.<\/li>\n<li>Log in to your <em>Facebook Workplace<\/em> admin account.<\/li>\n<li>Click the <strong>Add to Workplace<\/strong>\u00a0to generate page access token to enable access for Kore.ai platform.<\/li>\n<li>Click <strong>Customize<\/strong> to provide the following details for the instance of Kore.ai application being installed on Workplace by Facebook account\n<ul>\n<li><em>integration logo<\/em>,<\/li>\n<li><em>name<\/em> and<\/li>\n<li><em>description<\/em>.<\/li>\n<\/ul>\n<\/li>\n<li>The\u00a0<strong>permissions<\/strong> needed by the Kore.ai Bot will be selected based upon the configuration given in step 4.<\/li>\n<li>Select the groups to which the bot needs to be added and click <strong>Add to Workplace<\/strong>.<\/li>\n<li>Once the instance of Kore.ai application is added to your Workplace by Facebook account, you will be redirected back to Kore.ai Bot Builder.<\/li>\n<li>In Bot Builder, from the <strong>Configuration<\/strong> tab, click <strong>Yes<\/strong> in the <strong>Enable Channel<\/strong> section, and then click <strong>Save<\/strong>.<\/li>\n<li>The bot may require your\u00a0Bots Admin approval and assignment before it is available to any users.<\/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<h1><span class=\"ez-toc-section\" id=\"Editing_the_Channel\">Editing the Channel<\/span><\/h1>\n<p>To edit the Workplace by\u00a0Facebook channel, hover your mouse over the channel to modify, and then click the <strong>Settings<\/strong> <img loading=\"lazy\" decoding=\"async\" class=\"icon alignnone wp-image-2113 size-full\" src=\"\/wp-content\/uploads\/sites\/12\/DIYSettingsIcon-1.png\" width=\"18\" height=\"18\" \/>\u00a0icon displayed to show the command menu displayed in the following illustration.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/12\/DIYChannelsTabWorkplaceByFacebookEdit.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-11278\" src=\"\/wp-content\/uploads\/sites\/12\/DIYChannelsTabWorkplaceByFacebookEdit.png\" alt=\"Channels Tab - Workplace By Facebook\" width=\"1049\" height=\"253\" \/><\/a><br \/>\nSelect one of the following commands to modify the channel:<\/p>\n<ul>\n<li><strong>Edit<\/strong> &#8211; Click to open the Workplace by\u00a0Facebook channel setup page.<\/li>\n<li><strong>Disable\/Enable<\/strong> &#8211; Click <strong>Disable<\/strong> to temporarily disable use of the Workplace by\u00a0Facebook channel for your bot. When the channel is disabled, click <strong>Enable<\/strong> to enable use of the Workplace by\u00a0Facebook channel.<\/li>\n<li><strong>Delete<\/strong> &#8211; Click <strong>Delete<\/strong>, and then click <strong>OK<\/strong> in the <strong>Delete Confirmation<\/strong> dialog to permanently delete the bot channel configuration.\n<p class=\"warning\"><strong>Warning:<\/strong> This operation is permanent, and cannot be undone.<\/p>\n<\/li>\n<\/ul>\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":"NOTE: This new approach to the integration of Workplace by Facebook Channel with Kore.ai Bots will be implemented in the upcoming release. Refer to this link till then. To add the Workplace by Facebook channel to your bot, you will need a developer portal Facebook\u00a0account to configure the connection between Facebook Workplace and Kore.ai. Kore.ai...","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[25],"tags":[],"class_list":["post-22911","post","type-post","status-publish","format-standard","hentry","category-channel-enablement"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts\/22911","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/comments?post=22911"}],"version-history":[{"count":9,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts\/22911\/revisions"}],"predecessor-version":[{"id":22954,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/posts\/22911\/revisions\/22954"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/media?parent=22911"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/categories?post=22911"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v7-1\/wp-json\/wp\/v2\/tags?post=22911"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}