{"id":22911,"date":"2019-11-25T11:43:16","date_gmt":"2019-11-25T11:43:16","guid":{"rendered":"https:\/\/developer.kore.ai\/v10-1\/?p=22911"},"modified":"2022-09-30T12:24:19","modified_gmt":"2022-09-30T11:24:19","slug":"adding-the-workplace-by-facebook-channel","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/channel-enablement\/adding-the-workplace-by-facebook-channel\/","title":{"rendered":"Adding the Workplace by Facebook Channel"},"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>This channel enablement flow is modified as per the changes implemented by Facebook post v7.2 of the product.<\/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 assistant, you need a developer portal <em>Facebook<\/em>\u00a0account to configure the connection between <em>Facebook Workplace<\/em> and Kore.ai. Kore.ai application must be authorized to send and receive messages from the Workplace by Facebook channel.<\/p>\n<p>Add the Workplace by Facebook Channel<\/p>\n<p>To complete the following procedure, you must have an admin account in the <em>Facebook Workplace Developers Portal<\/em> (<span style=\"color: #0000ff\">https:\/\/&lt;<strong><em>Your Domain<\/em><\/strong>&gt;workplace.com\/work\/admin<\/span>).<\/p>\n<ol>\n<li>In the XO Platform, under the <strong>Bots<\/strong> section, click the assistant 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>Go 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>Allow communication with a VA in a Workplace Group<\/li>\n<li>Allow communication with a VA through a Work Chat<\/li>\n<\/ul>\n<\/li>\n<li>In the <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\">click 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 VA 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 assistant 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 VA 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 a 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 VA after installing the Kore.ai application on your workplace account needs you to uninstall the application on the workplace account and re-authorize it in the XO platform.<\/li>\n<\/ul>\n<\/li>\n<li>Click <strong>Authorize<\/strong>.<br \/><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121538\/channel-config.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-46639\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121538\/channel-config.png\" alt=\"\" width=\"600\" height=\"627\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121538\/channel-config.png 805w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121538\/channel-config-287x300.png 287w\" sizes=\"auto, (max-width: 600px) 100vw, 600px\" \/><\/a><\/li>\n<li>You are redirected to Workplace by Facebook page.<\/li>\n<li>Log in to your <em>Facebook Workplace<\/em> admin account.<\/li>\n<li>Click <strong>Customize<\/strong> to provide the following details for the instance of Kore.ai application installed on Workplace by Facebook account:\n<ul>\n<li>integration logo<\/li>\n<li>name<\/li>\n<li>description<br \/><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121528\/add-to-workplace.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-46633\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121528\/add-to-workplace.png\" alt=\"\" width=\"603\" height=\"620\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121528\/add-to-workplace.png 773w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121528\/add-to-workplace-292x300.png 292w\" sizes=\"auto, (max-width: 603px) 100vw, 603px\" \/><\/a><\/li>\n<\/ul>\n<\/li>\n<li>The\u00a0<strong>permissions<\/strong> needed by the Kore.ai assistant is selected based upon the configuration given in step 4.<\/li>\n<li>Select the groups to which the assistant 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 are redirected to the Kore.ai XO Platform.<br \/><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121542\/add-to-groups.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-46642\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121542\/add-to-groups.png\" alt=\"\" width=\"532\" height=\"579\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121542\/add-to-groups.png 768w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20220930121542\/add-to-groups-276x300.png 276w\" sizes=\"auto, (max-width: 532px) 100vw, 532px\" \/><\/a><\/li>\n<li>In XO Platform, from the <strong>Configuration<\/strong> tab, click <strong>Yes<\/strong> in the <strong>Enable Channel<\/strong> section; and click <strong>Save<\/strong>.<\/li>\n<li>The assistant may require your\u00a0Bots Admin approval and assignment before it is available to any users.<\/li>\n<\/ol>\n<p>\u00a0<\/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":"This channel enablement flow is modified as per the changes implemented by Facebook post v7.2 of the product. To add the Workplace by Facebook channel to your assistant, you need a developer portal Facebook\u00a0account to configure the connection between Facebook Workplace and Kore.ai. Kore.ai application must be authorized to send and receive messages from the...","protected":false},"author":1,"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\/v10-1\/wp-json\/wp\/v2\/posts\/22911","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/comments?post=22911"}],"version-history":[{"count":15,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/22911\/revisions"}],"predecessor-version":[{"id":46646,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/22911\/revisions\/46646"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=22911"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=22911"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=22911"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}