{"id":17995,"date":"2017-05-08T19:29:18","date_gmt":"2017-05-08T19:29:18","guid":{"rendered":"http:\/\/developer.kore.ai\/?post_type=docs&#038;p=11438"},"modified":"2019-07-09T11:21:58","modified_gmt":"2019-07-09T10:21:58","slug":"asana-sample-bot","status":"publish","type":"post","link":"https:\/\/multisite.korebots.com\/v9-0\/docs\/bots\/advanced-topics\/sample-bots\/asana-sample-bot\/","title":{"rendered":"Asana Sample Bot"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row via_grid cols_1 laptops-cols_inherit tablets-cols_inherit mobiles-cols_1 valign_top type_default stacking_default\"><div class=\"wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><p>The <em>Asana Sample<\/em> bot contains a basic configuration for registering an app with Asana, generating authentication tokens, and then adding those tokens to the bot in Bot Builder. After configuration, you can test the bot using the <strong>Talk to Bot<\/strong> feature to test any\u00a0of the following\u00a0configured alerts and actions.<\/p>\n<ul>\n<li><strong>Dialog\u00a0Tasks<\/strong>\n<ul>\n<li>Assign Task<\/li>\n<li>Create Task<\/li>\n<\/ul>\n<\/li>\n<li><strong>Action Tasks<\/strong>\n<ul>\n<li>Get task assigned to me<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"Installing_the_Asana_Sample_Bot\"><\/span>Installing the Asana Sample Bot<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>The <em>Asana Sample<\/em> Bot is only available in Bot Builder\u00a0and must be added as a new bot. It is a limited design specifically configured\u00a0to demonstrate certain\u00a0bot features.<\/p>\n<div class=\"alert alert-info\"><strong>Note<\/strong>: This Bot is similar but not the same as the built-in bot for Asana available at the Kore.ai Bot Store.<\/div>\n<\/div><\/div><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 class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><h3 id=\"step1\"><span class=\"ez-toc-section\" id=\"Step_1_Install_the_Asana_sample_bot\"><\/span>Step 1: Install the Asana\u00a0sample bot<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<ol>\n<li>Log on to Bot\u00a0Builder.<\/li>\n<li>To view your sample bots, click the\u00a0<strong>down-arrow<\/strong>\u00a0next to the\u00a0\u00a0<strong>+New Bot<\/strong>\u00a0and select\u00a0<strong>Install Sample Bots.<\/strong><\/li>\n<li>Search and point to\u00a0<em>Asana Sample<\/em>\u00a0bot, and then click the\u00a0<strong>Install<\/strong>\u00a0button displayed.<\/li>\n<li>On the <strong>Asana Sample<\/strong> page,\u00a0on the <strong>Instructions<\/strong> tab, note the callback URL, <span style=\"color: #0000ff\">https:\/\/idp.kore.ai\/workflows\/callback<\/span>\u00a0that you will later paste into your Asana App registration.<\/li>\n<\/ol>\n<\/div><\/div><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 class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><h3 id=\"step2\"><span class=\"ez-toc-section\" id=\"Step_2_Register_the_App_on_Asana\"><\/span>Step 2: Register the App on Asana<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<ol>\n<li>Log on to Asana at <a href=\"https:\/\/app.asana.com\">https:\/\/app.asana.com<\/a>.<\/li>\n<li>On the top right-hand corner of the window, click the Asana account name using which you logged in.<\/li>\n<li>My Profile Settings dialog opens.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/22\/Manage-Apps.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-13433 alignnone\" src=\"\/wp-content\/uploads\/sites\/22\/Manage-Apps.png\" alt=\"\" width=\"685\" height=\"284\" \/><\/a><\/li>\n<li>Click<strong> Apps &gt; Manage Developer Apps<\/strong>. The Developer App Management page is displayed.<\/li>\n<li>Under the Apps You Own section, click <strong>Register New Application.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/22\/register-new-app.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-13434 alignnone\" src=\"\/wp-content\/uploads\/sites\/22\/register-new-app.png\" alt=\"\" width=\"795\" height=\"575\" \/><\/a><br \/>\n<\/strong><\/li>\n<li>In the Apps you own section, in the <strong>App Name<\/strong> field, enter the name of your Asana App, for example, <em><span style=\"color: #0000ff\">My Asana App<\/span><\/em>.<\/li>\n<li>In the \u00a0<strong>App URL<\/strong>\u00a0field, enter\u00a0<span style=\"color: #0000ff\">https:\/\/bots.kore.ai<\/span>.<\/li>\n<li>In the <strong>Redirect URL<\/strong> field, paste the URL copied from the Bot Builder, https:\/\/idp.kore.ai\/workflows\/callback.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/22\/Dev-app-management.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-13436 alignnone\" src=\"\/wp-content\/uploads\/sites\/22\/Dev-app-management.png\" alt=\"\" width=\"606\" height=\"550\" \/><\/a><\/li>\n<li>Click <strong>Create<\/strong>. New fields like\u00a0<strong>Client ID<\/strong> and <strong>Client Secret<\/strong>\u00a0get displayed. Click <strong>Save<\/strong>.\u00a0The <em>My Asana App<\/em> is added as a new application<strong>.<\/strong><br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/22\/client-key-and-secret.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-13435 alignnone\" src=\"\/wp-content\/uploads\/sites\/22\/client-key-and-secret.png\" alt=\"\" width=\"631\" height=\"592\" \/><\/a><\/li>\n<\/ol>\n<\/div><\/div><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 class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><h3 id=\"step3\"><span class=\"ez-toc-section\" id=\"Step_3_Enter_the_Asana_Client_Details_Back_in_the_Sample_Bot\"><\/span>Step 3: Enter the Asana Client Details Back in the Sample Bot<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<ol>\n<li>Open the sample bot and click the <strong>Configuration<\/strong> tab.<\/li>\n<li>Copy the Asana <strong>Client ID<\/strong> and <strong>Client Secret<\/strong>\u00a0in the respective fields of the\u00a0<strong>Configuration<\/strong> tab.<\/li>\n<li>The <em>Asana Sample successfully installed<\/em> message is displayed.<\/li>\n<\/ol>\n<\/div><\/div><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 class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><h3 id=\"step4\"><span class=\"ez-toc-section\" id=\"Step_4_Authorize_the_App\"><\/span>Step 4: Authorize the App<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<ol>\n<li>In Bot Builder on the <strong>Home<\/strong> page, select your bot, and then click the\u00a0<strong>Talk to Bot\u00a0<\/strong><img loading=\"lazy\" decoding=\"async\" class=\"icon alignnone wp-image-13430 \" src=\"\/wp-content\/uploads\/sites\/22\/talk-to-bot-1.png\" alt=\"\" width=\"49\" height=\"50\" \/>\u00a0icon to test the <em>Asana Sample<\/em> bot.<\/li>\n<li>A link to authorize Kore.ai to access your Asana account\u00a0is displayed on first use of the bot as shown in the following illustration.<br \/>\n<a ref=\"magnificPopup\" href=\"\/wp-content\/uploads\/sites\/22\/DIYAsanaSampleRunBot.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-11442 alignnone\" src=\"\/wp-content\/uploads\/sites\/22\/DIYAsanaSampleRunBot.png\" alt=\"Asana Run Bot Window\" width=\"390\" height=\"700\" \/><\/a><\/li>\n<li>Click the link, and then complete a one-time authorization for the user with Asana.<\/li>\n<\/ol>\n<\/div><\/div><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 class=\"wpb_text_column\"><div class=\"wpb_wrapper\"><h3 id=\"step4\"><span class=\"ez-toc-section\" id=\"Step_5_Customizing_the_Sample_Bot\"><\/span>Step 5: Customizing the Sample Bot<span class=\"ez-toc-section-end\"><\/span><\/h3>\n<p>Try out your bot using\u00a0<strong>Talk to Bot<\/strong>\u00a0and test all the alerts and actions. Then review the configuration tabs of the bot in Bot Builder:<\/p>\n<p><strong>Bot Tasks<\/strong> &#8211; Add or modify tasks. This bot is configured with 2 dialog tasks and 1 actions task. You can also add dialog tasks, information tasks, knowledge tasks, and configure flows. <a href=\"\/docs\/bots\/chatbot-overview\/bot-tasks\/\">Know more<\/a><\/p>\n<p><strong>Natural Language<\/strong> &#8211; Review and optimize natural language processing and machine language understanding of your bot. <a href=\"\/docs\/bots\/nlp\/optimizing-bots\/\">Know more<\/a>.<\/p>\n<p><strong>Channels<\/strong> &#8211; Enable this bot for one or more communication channels. This bot is enabled for the Kore channel by default. <a href=\"\/docs\/bots\/bot-builder-tool\/channel-enablement\/adding-channels-to-your-bot\/\">Know more<\/a>.<\/p>\n<p><strong>Settings<\/strong> &#8211; Edit or define bot settings, such as name, icon, and other settings. <a href=\"\/docs\/bots\/advanced-topics\/bot-settings\/general-settings\/\">Know more<\/a>.<\/p>\n<p><strong>Publishing<\/strong> &#8211; You can publish alert, action, or dialog tasks for Standard Bots for an enterprise or to the Kore.ai <a href=\"https:\/\/bots.kore.ai\/\">Bot Store<\/a>. For more information, see <a href=\"\/docs\/bots\/publish\/publishing-bot\/#Publishing_Tasks\">Publishing Tasks<\/a>.<\/p>\n<p><strong>Analyze<\/strong> &#8211;\u00a0You can review the full conversation between the Bots Platform and a user using <strong>Chat History<\/strong>. For more detail, you can review\u00a0and analyze both successful, and unsuccessful interactions\u00a0between a Bot and a user in the <strong>Chat Logs<\/strong> section. If necessary, based on the interaction, you can initiate Bot training to better handle future communication transactions. For more information, see <a href=\"\/docs\/bots\/bot-builder-tool\/analyzing-your-bot\/analyzing-your-bot\/\">Analyzing Your Bot<\/a>.<\/p>\n<\/div><\/div><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><\/section>\n","protected":false},"excerpt":{"rendered":"The Asana Sample bot contains a basic configuration for registering an app with Asana, generating authentication tokens, and then adding those tokens to the bot in Bot Builder. After configuration, you can test the bot using the Talk to Bot feature to test any\u00a0of the following\u00a0configured alerts and actions. Dialog\u00a0Tasks Assign Task Create Task Action...","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[55],"tags":[],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/17995"}],"collection":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/comments?post=17995"}],"version-history":[{"count":4,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/17995\/revisions"}],"predecessor-version":[{"id":21983,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/posts\/17995\/revisions\/21983"}],"wp:attachment":[{"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/media?parent=17995"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/categories?post=17995"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/multisite.korebots.com\/v9-0\/wp-json\/wp\/v2\/tags?post=17995"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}